View the dashboard

Vusers generate data as they perform transactions during test runs. The dashboard enables you to analyze the transaction performance and status of a selected run for a load test.

Dashboard overview

The dashboard provides a variety of customizable widgets to analyze performance of your load test run.

To access the dashboard:

  1. In the Runs page, select a run to analyze from the Runs List. The Summary page of the run opens.

  2. Click the Dashboard tab.

The dashboard contains a summary bar, which includes:

Run Information: Details such as the run name, start time, duration, hits per second, throughput, and the maximum number of concurrent Vusers.

Error Summary: The number of errors generated during the run. Click the Details link to view the Errors page for more information.

Summary bar in dashboard page.

The dashboard also contains the following:

Dashboard tabs: These tabs consist of customizable widgets that display performance data for the run. For details, see Widgets.

Metrics pane: The metrics tree pane shows which metrics are displayed in the active widget and provides configuration options. For details, see Metrics pane.

Back to top

Dashboard tabs

The first time you open the dashboard for a run, a tab Dashboard 1 with four widgets is displayed. Each widget contains a single metric:

  • Running Vusers

  • Hits per second

  • Throughput

  • Errors

You can customize the metrics displayed in the widgets in the tab, add up to 10 widgets, and change the layout. You can also create multiple dashboard tabs, with each tab showing different content.

Tabs are not persistent between test runs. This means that after you create a dashboard for a load test run, any tabs you create, the initial tab and any additional ones, will not be available for other runs of the same load test.

The following table describes how to manage the dashboard tabs.

Action Task
Create a tab

  1. Click the Add dashboard button + to add a new dashboard tab.

  2. Select either a single widget dashboard or a four-widget dashboard. You can add more widgets to the tab at a later stage.

  3. A new tab opens with the selected number of widgets.

When the limit of 10 tabs has been reached, the Add dashboard button + becomes inactive.

Rename a tab Click the Edit button on the tab.
Close a tab

Click the Close button X on the tab.

Note:

  • There must be at least one open tab.

  • A closed tab cannot be re-opened.

Add metrics For details on adding metrics to widgets, see Metrics pane.
Add a widget

Click the Add widget button +.

An empty widget is added to the dashboard.

You can add up to 10 widgets per dashboard tab. When the limit has been reached, the Add widget button + becomes inactive.

Change time range

 Set the time range by dragging the start and end indicators of the time picker slider. The time picker configuration impacts all the widgets in the selected tab.

Back to top

Metrics pane

The metrics pane 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.

Use the following actions to configure the metrics you want to include in the active dashboard tab.

Action Task
Hide or show the metrics pane

Click the Collapse metrics pane button collapse button to hide the pane , or the Expand metrics pane button to display the pane.

Select or deselect a metric for viewing

Manage the metrics that are displayed in the widgets in the active tab.

  • To select a metric for display, select the metric name checkbox. The metric is added to the currently active widget.

  • To remove a metric from a widget, clear the metric name checkbox.

Merge multiple metrics into one display

Merging allows you to compare several different measurements at once. For example, you can make a merged graph to display throughput and number of hits per second, as a function of the elapsed time.

  • Select the metrics you want to merge. The metrics are added to the currently active widget.

  • You can merge up to five metrics in one widget.

    Note: Some metrics have a special representation and cannot be merged with other metrics.

Search for a metric

Click the Search button to open the search box and enter a string to launch the search. The names of the metrics containing the string are displayed in the tree, and the search string is highlighted.

Widgets

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

By default, the title of the widget is comprised of the names of the selected metrics. Tab titles are limited to up to 255 characters. To change the title of the widget, see Customize widgets.

Note: If you change the title of the widget and then add additional metrics, the title reverts to the names of the selected metrics.

Back to top

Change the layout and order of widgets

You can customize the layout and order of widgets on a tab.

To change the layout:

  1. Click the Layout manager button layout manager.

  2. Select a layout.

    The following layouts are available:

    • Large tiles: One tile per screen.

    • Small tiles: Four tiles per screen .

    • Two rows: Two widgets per screen, stacked on top of each other.

    • Two columns: Two widgets per screen, stacked next to each other.

To change the order of the widgets:

  1. Hover over the title bar of the widget. The drag and drop cursor is displayed.

  2. Drag the widget to a new position.

Filter the widget display

You can filter the data displayed in a specific widget to focus on the information that is relevant to you.

To apply a filter to a widget:

  1. Select the widget.

  2. Click the widget's Filter button filter .

  3. Define the filter criteria. The filter options vary depending on what metrics are displayed in the widget.

When a filter is set, this is indicated by an active filter notification dot on the Filter button . The filter is applied only to the specific widget.

Back to top

Delete widgets

You can remove a widget from a dashboard tab.

To delete a widget:

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

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

Back to top

View data as a graph or table

The selected metrics can be viewed in the widget as a graph, table, or both.

To switch between graph and table display:

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

  2. Click the View button . Turn on the Graph or the Table switch, or switch on both. When selecting Table view, you can also select the columns to include.

Tip: When viewing both graph and table, select a row in the table under the graph, the corresponding measurement in the graph displays in bold.

Back to top


Export a widget

You can export a widget to use in reports, or to share with others who do not have access to the dashboard. By exporting the data table, you can analyze or manipulate the raw data further.

To export the graph as an image file:

  1. Click the widget's Expand View button .

  2. In the View menu, select Export graph as image. The file is downloaded in PNG  format.

To export the data table:

  1. Click the widget's Expand View button .

  2. Click the Export button above the data table.

  3. Select the file format:

    • CSV file.

    • image file.

  4. The file is donwloaded.

Back to top

Customize widgets

You can customize the display of graphs and measurements in your test run. For details, see Customize widgets.

Back to top

See also: