Dashboard

The dashboard enables you to analyze the performance of a selected run for a load test. For short demos of the dashboard features, see Feature demos.

Dashboard overview

The dashboard displays information about your load test run. Open the dashboard in one of the following ways:

Page How to open the dashboard
Load tests Open a test, and click Runs Runs in the sidebar . Click a run.
Results

Click the Dashboard button Dashboard button in the row of a test run.

The dashboard's banner contains a summary bar.

Dashboard summary bar

The summary bar includes information about the run such as the start time, duration, and the run mode. In addition, the summary bar lists the alerts that were generated during the run. Click on any of the alerts for more information. For details, see Runtime alerts.

Aside from the summary bar, the dashboard view is comprised of two panes:

  • Graphs pane: The graph pane contains graph views of the performance data. For details, see Dashboard views.

  • Metrics pane: The metrics tree pane shows which metrics you are seeing and provides configuration options. For details, see Metrics tree.

Back to top

Dashboard views

After the first run, the dashboard displays four graphs in the graphs pane:

  • Running Vusers

  • Hits per second

  • Throughput

  • Errors

Aside from the initial graph view, you can create additional views with other graphs in other tabs. You can create up to 20 dashboard tabs, with each tab showing different content.

For example, for a specific run:

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

The tabs are persistent for the current user and for the specific load test. 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 be available for all runs of the same load test.

The following table describes how to manage the dashboard tabs.

Action Task
Create a tab

Use one of the following options:

  • Right-click an existing tab and select New tab.

  • Click the New tab button New dashboard tab button.

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 tab is the same as the original tab name with the addition of a -2 suffix.
Close a tab

Use one of the following options:

  • Right-click a tab and select Close.
  • Click X.

Note:

  • A closed tab cannot be re-opened.

  • There must be at least one tab open.

Tip: Click TRX Summary 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

Metrics tree

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.

OpenText Core Performance Engineering assigns a ranking to each anomaly based on the earliest occurrence, size, and duration of the deviation. The rank represents how the anomaly compares to other anomalies seen for the metric in the same run. The more severe or unusual the anomaly, the higher the rank. The rank range is between 0-5. For details, see Anomalies.

Example:7(2) where 7 is the total sum of the metric’s anomaly ranking (out of a maximum of 10) for the 2 anomalies that occurred during the time period.

Anomaly examples

To choose which columns to display:

  1. Click the More options button More options button in the header row, adjacent to the run number.

  2. Click the column selection button Column selection button.

    Select columns example

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

    Selected metrics tree

  4. To autosize the columns, click the More options button More options button in the header row of the column you want to adjust. Click the More options selection button More options button above the Search box. Select Autosize This Column or Autosize All Columns.

Empty metrics

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
Delete button

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

Delete empty metrics button

Deletes all empty metrics. Alternatively, right-click a metric name and select Delete empty metrics.

SLA breaches and anomalies

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

Icon Description

SLA breach indicator

An SLA was breached, but the breach did not cause the load test run to fail.

SLA breach and failure indicator

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).

Anomaly indicator

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

Select metrics for the graphs

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 Hide metrics tree button Hide Metrics pane button or the Show metrics tree button Show Metrics pane button.

Select or deselect a metric for viewing

Manage the metrics that are displayed in the active tab:

  • To select a metric, select the metric name checkbox. The metric is added to the currently active graph and the icon is displayed in dark blue. An icon displayed in light blue indicates that the metric is included in a graph that is currently inactive.

    If a tree node is inactive, click the Expand tree button Expand tree button to drill down, and then select one of the sub-metrics.

  • To deselect a metric, clear the metric name checkbox.

  • To clear all metrics from the active graph, click the Clear widget button Clear widget button above the metrics tree.

The number of selected metrics is displayed in the Metrics pane.

Add or remove sub-metrics by type

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

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

To add or remove all the metrics under the parent metric, select Add or Remove and then select All.

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

Add or remove metric

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

Search for a metric

Click the magnifying glass icon to open the search box, enter a string and click the magnifying glass icon again to launch the search. The metrics whose name contains the string are displayed in the tree.

Open or close a metric node

Click the Expand buttonExpand button to open or close the tree for that specific metric.

Open all selected metrics

Click the Expand visible button Expand visible button above the metric tree to open the tree for all selected metrics.

Resize value columns

Click the More options button More options button in the header of a metrics pane column and select:

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

Click an enabled metric in the metrics pane to highlight it in the graph. You can highlight multiple metrics by holding down SHIFT or CTRL while clicking the metrics that you want to highlight.

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.

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, go back to the Runs pane for the test Runs pane button 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 the Compare button Compare button 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
  1. Add the benchmarked run to the load test for comparison.

  2. Click Compare to benchmark.

For details on setting a run as a bench-mark, see Test details and actions.

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 adds the currently benchmarked run for comparison, but it will not be updated in the event of a benchmark change.

Clear a run
  1. Remove the run currently selected for comparison.

  2. Click Clear Selection.

  3. Click Apply.

When a run has been added for comparison, the run number or Benchmark button is displayed. Click the run number or the Benchmark button to activate or deactivate the comparison.

Click the Edit button next to 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.

Back to top

Graph display

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

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

By default, the graph's title is comprised of the names of the graph's selected metrics. You can change the graph's title by clicking the edit icon.

Note: If you change the graph's title, the names of newly added or deleted metrics are not added to, or removed from, the new title.

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.
SLA breaches

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

Anomalies Anomalies are shown as an orange line. When you click 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.

For details, see Anomalies.

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.

X and Y axis

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.

Data point tooltips

Back to top

Customize graph views

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

Customize all graph views

To customize the view for all graphs, open the View menu and use the following actions:

Action Task
Activate or deactivate tooltips Move the Point details switch to activate or deactivate tooltips.
Show or hide SLA background color Move the SLA switch to show or hide the background color for SLAs in the graphs.
Show or hide anomalies background color Toggle the Anomalies switch to show or hide the background color for anomalies in the graphs.
Set the time display 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 time display option.

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.
Select the graph scale

To change the scale of the graphs, select one of the following options:

  • 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.

Stop a test run

Note: This option is available for active runs only.

Click Stop Test to stop an active test run.

Customize a specific graph

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

To customize the view for the selected graph, open the View menu and use the following actions:

Action Task
Show or hide the graph

Toggle the Graph switch.

Show or hide the legend

Toggle the Legend switch.

When the legend is displayed, you can click a column name to sort the legend table by that column.

Select columns

In the Columns list, select the columns to show in the table.

Additional customization options available are:

Action Task
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 the Add to report Add to report button button 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 Reports.

Search

Click the Find icon Search icon to enter the search text for a specific metric.

Back to top

Manage and reposition graphs

The table below describes how to add, remove, and reposition graphs.

Action Task

Split horizontal

Click the Split horizontal button Split horizontal button to split the current graph into two horizontally. One graph contains the original data, and the other 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 show.

Split vertical

Click the Split vertical button Split vertical button to vertically split the current graph into two graphs. One graph contains the original data, and the other 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.

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. The table is displayed in its own pane, either in the current tab or in a new tab.

Display How to set up the display 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, go 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.

Transaction Summary table

The following data is shown in the Transaction Summary table:

  • Transaction name: The transaction name.

  • Script name: The script in which the transaction is included.

  • Max: The maximum time it took for a transaction to complete.

  • Avg: The average time it took for a transaction to complete.

  • Min: The minimum time it took for a transaction to complete.

  • Passed: The number of transactions that ended successfully without errors.

  • Failed: The number of transactions that failed to run until the end.

  • Success rate %: The percentage of successful transactions out of all transactions that ran.
  • TPS (avg): The average number of transactions per second from the beginning of the test.

  • STD: The standard deviation for transaction response time.

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 particular 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 in the graph area.

Zoom to a specific frame

You can change the time range for which graph results are displayed using one of these options:

  • Drag, stretch, or shrink the time slider.
  • Place the cursor in the graph area and drag it 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, 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: