Monitors

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

In this topic:

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 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 dashboard's Monitors node shows the metrics for the collected data. For details, see Dashboard.

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

  • Choose a monitor from your Monitor assets. Click the Add from Assets button and select a monitor from the list. The monitors in the Assets area are available for all tests. For details, see Manage monitors.

  • Define a monitor for the current test. Click the Create button Create button to open the New Monitor dialog box. Select a monitor and provide its details.

For information 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 SiteScope to monitor your load test. For details, see the Operations Management page.

Action Task
Before you start

Make sure that:

  • A data integration tag has been set up in SiteScope.
  • A SiteScope agent has been installed and is started. For more details, see SiteScope.
Create a monitor

  1. From the Assets > Monitor page, click the Create button Create button 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 with SiteScope.

Note: A single 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.

Action Task
Create a monitor

From the Assets > Monitor page, click the Create button Create button 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.

Action Task
Create a monitor

  1. From the Assets > Monitor page, click the Create button Create button 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 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.

Action Task
Create a monitor

From the Assets > Monitor page, click the Create button Create button 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.

Action Task
Create a monitor

From the Assets > Monitor page, click the Create button Create button 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.

Action Task
Enable Amazon CloudWatch

Submit a service request.
Configure AWS authentication

In your AWS monitored account:

  1. Create a role called R1_<tenantNumber>_Cloud_Watch_Role (for example, R1_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: Math expressions are not supported.
Create a monitor

From the Assets > Monitor page, click the Create button Create button 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:  

  • Only metric type widgets are supported.

  • Data is only fetched from the authenticated AWS account number and region.

  • When running a test configured with an Amazon CloudWatch monitor, data is fetched, and the dashboard is updated, only every five minutes.

  • Metrics fetched with a delay greater than five minutes is not supported.

Back to top

Add a Datadog monitor

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

Action Task
Create a monitor

From the Assets > Monitor page, click the Create button Create button 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.

  4. Select the Datadog site where you have your user account. US1 - East, US3 - West, US5 - Central, EU1 - Europe, AP1 - Japan, and US1 - FED (FedRamp) are supported.
Configure your monitor

Give the monitor a name, and select the metrics to monitor.

Back to top

See also: