Manage widgets and metrics

This topic describes how to manage metrics, configure widgets, and organize widget content.

In this topic:

Metrics tree

The metrics tree includes the metrics available for the test run. Only standard metrics, such as Errors per second and Throughput, or metrics that have data for the run are listed.

The following table lists metric configuration actions for the active dashboard tab.

Action	Description
Hide or show the metrics tree	Click the Hide metrics tree button to hide the tree, or the Show metrics tree button to display the tree.
Select or deselect a metric for viewing	Manage metrics displayed in widgets in the active tab. To select a metric for display, select the metric name checkbox. The metric is added to the active widget. For the list of available metrics, see Analyze graphs. To remove a metric from a widget, clear the metric name checkbox.
Combine multiple metrics in a single display	Compare several measurements at once by combining metrics in a single widget. For example, create a graph that displays both throughput and hits per second over the same elapsed time. Select the metrics you want to combine. The metrics are added to the currently active widget. For limits, see Dashboard limits. Note Some metrics have a special representation and cannot be combined with other metrics.
Search for a metric	Click the Search button , enter a search string, and review matching metrics in the tree. The search string is highlighted.

Widget behavior

Widgets are interactive components that display metrics and data on your dashboard. Before you manage widgets and metrics, understand the following key behaviors.

To understand widget behavior:

1. Before you manage widgets and metrics, sign in to your tenant and select a project and run. For details, see Sign in and select a run.

2. Click a widget to make it active. The active widget is indicated by a colored border. Only one widget can be active at a time. When you select or clear metrics, they are automatically added to or removed from the currently active widget.

3. To view a widget in more detail, click the widget's Expand View button . A window opens displaying the selected widget and its metrics.

Edit widget title

Rename any widget title to make dashboards easier to understand and personalize. Edit the title on the dashboard or in Expand view. By default, widget titles are generated from the names of the selected metrics and are limited to 200 characters.

To rename a widget from the dashboard:

1. Click the widget to make it active.

2. Do one of the following:

   • Click the widget's Options menu and select Edit title.

   • Click the title when the icon appears.

3. Type the new title and click Save.

To rename a widget from Expand view:

1. Select a widget and click the widget's Expand View button .

2. Hover over the widget's title, and click the Edit button .

3. Type the new title.

Indicate a time point across widgets

Mark a point in time during a run. This is useful for long runs.

To indicate a time point:

Click a point in time on a widget. A vertical time indicator line is displayed.

The time indicator marks the same point in time across all the widgets of the tab. The time indicator line is also displayed on the time picker slider at the top of the tab.

Manage widget layout and order

Customize widget layout and order on a tab.

To change the layout:

1. Click the Layout manager button .

2. Select a layout from the following options:

   • Large tiles: One tile per screen.

   • Small tiles: Four tiles per screen.

   • Two rows: Two widgets stacked vertically.

   • Two columns: Two widgets side by side.

To reorder widgets:

1. Hover over the title bar of a widget.

2. When the drag and drop cursor appears, drag the widget to a new position.

Filter widget data

Filter data displayed in a specific widget to focus on relevant information.

To apply a filter to a widget:

1. Select the widget.

2. Click the widget's Filter button .

3. Select criteria and values for each filter condition. Available filters depend on the metrics displayed in the widget.

   Filter by	Description
   Transaction name	The name of the transaction.
   Transaction end status	The end status of a transaction: Passed, Failed, Stopped.
   Group name	The name of the group to filter by.
   Script name	The name of the script.
   Vuser IDs	The IDs of the Vusers you want the data to display, separated by commas. To specify a range of Vusers, enter the beginning and end of the range you want to display. Example: 5, 7, 10-45.
   Host name	The name of the Host machine. Select one or more hosts from the list.
   Think Time	Think Time options: Don't include or Include. By default, think time is turned off and the transaction time displayed shows pure time.

When a filter is set, an active filter notification dot appears on the Filter button . The filter applies only to the selected widget. To clear the filter, click Clear Filter. All values in the filter are deleted.

Delete widgets

You can remove a widget from a dashboard tab.

To delete a widget:

1. Click the Options menu button on the title bar of the widget.

2. Click the Delete button . The widget is removed from the dashboard.

View widget data as a graph or table

View selected metrics in the widget as a graph, a table, or both.

For graph display settings and table configuration, see Graph display options.

To switch between graph and table display:

1. Click the Options menu button on the title bar of the widget.

2. Click the View button .

3. Turn on the Graph switch, the Table switch, or both switches.

4. If you turn on Table view, select the columns to include.

To emphasize the graph display, click the graph to make it bold. Click the graph again to restore the default display.

Duplicate and copy widgets

Reorganize widgets across dashboard tabs to streamline analysis and reporting. Copy a widget to another tab, or duplicate it within the same tab.

The following widget properties are preserved when you copy or duplicate a widget:

• Assigned metrics: Copied to the new widget.

• Applied filters: Copied to the new widget.

• Table configuration: Selected columns and display settings are copied.

• Measurement selections: Copied to the new widget.

• Visual properties: Widget titles, colors, and chart settings are copied.

To copy a widget to another tab:

1. Click the widget's Options menu .

2. Hover over Copy to tab and select a destination tab.

   Note: Tabs at the widget limit are unavailable. The current tab is not listed. Use Duplicate to copy within the same tab. For limits, see Dashboard limits.

To duplicate a widget within the same tab:

1. Click the widget's Options menu .

2. Select Duplicate. The duplicated widget appears near the original.

   Note: This option is unavailable if the tab already contains 10 widgets.

Limitations

The following restrictions apply when you copy or duplicate widgets:

• Cross-run copying: Not supported.

• Entire tab copying: Not supported.

• Dashboard limits: Limits apply. For details, see Dashboard limits.

See also

• View the dashboard
• Manage dashboard tabs
• Export dashboard data