Dynatrace SaaS monitor
The Dynatrace SaaS monitor gives Controller access to data measured by the Dynatrace SaaS platform, a cloud-based APM tool. Dynatrace SaaS enables monitoring of resources, processes, and services in an application environment.
Note: For the supported server versions, see the Integrations section of the System Requirements guide.
Set up the Dynatrace SaaS monitor
The Dynatrace SaaS monitor connects directly to the Dynatrace environment and collects data without requiring a scenario.
To set up the Dynatrace SaaS monitor, the following is required:
- Proxy settings appropriately defined for the operating system of the machine on which Controller is running.
- An active Dynatrace SaaS account.
- Dynatrace environment ID. The monitoring environment is where all Dynatrace performance analyses take place. The environment ID is designated by a segment (<unique-string>.live.dynatrace.com) of the Dynatrace environment URL.
- 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.
Keep a note of the ID and the API token codes so that you can easily copy them when needed.
To create an API token for your Dynatrace environment:
-
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.
This option enables Controller to request and receive data from Dynatrace.
- Scroll down, and click Generate.
Monitor Dynatrace SaaS metrics
All Dynatrace SaaS 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:
-
In Controller, in the Run tab, select Graphs > Dynatrace Graphs > Dynatrace SaaS.
The Dynatrace SaaS monitor graph opens in the graph display area.
-
Controller requests data for each selected measurement approximately once per minute. Therefore, to see the data displayed in real-time in 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 Last 180 sec or a longer duration.
-
In the Dynatrace SaaS graph display area, click Add measurements (or select Add Measurements from the Dynatrace SaaS graph Configuration menu).
The Dynatrace SaaS dialog box opens.
-
In the Monitored Server Machines pane, click Add to add a host.
-
In the Dynatrace SaaS Login dialog box, enter the required details:
UI Element Description Server Your Dynatrace environment ID, in the format:
<unique-string>.live.dynatrace.comAPI Token The token string generated by your Dynatrace user account. For details on generating the token, see the instructions in Set up the Dynatrace SaaS monitor.
- Click Get hosts. The list of available hosts is displayed. Select the host from which you want to collect data, and click OK.
-
(Optional) If using more than one host, you need to add each one separately by repeating steps 4-6.
-
With one host selected in the Monitored Server Machines pane, 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 Measurement Selection dialog box, select the metrics you want to monitor, and click Add.
Note: The Dynatrace SaaS 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 SaaS 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 dialog box.
-
In the Resource Measurement Description pane, click OK to confirm.
- After a short wait, Controller displays the Dynatrace SaaS graph.
Known issue for Dynatrace API
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).
See also: