Monitors

A monitor gathers data about your servers, such as an application or web, during your load test.

Manage monitors

Manage your monitors in one of the following places:

  • Assets > Monitors tab

  • Load tests > Monitors pane

Use the Assets area to manage monitors globally in the OpenText Core Performance Engineering repository, and make them available to all tests in your project. Use the Load tests area to manage monitors for a specific test.

Add monitors to your test assets

Use the Assets > Monitors tab to add application or server monitors to your test assets. After the monitors are added to the assets, they are available for all of your load tests.

The following actions are available from the Monitors tab:

Action Description

Create a new monitor

Click the Create button Create button to open the New Monitor dialog box. Choose one of the available monitors:

Edit a monitor

Click the Edit button Edit button to open the Edit monitor window, allowing you to edit the name and measurements that you want to monitor.

Delete a monitor

Click the Delete button Delete button to remove the selected monitors.

Add monitors to your load test

The load test's Monitors page shows the monitor configured for the load test. Each load test can only be assigned one type of a server or application monitor. You can, however, have multiple monitors of a single type.

The listed monitor collects data about the test run during your load tests. The metrics for the collected data are shown in the Monitors node in the Dashboard.

To set up a server or application monitor for your load test, do one of the following:

For details about the supported monitor versions, see the Support Matrix.

Back to top

Add a SiteScope on-premises monitor

If your application is behind a firewall, use a SiteScope on-premises monitor to monitor your load test. You can download the latest version from the SiteScope Downloads page.

Action Task
Before you start Make sure that:
  • A data integration tag has been set up in SiteScope.
  • A OpenText Core Performance Engineering agent has been installed and is started. For more details, see SiteScope.
Create a monitor
  1. From the Assets > Monitor page, click Create to open the New Monitor dialog box.
  2. Select SiteScope on Prem as your monitor type.
Configure your monitor

Select metrics to monitor.

Tip: To expand the full list of metrics, click the Expand button.

In addition to the standard monitors, the following Dynamic Docker monitor types are supported:

  • Docker
  • Cluster Swarm

When you select a Dynamic Docker monitor type, all metrics are added to your test definition.

You can also find additional information on this topic in the blog Agentless monitoring meets cloud load testing: LoadRunner Cloud with SiteScope.

Note: A single OpenText Core Performance Engineering agent cannot be used in more than one load test at a time.

Back to top

Add a New Relic monitor

The following table includes the steps required to add a New Relic monitor to your load test.

Create a monitor From the Assets > Monitor page, click Create to open the New Monitor dialog box.
Add a New Relic monitor
  1. Select New Relic as your monitor type.
  2. Enter your New Relic REST API Key.
  3. Select an application to monitor.
Configure your monitor Give the monitor a name, and select metrics to monitor.
  • To expand the full list of measurements, click the Expand button.

  • If there are more than 500 metrics, the Expand and Collapse buttons are unavailable.

  • If no measurements are listed, make sure that your New Relic monitor is up and running, and that OpenText Core Performance Engineering is connecting to it.

Back to top

Add a Dynatrace SaaS monitor

The following table includes the steps required to add a Dynatrace SaaS monitor to your load test.

Create a monitor
  1. From the Assets > Monitor page, click Create to open the New Monitor dialog box.
  2. Select Dynatrace SaaS as your monitor type.
Add a Dynatrace SaaS monitor
  1. Enter the URL for your Dynatrace SaaS console.

  2. Enter your Dynatrace API token.

    Note: The token must be a V1 API token that includes scopes for DataExport. V2 API are not supported.

  3. Click Connect.

  4. Select the host you want to use.

    Note: You can select only one host. To use additional hosts, you must create a new monitor in OpenText Core Performance Engineering for each host you want to use.

Configure your monitor Select the metrics to monitor.

Back to top

Add an AppDynamics monitor

You can create a monitor for a SaaS based version of AppDynamics and add it to your load test. The following entities are supported: servers and Kubernetes pods, clusters, and containers.

Create a monitor From the Assets > Monitor page, click Create to open the New Monitor dialog box.
Add an AppDynamics monitor
  1. Select AppDynamics as your monitor type.

  2. Enter the following AppDynamics controller login credentials:

    • Server URL - the AppDynamics controller URL.

    • Account name - the AppDynamics account.

    • User name - the AppDynamics account.

    • Password - the AppDynamics password (included in the AppDynamics welcome email).

    Tip: To view your AppDynamics controller login credentials, access your AppDynamics subscription, select your controller, and click Show Controller Login Info.

  3. Click Connect.

  4. Select a server to monitor.

Configure your monitor Give the monitor a name, and select metrics to monitor.
  • To expand the full list of measurements, click the Expand button.

  • If no measurements are listed, make sure that your AppDynamics monitor is up and running.

Note: When using an AppDynamics monitor in a load test, AppDynamics metrics are shown with a delay of approximately two minutes. This means that a load test that runs for less than three minutes may not display any AppDynamics metrics.

Supported AppDynamics metrics

OpenText Core Performance Engineering supports the full list of hardware resource metrics available in AppDynamics for the supported entities listed above.

Back to top

Add an Application Insights monitor

The following table includes the steps required to add an Application Insights monitor to your load test.

Create a monitor From the Assets > Monitor page, click Create to open the New Monitor dialog box.
Add an Applications Insights monitor
  1. Select Application Insights as your monitor type.
  2. Enter your Application Insights application ID.
  3. Enter your Application Insights API key.
Configure your monitor Give the monitor a name, and select the metrics to monitor.

Back to top

Add an Amazon CloudWatch monitor

The following table includes the steps required to add a SaaS based Amazon CloudWatch monitor to your load test.

Enable Amazon CloudWatch in LoadRunner Cloud Submit a service request.
Configure AWS authentication

In your AWS monitored account:

  1. Create a role called LRC_<tenantNumber>_Cloud_Watch_Role (for example, LRC_12345678_Cloud_Watch_Role).

    Note: If you have multiple tenants, create this role for each tenant.

  2. Add an external ID to the role. This ID is used as part of the authentication when you configure a new monitor in OpenText Core Performance Engineering.

  3. In the new role, attach a policy with the following permissions:

    Action

    cloudwatch.GetMetricData

    cloudwatch.ListDashboards

    cloudwatch.GetDashboard

    Resource

    * (asterisk)

    Example:  

    Permission JSON example

  4. Add the following OpenText Core Performance Engineering accounts in the role's trusted relationships:

    arn:aws:iam::426960784327:root

    arn:aws:iam::238239958415:root

Configure AWS regions In AWS IAM > Access management > account settings, ensure that the regions you want to monitor are enabled as Endpoints in the Security Token Service section.
Configure the CloudWatch dashboard

Configure the CloudWatch dashboard with the metrics you want to monitor.

Note:

  • OpenText Core Performance Engineering supports only metric type widgets.

  • OpenText Core Performance Engineering does not support Math expressions.

Create a monitor in LoadRunner Cloud From the Assets > Monitor page, click Create to open the New Monitor dialog box.
Add an Amazon CloudWatch monitor

Select Amazon CloudWatch as your monitor type and enter the following credentials:

  • AWS account number

  • External ID

  • Region

Click Next.

Select a Dashboard

Select a Dashboard to monitor or turn on the Show widgets switch to display dashboard widgets and select the widgets to monitor.

Note:

  • You can only select widgets from the same dashboard.

  • Each dashboard only displays its widgets that have a name. Unnamed widgets are all grouped together under Widgets_without_customized_name.

Click Next.

Select metrics

Select the metrics to monitor. Metrics from different widgets are grouped together by namespaces, metric name, dimensions, and stat.

Note:  

  • OpenText Core Performance Engineering supports only metric type widgets.

  • OpenText Core Performance Engineering fetches data only from the authenticated AWS account number and region.

  • When running a test configured with an Amazon CloudWatch monitor, OpenText Core Performance Engineering fetches data and updates the dashboard every five minutes.

  • OpenText Core Performance Engineering does not support metrics fetched with a delay greater than five minutes.

Back to top

Add a Datadog monitor

The following table includes the steps required to add a Datadog monitor to your load test.

Create a monitor From the Assets > Monitor page, click Create to open the New Monitor dialog box.
Add a Datadog monitor
  1. Select Datadog as your monitor type.
  2. Enter your Datadog application ID.
  3. Enter your Datadog API key.
Configure your monitor Give the monitor a name, and select the metrics to monitor.

Back to top

Next steps: