Run Dashboard

The Run Dashboard displays details of the running performance tests, and enables you to perform all runtime test run actions.

Tip: You can also view performance measurements for tests that have finished running in offline graphs. For details, see View test run results offline.

Interactive Run Dashboard

The Run Dashboard opens automatically when a performance test starts, or when you open a running test. The dashboard displays a synopsis of the running performance test, and provides all the available options for managing the test run.

The banner contains summary information such as the Run ID, test name, current state, Vuser errors, transaction status, and Vuser run status. By default, the dashboard shows some common graphs, such as the number of Running Vusers, Error statistics, and Throughput.

Online dashboard window

The Graphs tree contains a list of the available graphs that you can add to the display. The graphs are listed by category, such as Runtime Graphs, System Resource Graphs, and Transaction Graphs.

Tip: Hover over a point in the graph to open a popup window showing the current values of the measurements.

For details on other resources that are available in the results page such as result files, event logs, and audit files, see View results offline.

Back to top

Run Dashboard views and toolbar

The following views are available in the Run Dashboard.

View Description
Graphs The Graphs view displays performance measurements for those resources being monitored in a performance test. This view is displayed by default in the Run Dashboard. For details, see Graphs view.
Groups The Groups view displays the statuses of the Vusers in the performance test. For details, see Groups view.
Transactions The Transactions view displays how many transactions have been run successfully or unsuccessfully. For details, see Transactions view.
Messages The Messages view displays error, warning, debug, and output messages that are sent to the Controller by the Vusers and load generators during a test run. For details, see Messages view.
Monitors The Monitors view displays monitors from all the monitor profiles and over firewall agents that are associated with the selected test. You can add new monitors to the test from this view. For details, see Monitors view.

The following toolbar buttons are available in the Graphs, Groups, and Transactions views of the Run Dashboard.

UI Elements

Description

Vusers Details Vusers Details button

Displays specific details for each Vuser in the performance test, and enables you to run or stop Vusers irrespective of their defined schedules. For user interface details, see View Vuser details.

Run Vusers

Enables you to run additional Vusers during the course of a performance test. That is, you can run Vusers that are not included in the test's original defined schedule. For details, see Run Vusers.

Load Generators

Enables you to manage the load generator in the performance test. For details, see Manage load generators.

Timeslot Duration

Enables you to extend or shorten the duration of the performance test. For user interface details, see Change timeslot duration.

More More button

Click to display the following options:

  • Add Group. Enables you to add a Vuser group to a running performance test, or to edit Vuser group settings during a test run. For details, see Manage Vusers during a run.

  • Edit Scheduler. Enables you to edit the scheduler during a test run. For user interface details, see Edit the scheduler during a test run.

  • Rendezvous. Enables you to activate and deactivate rendezvous points defined in the Vuser scripts, and to set rendezvous policies that determine how the Controller handles Vusers at a rendezvous point. For user interface details, see Set rendezvous policies.

Search Search button

Enables filtering the information being displayed in each of the views by the search string.

Back to top

Graphs view

Note: The user interface was modernization in 25.3 and these updates are reflected in the help. While some steps may differ slightly in 25.1, the core functionality remains the same.

To access: In the Run Dashboard select the Graphs view.

You can manage the graphs in the following ways.

Action

Description

Add a graph to the dashboard

In the Graphs tree, click the Display graph button adjacent to the graph name to display a graph in the dashboard. The tree displays the configured graphs and merged graphs that are available.

  • check mark Indicates the graph is currently being displayed in the graph editor.

  • Anomaly indicator Indicates an anomaly has occurred in the graph.

  • Indicates a merged graph.

A maximum of 12 graphs can be displayed simultaneously.

Merge into an existing graph

You can merge graphs using the following methods:

  • In the Graphs tree, select a graph and drag the graph by its anchor Graph anchor into an existing graph.

  • In the Graphs tree, click the More action button adjacent to the graph name, and select Create merged graph > {Graph_name}.

The merged graph is displayed in the graph editor. Graphs that are merged are displayed in the Merged list in the graphs tree.

Note:

  • The number in parentheses indicates the number of similar graphs that exist in the Graphs tree. For example, Throughput (2).

  • The number indicates how many measurements were selected for each graph; to select a measurement you have to click it. For example, 1 X.

  • The number at the bottom indicates how many measurements were selected out of the total number of measurements in all graphs. For example, 3/5 selected.

Rename a graph

In the Graphs tree, click the More action button adjacent to the graph name, and select Rename.

Duplicate a graph

In the Graphs tree, click the More action button adjacent to the graph name, and select Duplicate.

Rearrange the graphs Select a graph and drag the graph by its anchor Graph anchor to the desired location.

Adjust the time range displayed in graphs

In the timeline area, expand the Granularity list Granularity selectorand set it to display the Last 3 minutes, Last 10 minutes, Last 1 hour, Whole Run, or Manual focus. The selected time range is displayed in the input panels located to the left of the range.

Slider

When set to Manual focus, drag the slider in the timeline to choose a start time and end time. You can also specify the time manually in the time string. The slider automatically reflects the values that you entered. You can also move the selection (maintaining the same granularity), and select a new range.

Note: To ensure the correct real time for running the performance test is displayed in the online graph, the time zone on the OpenText Enterprise Performance Engineering Server and any external analysis database servers must all be synchronized.

Configure global settings

Click the Settings button Test Options button located above the timeline area, and set the following options:

  • Time Display: The time displayed on the x-axis.

    • Relative to load test start. Displays the amount of time that has elapsed since the beginning of the test (in hours, minutes, and seconds).

    • Server clock. Displays the time on the OpenText Enterprise Performance Engineering server clock.

    • Custom time zone. Displays the time according to the UTC time zone you select (this time is also displayed in the Messages view). Any changes to the time zone remain persistent in online and offline results.

  • Timeline graphs. Turn the switch to on to display the graph timeline in the timeline area.
  • Legend options. Displays the graph legend either as a list or a grid.

  • Show measurements. You can show all measurements, only visible measurements from the legend, or only measurements that have anomalies.

  • Anomaly sleeve: An on/off switch indicating whether to show anomaly sleeves globally. An anomaly sleeve highlights the section of the graph from the beginning of the anomaly until its end, for each anomaly. For details, see Detect anomalies.

Change the line colors In the legend, click the color assigned to a measurement to open the color selector, and choose a different color.

Individual graph controls

You can manage individual graphs in the following ways.

Action

Description

Configure individual graph settings

Click the Settings button Test Options button in the toolbar of a selected graph, and set the following options:

  • Anomaly sleeve. An on/off switch indicating whether to show anomaly sleeves globally. An anomaly sleeve highlights the section of the graph from the beginning of the anomaly until its end, for each anomaly. For details, see Detect anomalies.

  • Scale options. Scales measurements approximately so that they appear in the same range in the y-axis. This avoids measurements with smaller values appearing as flat lines with zero value. Select the desired scale:

    • Automatic. Displays each measurement in the graph in the scale that best suits it.
    • None. Displays each measurement's true values.
  • Show measurements. You can show all measurements, only visible measurements from the legend, only measurements that have anomalies, or only the measurements set as favorite.

Rename a graph

Hover over the graph name and click the Edit button to edit the name of the graph.

Maximize a graph and control the measurements pane

Click the Expand button Maximize or minimize graph button in the graph's toolbar to maximize the selected graph. When you maximize the graph, you have access to the following controls in the Measurements pane:

  • Show. The measurements displayed in the selected graph. You can select All, Only visible, Only with anomalies, or Only favorites.

  • Resize graph display and measurement grid. Drag up or down to resize the graph area and the measurements grid.

  • Select columns. Select and rearrange measurement details in the grid columns. For details, see Measurement details.

  • Search. Search for measurements by name in the legend.

  • Display measurement in graph. Displays the measurement in the graph.

  • Hide graph measement from graph. Hides the measurement from the graph.

  • Display measurement in bold in the graph. Displays the measurement in bold in the graph.

  • <measurement color>. Click to open the color selector, and choose a different color to display the measurement in the graph.

  • Show only me. Displays only the selected measurement and hides the others from the graph.

  • Set as favorite button. Select to save the measurement as a favorite.

Minimize a graph

Click the Contract button to minimize the graph and return to the graphs pane which displays all the selected graphs.

Measurement details

Measurement details are described in the table below.

Option

Description

Name

The measurement name. A warning icon Anomaly indicator appears for measurements that contain an anomaly.

Note: IP addresses for over firewall monitors (MOFW) and load generator hosts (OFW) display the IP address for the MI Listener and not the actual host IP address.

Scale The graph scale.
Max Value The measurement's maximum value. At every time stamp, the maximum values among all Vuser data points are selected. Then, the maximum of all these values is displayed.
Min Value The measurement's minimum value. At every time stamp, the minimum values among all Vuser data points are selected. Then, the minimum of all these values is displayed.
Average The measurement's average value.
Std Dev The measurement's standard deviation.
Last value The measurement's last value.
Machine The name of the load generator machine.
Anomalies Turn the switch on or off to show or hide anomalies associated with the measurement.
Favorite Indicates if the measurement is set as a favorite.
<page list>

Enables you to move to the first, last, or a specific graph measurements page.

Note: Displayed only for graphs that have at least 20 measurements.

Groups view

The Groups view displays the statuses of the Vusers in the performance test.

To access: In the Run Dashboard select the Groups view.

User interface elements are described below.

UI Elements

Description

Name

The Vuser group name.

Down

The number of Vusers that are down.

Pending

The number of Vusers that are ready to be initialized and are waiting for an available load generator, or are transferring files to the load generator. The Vusers run when the conditions set in their scheduling attributes are met.

Init

The number of Vusers that are being initialized on the host machine.

Ready

The number of Vusers that have already performed the init section of the script and are ready to run.

Running

The number of Vusers that are running. The Vuser script is being run on a host machine.

Rendezvous

The number of Vusers that have arrived at the rendezvous and are waiting to be released.

Gradual Exiting (displayed as G. Exit)

The number of Vusers that are finishing their current iteration before exiting.

Exiting (displayed as Exit)

The number of Vusers that have finished running, or have been stopped, and are exiting now.

Paused

The number of Vusers that have been paused.

Stopped

The number of Vusers that have been stopped manually.

Passed

The number of Vusers that have finished running. The script passed.

Failed

The number of Vusers that have finished running. The script failed.

Error

The number of Vusers for which a problem occurred.

Back to top

Transactions view

The Transactions view displays the number of completed, successful and unsuccessful transactions performed during the test run.

To access:

  • In the Run Dashboard, select the Transactions view.

  • In the Run Dashboard banner, click the Transactions the Details link. To display transactions sorted by status, click the passed or failed transaction button .

User interface elements are described below.

UI Elements

Description

Name

The transaction name.

For details on transaction names, see Transaction naming conventions.

Passed

The number of times the transaction passed.

Failed

The number of times the transaction failed.

Stopped

The number of times the transaction stopped.

Success Rate %

The transactions success rate percentage.

TPS

The number of times per second the transaction has run.

Tip: You can also view details of failed transactions in the test run using Quick Trending, and perform trending analysis by drilling down and investigating specific transactions related to the run. For details, see Perform quick trending analysis.

Back to top

Messages view

The Messages view displays error, warning, debug, and output messages that are sent to the Controller by the Vusers and load generators during a test run.

To access: In the Run Dashboard select the Messages view, or click the error link in the banner.

User interface elements are described below.

UI Elements

Description

Group by

Enables grouping messages by Code, Message, Host, Script, or Vuser.

After you have selected a grouping, the grid displays a drilled down view. You can click a link to filter grid data by the selected value. For example, if data is grouped by Code and you drill down on a specific code, the grid displays all messages for the selected code.

Note:

  • In online screen and offline view:

    If None is selected in the Group by filter, then Sort by and Change sort order Change sort order button are enabled; otherwise Sort by and Change sort order Change sort order button are not available.

  • In online screen only:

    If None is selected in the Group by filter and Sort by is selected by any selection other than Time, then only the first 500 rows are displayed.

Type

Enables filtering the messages by a specific message type:

  • Errors. Usually indicates that the script failed.

  • Warnings. Indicates that the Vuser encountered a problem, but that the test continued to run.

  • Notifications. Provides runtime information.

  • Debug. Sent only if the debugging feature is enabled in the Controller. To enable the feature, select Tools > OpenText Enterprise Performance Engineering Controller Options > Debug Information.

Default: All Types

Sort by

Enables sorting column values by Time, Type, Code, Message, Host, Script, or Vuser.

After selecting a sort value, the latest 50 messages are displayed on the page. You can scroll to see additional pages (each page displays the next 50 messages).

Click the Change sort order button Change sort order button to sort the selected column values in ascending or descending order.

Note: When you change the sort order in the online screen, scrolling is limited to displaying the first 500 rows only, according to the selected sort order. Offline view retains full sorting functionality, enabling you to scroll all messages (in rows of 50).

Vuser Log

Select a row in the grid and click Vuser Log. The Vuser activity log opens, enabling you to view a list of messages for each Vuser. The log contains the following information:

  • Activity log for Vuser. The selected Vuser whose ID is being displayed.

  • Refresh. Enables you to refresh the log.

  • Download log. Enables you to download the log.

  • Log Message area. Displays a list of all messages received for the selected Vuser.

  • Snapshot. Generates a snapshot (a graphical representation of the Web page) of the point in the test run where an error occurred. Before using this feature, you must enable the Generate snapshot on error option in the script's runtime settings. For details on the runtime settings, see Configure runtime settings.

Note:

  • Rows cannot be selected when data is grouped.

  • This option is not available in the offline results view.

Clear All Messages

Clears all messages.

Note: This option is not available in the offline results view.

Refresh All

Select the refresh option:

  • Refresh All. Displays the latest 50 messages on a page. You can scroll to see additional pages (each page displays the next 50 messages).

  • 500 Rows. Displays the 500 top rows according to the selected sort options.

Note: This option is not available in the offline results view.

Time

The time the message was generated.

Note: Displays the time according to the UTC time zone if Time Display > Custom time zone was selected in the Graphs view. For details, see Time Display.

Type

The type of message. For details, see Type above.

Code The message code.
Message

The received message. To copy a message to the clipboard, right-click the message and select Copy to clipboard.

Host

The host that generated the message. You can click a host link to group messages by the selected host value.

Script The script that generated the message. You can click a script link to group messages by the selected script value.
Action The action in the script where the message was generated.
Line The line in the script where the message was generated.
Iteration The iteration during which the message was generated.
Vuser The Vuser which generated the message. You can click a Vuser link to group messages by the selected Vuser value.
Total Messages

The total number of messages received for the selected grouping.

Note: Displayed only when messages are grouped.

Total Vusers

Displays the total number of Vusers for the selected grouping.

Note: Displayed only when messages are grouped.

Back to top

Monitors view

The Monitors view displays monitors from all the monitor profiles and over firewall agents that are associated with the selected test. You can add new monitors to a running test from this view.

Note:  

  • This view is only available if monitors are associated with the running test.

  • Any monitors that you add during the test, or updates you make to existing monitors from this tab, do not affect the monitor profile and are discarded after the test run.

To access: In the Run Dashboard select the Monitors view.

  • To view monitor profiles associated to the test or to add a new monitor, select the Runtime Monitors tab. For details on adding and managing monitors while a test is running, see Manage runtime monitors.

  • To view all monitor over firewall agents associated to the test or to add a new monitor over firewall agent, select the Monitors Over Firewall tab. For details on adding a new monitor over firewall agent, see Create a monitor over firewall agent profile.

Back to top

See also: