Dynatrace SaaS and Managed monitors
Dynatrace monitors enable the monitoring of resources, processes, and services in an application environment. These monitors give the Controller access to data measured by Dynatrace SaaS, a cloud-based APM tool, and Dynatrace Managed, the on-premises model.
Note: For the supported server versions, see the Integrations section of the System Requirements guide.
The Dynatrace SaaS and Dynatrace Managed monitors connect directly to the Dynatrace environment and collect data without requiring a scenario.
If you are using Dynatrace Managed, install it as described in the Dynatrace Managed documentation. The Dynatrace Managed monitor is supported on a variety of Linux platforms. For details, see Managed System Requirements.
To set up the Dynatrace monitoring, the following is required:
- Proxy settings appropriately defined for the machine on which the Controller is running.
- An active Dynatrace SaaS account.
- A Dynatrace environment ID. The monitoring environment is where all Dynatrace performance analysis take place. The environment ID is designated by a segment (<environment_ID>.live.dynatrace.com) of the Dynatrace environment URL.
- A Dynatrace API token. The API token grants access to the Dynatrace API, which Controller uses to query your Dynatrace SaaS environment. Once you have created a token for your environment, it remains the same for every use, unless you change or delete it.
Tip: Save the environment ID and the API token codes so that you can easily copy them when needed.
In your Dynatrace account, go to Settings > Integration > Dynatrace API.
Click Generate token.
- You are prompted for a token name. Enter a meaningful name.
In the list of token options, enable Access problem and event feed, metrics, and topology under API v1, and Read metrics under API v2.
These options enable the Controller to request and receive data from Dynatrace.
- Scroll down, and click Generate.
Monitor Dynatrace metrics
All Dynatrace SaaS and Managed metrics are available for selection in LoadRunner Professional.
Note: When Controller queries Dynatrace for available hosts (Get Hosts), only hosts that have been active in the last hour are taken into account. Therefore, make sure the clock on the LoadRunner Professional machine is set to the correct time.
To set up and monitor data from Dynatrace SaaS or Dynatrace Managed:
In Controller, in the Run tab, select Graphs > Dynatrace Graphs > Dynatrace SaaS / Managed.
The Dynatrace graph opens in the display area.
The Controller requests data for each selected measurement approximately once per minute. Therefore, to see the data displayed in real-time in the Controller when not running a test, the Graph Time must be greater than 60 seconds.
In the Dynatrace SaaS graph Configuration menu, select Settings > Graph Time, and select a duration of at least Last 180 sec for Dynatrace SaaS, or Last 600 sec for Dynatrace Managed.
In the Dynatrace SaaS/Managed graph display area, click Add measurements (or select Add Measurements from the Dynatrace SaaS/Managed graph Configuration menu).
The Dynatrace SaaS/Managed dialog box opens.
In the Monitored Server Machines pane, click Add to add a host.
In the Dynatrace SaaS/Managed Login dialog box, enter the required details:
UI Element Description Server
Your Dynatrace environment ID, in the format:
- For Dynatrace SaaS: <environment_ID>.live.dynatrace.com
- For Dynatrace Managed: <FQDN>/e/<environment_ID>
The token string generated by your Dynatrace user account. For details on generating the token, see the instructions in Prepare for Dynatrace monitoring.
- Click Get hosts. The list of available hosts is displayed. Select the host from which you want to collect data, and click OK.
If you are using more than one host, add each one separately by repeating steps 4-6.
Select one host in the Monitored Server Machines pane, and click Add in the Resources Measurements pane.
Note: Measurements are applicable to only one host. With one host selected, you select the measurements for it. Then repeat the process for additional hosts.
In the Dynatrace SaaS/Managed Measurement Selection dialog box, select the metrics you want to monitor, and click Add.
Note: The Dynatrace SaaS/Managed monitor has a limit of 50 metrics. See Known issue for Dynatrace API.
The complete name of the metric is displayed in the Selected Measurements pane.
For detailed information on the performance measurements that Dynatrace can monitor, refer to the Dynatrace documentation.
When you have finished selecting measurements, click OK.
The measurements are now listed in the Resources Measurements pane of the Dynatrace SaaS/Managed dialog box.
In the Resource Measurement Description pane, click OK to confirm.
- After some brief processing, the Controller displays the Dynatrace graph.
The Dynatrace API has an access limit of 50 requests per minute for each environment. If the limit is exceeded for a Dynatrace API environment, it is likely that some of the data will not be received.
The Measurement Selection dialog box prevents you from selecting more than 50 metrics for one host, but does not prevent you from exceeding this number when setting up metrics for multiple hosts in the same environment (such as 40 metrics on one host and 20 metrics on another).