NeoLoad and Dynatrace integration

Delivering optimal application performance and seamless user experience is crucial in today’s competitive market. With the increasing complexity of applications, performance testing has become an indispensable aspect of the development and deployment process. The integration of Dynatrace and NeoLoad offers a powerful combination that elevates performance testing capabilities.


In this article, we’ll discuss the specifics of setting up and managing the Dynatrace-NeoLoad integration, along with how it can enhance your application’s performance and ensure a smooth end-user experience.

Configure Dynatrace to monitor the systems you plan to test

The integration is predicated on Dynatrace’s ability to monitor the systems that NeoLoad will exercise during a performance test. Installation of the Dynatrace OneAgent to monitor the applications under test is a necessary first step in this process. Typically, this applies to pre-production systems found in the development and QA environments.

These platforms can be quite ephemeral, being created and destroyed with high frequency as part of a Continuous Integration and Continuous Delivery process. Implementing the creation of application infrastructure as code is a recommended best practice to ensure consistency of these platforms from version to version, as well as automating the installation of the Dynatrace OneAgent and the integration of that agent into the overall monitoring platform. By automating this process, you gain several key benefits, not least of which is that the platform is ready for performance testing. The NeoLoad test results will include detailed metrics collected from Dynatrace.

Additionally, you need to manually put a tag on a Dynatrace service at the traffic entry point of your application, typically your web front servers or proxies. From there, the integration will auto-tag all connected hosts, services and processes in the Dynatrace smartscape.

Configure the API Token within Dynatrace

Within the Dynatrace web interface, select Manage → Access Tokens. Here you can create a new API token that you will then provide to NeoLoad. This token needs to have the correct permissions in order to access the application under test, so ensure that you create it with the correct scope.

For example, a header sent to Dynatrace could be:

X-Dynatrace-Test: SI=NeoLoad;VU=0;SN=MyUserPath;PC=/page.html;ID=8;NA=Actions.transaction.;GR=Default zone;TE=Sample_Project-scenario1-09aab63a-bf17-4505-9d70-f6c267055b89

Dynatrace integration is compatible with RealBrowser user paths along with protocol user paths. When you enable Dynatrace Integration on a RealBrowser test, the values for PC, ID, and NA will all be empty.

Add Dynatrace monitoring agent

Once this step is complete, you can add a Dynatrace monitoring agent to your project. Do this by selecting Design → Monitors & Connectors → New monitored machine, then select the option to create a Dynatrace Monitor.

What is happening here is that NeoLoad will create a monitoring agent, and that agent will – using the URL and API token defined in your preferences – reach out to Dynatrace during a test execution to retrieve metrics. At the same time, as the test executes, NeoLoad will include header information in each request sent as part of the test that Dynatrace will use to automatically configure dashboards for the performance test as it occurs.

This integration allows disparate groups – the performance engineering team and the IT operations team – to view performance test results in their preferred solution of choice. The performance engineers, using NeoLoad, have all of the Dynatrace metrics embedded in their test results. The operations team, using Dynatrace, have all the NeoLoad metrics added to their view. Both teams can collaborate and analyze the results using their existing expertise with their preferred software solution.


Setting up Dynatrace integration with NeoLoad allows performance engineering teams to gain a level of insight and information on the system under test that is hard to achieve otherwise. As application infrastructures increasingly leverage newer technologies such as Kubernetes, elastic computing, and cloud platforms, monitoring applications under test is becoming increasingly complex. By simply offloading that work to Dynatrace, not only do you gain superior monitoring capabilities that can automatically detect relevant platforms used in your test, but you also expose your performance testing efforts to a broader audience and enable better collaboration between teams. For an IT Operations team, the visibility of the performance characteristics of an application under test – well before it is deployed into their production environment – can offer a great deal of confidence in the delivery process and smooth deployment into production.

For the performance engineering teams, using Dynatrace for your performance testing means the difference between knowing there is a problem during the login process, and knowing there is a problem in the login process because the Kerberos message was delayed on the authentication server due to a CPU constraint caused by poorly configured resource caps on the Kubernetes cluster that manages it. It is a dramatic difference in the quality of the analysis capabilities available to you, and if the deployment of OneAgents can be automated as part of the delivery process, you will always have access to it.