Dynatrace and LoadRunner integration

The LoadRunner Request Tagging tool for Dynatrace is a command line tool that automatically adds the relevant HTTP headers to requests generated by LoadRunner's Virtual User Generator (Web - HTTP/HTML project types). See Dynatrace and load testing tools integration for more details on load testing integration with Dynatrace.

The LoadRunner Request Tagging tool inserts a short method addDynatraceHeaderTest in your globals.h or globals.js file that populates the x-dynatrace-test header. It also parses your .c or .js files and automatically adds a call to this method before one of the key LoadRunner methods is called. Both C and JavaScript scripting languages are supported.

Modify LoadRunner scripts for Dynatrace

  1. Record a LoadRunner Virtual User Generator (VUGEN) script and adapt it as needed. Refer to LoadRunner documentation for details.

  2. Download the latest release of the LoadRunner Request Tagging tool for Dynatrace

  3. Patch or unpatch the LoadRunner scripts.

The LoadRunner Request Tagging tool uses the following syntax:

java -jar Dt-LoadRunner-request-tagging.jar <mode> <path parameter> <optional parameters>
  1. Verify that the method addDynatraceHeaderTest has been added to your script

Configure request attributes

The header x-dynatrace-test is populated by the LoadRunner Request Tagging tool with the key/value pair listed below. These values can be captured by Dynatrace by defining request attributes. Not all key/value pairs need to be configured; only configure the one you're interested in for targeted analysis of your load tests.

Here is an example of how to configure the request attribute for the test step name (TSN):

  1. In Dynatrace, configure the extraction rules for the custom HTTP Headers via Settings > Server-side service monitoring > Request attributes.

  2. Select HTTP request header as the Request attribute source and enter the name of your custom HTTP header in the Parameter name field. Extraction of the test step name TSN from the x-dynatrace-test can be configured as seen below.

  1. Run your load test from LoadRunner. The requests and PurePaths will be tagged in Dynatrace with the configured request attributes for targeted diagnostics and analysis.


There are different ways to analyze the data. Your approach should be based on the type of performance analysis you want to do (for example, crashes, resource and performance hotspots, or scalability issues). The request attributes set for the load test will help you filter the data. In this example, they are used to analyze the response time of the test step search journey paris:


Further reading