# Using the Telemetry Console Extension

# Working with Views

A view is a named collection of charts and graphs that present graphical information of telemetry data. The following sections describe how to work with views:

- The Views Tab and the View Panel
- Displaying and Modifying an Existing View
- Creating a Custom View
- Creating a View Based on an Existing View (Cloning)
- Saving a Custom View
- Deleting a View
- Starting and Stopping Views

## The Views Tab and the View Panel

The Views tab in the Tabs panel, on the left side of the page, contains a list of the views configured in the Telemetry Console Extension. It also provides the means to create, select, modify, and delete views. When you select (click) the name of a view in the Views tab on the left, the view is displayed in the View panel on the right, as shown in Figure 3-6. That view remains displayed in the View panel, even when you select different tabs in the Tabs panel.

Figure 3-6 Views Tab and View Panel

The Views tab lists both built-in and custom views.

- Built-in views are a set of predefined views of available runtime metrics for all running Edge Server instances configured in the Edge Server Administration Console. These views surface some of the more typical RFID performance metrics and serve as examples of the Telemetry Console Extension's view and graphing capabilities. The Telemetry Console Extension includes the following built-in views:

- EventCyclesCompleted—For each Edge Server configured in the Console, a chart displays the number of event cycles completed within the specified telemetry interval. The telemetry time interval is configurable. See Changing the Sample Interval.
- ReadCycleTime—For each RFID Device configured on an Edge Server, a chart displays the amount of time each logical reader (antenna) is taking for a read cycle.

Built-in views are available for every user logged into the Edge Server Administration Console and using the Telemetry Console Extension.

You can modify a built-in view, but the modification is only visible during your current session; it is lost when you switch back to the primary RFID Console view. If you want to modify and save one of the built-in views, you can clone it and save it as a custom view.

- A custom view is any view created by a user. Custom views are available only to the user who created them. You can save a custom view and access it again when needed.

The Telemetry Console Extension provides no pre-defined custom views.

The charts and graphs in a view can display telemetry data for any of the Edge Servers configured in the Edge Server Administration Console.

Table 3-1 describes the visual cues that help identify the views in the Views tab.

Table 3-1 Views Tab Icons
Visual Cue | Description | What it Means
| Green icon adjacent to a view name | The view is active and data polling is occurring for all charts in that view. (This is true whether or not the view is currently displayed in the View panel.)
| Yellow icon adjacent to a view name | The view is inactive and data polling is not occurring for the charts in that view.
| View name in italic font | The view has not yet been saved.

## Displaying and Modifying an Existing View

To display and modify an existing view:

1. Select the Views tab to display the list of available views.
2. Click the name of the view.

The view appears in the View panel, replacing the view that is currently displayed. (Only one view can be displayed at a time.)

3. Add and modify charts, as desired. See Working with Charts and Graphs.
4. To roll back unsaved changes, click the (Discard All Unsaved Changes) button or right-click on the name of the view and select Discard Changes from the context menu.
5. Save the view (custom views only) by clicking the (Save All Modified Views) button on the toolbar.

## Creating a Custom View

To create and display a new custom view:

1. Select the Views tab.
2. In the text field, enter a name for the view.
3. Click Create.

The new, empty view is displayed in the View panel.

4. Add and modify charts, as desired. See Working with Charts and Graphs.
5. Save the view by clicking the (Save All Modified Views) button on the toolbar.

## Creating a View Based on an Existing View (Cloning)

To create and display a view based on an existing view:

1. Select the Views tab.
2. Click the name of the existing view on which you want to base a new view.
3. In the text field, enter a name for the new view.
4. Click Clone to copy the current view with a new name.

The new, cloned view is displayed in the View panel. Until you make changes, the cloned view has the same properties as the view upon which it is based.

5. Add and modify charts, as desired. See Working with Charts and Graphs.
6. Save the view by clicking the (Save All Modified Views) button on the toolbar.

## Saving a Custom View

While you can modify any view for the current session, you can save only custom views. To save a custom view:

1. Select the Views tab.
2. Right-click the name of the custom view you want to save and select Save Changes from the context menu.

Alternatively, click the (Save All Modified Views) button on the toolbar.

## Deleting a View

You can only delete custom views. To delete a custom view:

1. Select the Views tab.
2. Click the name of the view you want to delete.
3. Click the (Delete) button in the toolbar.

## Starting and Stopping Views

When you start a view, polling commences for the charts in the view. That is, the client starts polling for data from the Edge Server, so that the data can be represented in one or more graphs. When you stop a view, polling for the view ends.

To start a view:

1. Select the Views tab.
2. Click the name of the view you want to start or right-click and select Start from the context menu.

To stop a view:

1. Select the Views tab.
2. Right-click the view you want to stop, and select Stop from the context menu.

To stop all active views, click the (Stop All Active Views) button in the toolbar.