Dashboard

LoadRunner Cloud's dashboard enables you to analyze the performance of a selected run for a load test. For short demos of the dashboard features, see Dashboard demos.

Dashboard overview

LoadRunner Cloud's dashboard displays information about your load test run. Open the dashboard in one of the following ways:

  • Go to the Load Tests page, click on a test, and navigate to the Runs pane. Click on a run.

  • Open the Results page and click the More Information button in the row of the selected test run. Click Dashboard.

Four graphs are opened in the default dashboard view, one for each of the following metrics:

  • Running Vusers

  • Hits per second

  • Throughput

  • Errors

Add dashboard views

A dashboard view is contained in a tab. You can create up to 20 tabs for a load test run, with each tab showing a different dashboard.

For example, for run number 10 of a load test:

  • Tab 1 can show metrics A, B, and C and compare the selected run to another run (number 11).
  • Tab 2 can show metrics X, Y, and Z and compare the selected run to a different run (number 12).

The tabs are persistent for the current user and for the specific load test. This means that once you create a dashboard for a load test run, any tabs you create (both the initial tab and any additional ones) are applicable for all runs of the same load test.

Tab controls are located at the bottom of the dashboard. To create and work with tabs, do one of the following:

Action Method
Create a tab
  • Right-click an existing tab and select New tab.

  • Click .

The new tab that is created contains metrics for the latest run of the selected load test. If there is an active run of the load test (that is, it is currently running) then that is considered the latest run.

Rename a tab Right-click a tab and select Rename.
Duplicate a tab Right-click a tab and select Duplicate. The name of the new, duplicated tab is the same as the original tab name with the addition of -1. For example, if the original tab name is MyTab, the duplicated tab name is MyTab-1.
Close a tab
  • Right-click a tab and select Close.
  • Click the X next to the tab name.

Note:

  • A closed tab cannot be re-opened.

  • There must be at least one tab open.

A dashboard view comprises two panes. The left pane shows which metrics you are seeing and provides various configuration options. The right pane shows the actual data in multiple graphs.

Tip: Click TRX Summary in the top of the dashboard to open a new tab with a summary of the transactions. To return to the graphs displaying the selected metrics, click its tab (by default Tab -x).

Back to top

Choose metrics

The dashboard provides metrics that help you evaluate your test results. For details about the available metrics, see Dashboard metrics.

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

Action Description
Select or deselect a metric for viewing
  • To select a metric, click the empty cell to the left of the metric name. The icon denotes that a metric is selected and appears in the currently active graph. A grayed icon indicates that the metric is included in a graph that is currently inactive.

  • To deselect a metric, click the icon next to the metric name.

  • To hide all metrics, click Hide all above the metrics tree.

The number of selected metrics is displayed at the bottom of the Metrics pane.

Show or hide sub-metrics by type

To display a menu showing the number of sub-metrics by type, hover over a metric, and click the More Information button .

To customize the graph display, select Show or Hide and choose the category to display. Repeat this step for each of the categories that you want to display.

For parent level metrics, you can show the number of related scripts, transactions, locations, and emulations. For detail, see Metrics pane columns.

Note: The Scripts category is only available for the following metrics: Total transactions per second, Passed transactions per second, and Failed transactions per second.

Tip: When hiding sub-metrics, select All to hide all the metrics under the parent metric, regardless of their type.

Search for a metric Enter a string in the search box and click the magnifying glass icon. The metrics whose name contains the string are displayed in the tree.
Open or close a metric node Click the arrow next to a metric name to open or close the tree for that specific metric.
Open all selected metrics Click Expand visible to open the tree for all selected metrics.
Resize value columns

Click the vertical ellipsis in the header of any of the metrics pane columns and select:

  • Autosize This Column (for one column)
  • Autosize All Columns (for all columns)
Highlight metrics

Click on an enabled metrics in the metrics pane to highlight it in the graph. To highlight multiple metrics, use Ctrl+click or Shift+click.

The graph highlights the data lines and the table entry of the metrics.

Note:  

  • When you select or deselect metrics, they are only added to or removed from the currently active graph.
  • Transaction response time breakdown metrics are not added to the currently active graph. Instead, each such metric is displayed in its own graph. You cannot add other metrics to these graphs.
  • You can include a combined total of 1,000 metrics in all of the graphs in the dashboard.

Empty data

Empty metrics are grayed out and displayed in italics (both in the metrics pane and in the graph and table legends). These are metrics that were carried over from a previous run, but for which there is no data. This may be due to a change in a script or an on-premises load generator that is no longer available. Alternatively it may be a temporary state due to the fact that data has not yet been generated for the metric.

Icon Description

Clears a single empty metric with no data from the dashboard.

Clears all empty metrics. Alternatively, right-click a metric name and from the menu displayed, and select Clear empty metrics.

SLA breaches

Metrics that breach a configured SLA, or have anomalies, are further denoted as follows:

Icon Description
An SLA was breached, but the breach did not cause the load test run to fail.
An SLA was breached and the breach caused the load test run to fail. This icon also represents the detection of an anomaly together with an SLA breach (or a parent metric with an SLA breach and an anomaly for its children).
An anomaly was detected.

The percentage of SLA breaks for the metric is displayed in the Break column and the anomaly rank and number of anomalies is displayed in the Anomaly column.

Back to top

Choose test runs

You can configure the dashboard to show a specific test run or to compare two test runs.

Show a specific a test run

To change the test run displayed in the dashboard, navigate to the project node in the masthead to exit the dashboard. Open the Runs pane and select a different run.

Compare two load test runs

You can compare the selected run to another run of the same load test. The relevant metrics for the additional run are added to all the graphs in the dashboard.

To add a run for comparison, click and in the dialog box that opens do one of the following:

Action Description
Add a run

Add a non benchmarked run for comparison.

  1. Select the radio button for the required run.
  2. Click Compare.
Add a benchmark run

Add the benchmarked run for the load test for comparison.

Click Compare to benchmark.

For details on setting a run as a benchmark, see Test details.

Note: If you change the benchmark to a different run of the load test, any dashboard that already contains a comparison to the benchmark is updated to reflect the new benchmark run. If you do not want this to happen, click Compare with run id instead of Compare to benchmark. This will add the currently benchmarked run for comparison, but it will not be updated in the event of a benchmark change.

Clear a run

Remove the run currently selected for comparison.

Click Clear Selection.

Click Apply.

When a run has been added for comparison, the run number or is displayed next to the Compare button. Click the run number or the Benchmark button to re-open the dialog box to change your selection.

A Value, Break, and Anomaly column for the added run are displayed in the metrics pane, in which the values for the selected metrics, for a selected time point in the graph, are displayed.

Once added, you can toggle the added run to hide or show it by clicking .

Back to top

Metrics pane columns

The metrics pane displays a hierarchical tree of the metrics available for the selected load test run. You can also display additional columns in the metrics pane: Value, Break, and Anomaly

Column Description
Value The value of the metrics you select to view, for a specific time selected in the graph. When you move the time picker in the graph, the value changes accordingly.
Break The percentage of SLA breaks for the metric.
Anomaly

The sum of the metric's anomaly ranks and in parenthesis, the number of anomalies.

The rank denotes the likelihood that the metric caused the anomaly and this is determined by three criteria:

  • Which data point was the earliest to deviate from the baseline?
  • How big was the deviation?
  • How long was the deviation?

The rank range is between 0-5.

To choose which columns to display:

  1. Click the vertical ellipsis in the header row, adjacent to the run number.

  2. Click the tab with the column selection button .

  3. Select the columns to display. The metrics pane shows the selected columns.

  4. To autosize the columns, click the vertical ellipsis in the header row of the column you want to adjust, and select Autosize This Column or Autosize All Columns.

Back to top

 

Graph display

The currently active graph is denoted by a blue border. Click on a graph to make it the currently active one. When you select or deselect metrics, they are only added to, or removed from, the currently active graph.

Note: Transaction response time breakdown metrics are not added to the currently active graph, but are added as a separate graph.

The following table describes the graph's elements:

Element Description
Graph title The graph's title is comprised of the names of the graph's selected metrics.
Legend The graphs are line graphs, with a line for each selected metric in the graph. The lines are color coded defined by the legend at the bottom of the graph.
SLA breaches

SLA breaches are shown as a red shaded area and the SLA threshold is denoted by a horizontal, dashed line. For details, see SLA breaches.

Anomalies Anomalies are shown as an orange line. When you click on an anomaly, the graph displays an orange shaded area. The intensity of the orange color is determined by the rank of the anomaly—the higher the rank, the stronger the color.
X-axis, Y-axis

The x-axis of the graph shows the load test run's time line and the y-axis shows the metric's value. If you have selected multiple runs in the dashboard, by default the time line is:

  • that of the longest run, if the selected runs do not include an active run.

  • that of the active run, if the selected runs include an active run.

For details, see Customize the time frame.

Data point tooltips

To display a tooltip with the metric name, value, and run ID, hover over a data point inside the graph.

Back to top

Customize graph views

You can configure the view for all graphs or you can customize graphs individually.

Customize all graph views

Use the following actions to customize the view for all graphs:

Action Description
Show/Hide Metrics tree

To show or hide the Metrics pane, click on the Show/Hide metrics tree toggle button .

Enable or disable tooltips You can enable or disable tooltips by toggling the Show points details button.
Select the graph scale

To change the scale of the graphs, select one of the following options from the drop-down menu at the top right of the dashboard:

  • No scale. No scale is used for the y-axis and shows actual values.
  • Scale. Uses a linear scale for the y-axis and shows actual values.
  • Log scale. Uses a logarithmic scale for the y-axis. This can be helpful when the data covers a large range of values, as it reduces the range to a more manageable size.

Note: Graphs for transaction response time breakdown metrics are not scaled.

Set a time mode

By default, the time mode used for all the graphs included in a dashboard tab is the test time. That is, the starting time of zero is the beginning of the test and the time frame is the elapsed time from the start of the test.

You can change the time mode to clock time so that the actual, local clock time is displayed instead.

To change between Test time and Clock time, select the required option from the Test time dropdown.

Note:

  • The time mode is persistent for the tab.
  • If you take a snapshot of a graph, the selected time mode is indicated in the snapshot.
Stop a test run

Note: This option is available for active runs only.

Click Stop Test to stop an active test run.

Customize individual graphs

To highlight a line in the graph, click on it. To highlight multiple lines, use Ctrl+click. The metrics for highlighted lines are also highlighted in the metrics pane.

Use the following actions to customize an individual graph's view:

Action Description
Show/Hide graph

You can hide or show the graph legend by toggling Show/Hide graph button .

Show/Hide legend

You can hide or show the graph legend by toggling the Legend button.

When the legend is displayed, you can:

  • Click a column name to sort the legend table by that column.
  • Click the Options menu icon next to a column name to display a list of legend options.
Choose columns

Expand the Columns dropdown to select the columns to show in the table. Click Esc to close the column selection box.

Add to report

You can create a snapshot for a dashboard graph and include it in the load test run's report.

To create a snapshot and add it to the report, click in the toolbar of the graph you want to add. The snapshot is automatically added as a new section in the report. You can add a maximum of 10 snapshots to a report. For details, see Report.

Search

Enter text to search for a specific metric.

Back to top

Manage and reposition graphs

Use the following actions to add, remove, and reposition graphs:

Action Description

Split horizontal

Click to split the current graph into two. The left hand graph contains the original graph and the right hand graph is a new, empty graph.

To populate the new, empty graph, click it to make it active and then select the metrics you want to appear in it.

Split vertical

Click to split the current graph into two. The top graph contains the original graph and the bottom graph is a new, empty graph.

To populate the new, empty graph, click it to make it active and then select the metrics you want to appear in it.

Close a graph Click to close an open graph
Reposition a graph Click and drag a graph to reposition it in the dashboard view.

Back to top

Display transaction summary data

You can display transaction summary data in table form using the following options. The table is displayed in its own pane, either in the current tab or in a new tab.

Display Action Outcome
Selected transactions for a run in an existing tab In the metrics pane, select the transactions you want to display. A new pane opens in the existing tab that includes a table showing summary data for the selected transactions.
All transactions for a run in an existing tab In the metrics pane, navigate to the Transactions > Summary node. Right-click Summary and then select Show > Transactions. A new pane opens in the existing tab that includes a table showing summary data for all the transactions included in the run.
All transactions for a run in a new tab Click the TRX Summary button. A new tab opens with the Transaction Summary table. It contains data from all transactions included in the run.
Note: Comparisons to other run and time picker settings are not applicable to this table.

Note: The calculation of the transactions per second in the Transaction Summary table, TPS (avg), differs from the TPS rate shown in the widgets (graphs). The Transaction Summary table shows the average transactions per second since the start of the test run, while the widget shows the transactions per second over time, with each data point representing the average at a given time.

Back to top

Customize the time frame

Use the following actions to customize the time frame for a graph:

Action Description
View a specific time

Click within a graph to select a specific time in the run. The views of all the graphs are updated accordingly and the metric values displayed in the Value column in the metrics pane are also updated. The specific time selected is displayed in a time counter at the top left of the graph area.

Zoom to a specific frame

The time frame for which results are displayed is shown at the top of the graph. You can change the time range using one of these options:

  • Drag, stretch, or shrink the time slider.
  • Place the cursor in the graph area and drag it left or right to select a time range.
  • Manually change the start and end time counters located above the graphs.
Select a preset time frame

Note: This option is available for active runs only.

From the drop-down list to the right of the time slider, select a preset time frame to view. The time frame is the last selected number of minutes of the run.

Available options are 5, 15, 30, and 60 minutes. The default time frame is five minutes.

The graph is refreshed automatically every five seconds.

If you use the time slider to select a time frame, Manual appears in the preset box and the graph is no longer automatically refreshed.

Back to top

See also: