Integrate with DynaTrace APM

Dynatrace is an Application Performance Monitoring (APM) tool designed for analyzing the performance of application servers, database servers, and web services.

This document includes references to a third-party product, Dynatrace. The user interface and usage of third-party products are subject to change without notice. For the latest published information about Dynatrace, see Dynatrace Documentation.

BlazeMeter offers two integration options with Dynatrace:

  • Anonymous integration: BlazeMeter sets up a test that sends HTTP requests to your monitored servers, and the resulting monitoring KPIs are instantly accessible within your Dynatrace application.
  • Integration with a Dynatrace profile: You can integrate your BlazeMeter tests with a specific Dynatrace profile. You configure a BlazeMeter test to send requests to your monitored servers, and the associated monitoring KPIs become readily available within your Dynatrace application.

These integration options empower you to effectively monitor and optimize the performance of your applications, ensuring a seamless user experience.

BlazeMeter includes two versions of the Dynatrace APM integration:

  • Dynatrace APM - deprecated
  • Dynatrace APM
Dynatrace deprecated the Tokens API v1 with Dynatrace version 1.242. Its replacement is Access tokens API. We recommend that you migrate to the new API at your earliest convenience.
Because Dynatrace has deprecated their v1 APIs with Dynatrace version 1.243, and replaced them with v2 APIs, we have created a new Dynatrace integration to accommodate this change.
  • If you are using a Dynatrace version that is 1.243 or higher, use the Dynatrace APM integration.
  • If you are using a Dynatrace version that is lower than 1.243, use the Dynatrace APM – deprecated integration.

For more information, see https://www.dynatrace.com/support/help/dynatrace-api/basics/deprecation-migration-guides

Set up Dynatrace to work with BlazeMeter

You can leverage Dynatrace metrics within BlazeMeter reports and send distributed tracing data from BlazeMeter to Dynatrace via headers. This section outlines the necessary setup steps within Dynatrace to facilitate this integration.

  • Pulling Metric Values into BlazeMeter Reports—To pull metric values from Dynatrace into BlazeMeter reports, you can utilize BlazeMeter Profiles.
  • Sending Distributed Tracing Data—BlazeMeter can send distributed tracing data to Dynatrace via headers, enabling you to trace a request's path through its journey across various components such as apps, rpc (Remote Procedure Call), queue, and more.

BlazeMeter adds a customer header to requests that are run through JMeter performance tests. This header includes the Sample Name, Number of VUs, and Load Locations for each request. This allows for distributed tracing of the request from source to end point.

To view the headers sent from BlazeMeter to Dynatrace and facilitate distributed tracing, perform the following steps in Dynatrace:

  1. Create a new request attribute.
  2. Within the request attribute settings, add a new data source.
  3. Set the request attribute source to HTTP Header Request.
  4. Define the parameter name as "x-dynaTrace".
  5. Set Preprocess parameters by extracting substring to after and NA.

For more information, see Dynatrace Documentation.

Create an Anonymous Integration

This integration involves inserting header lines into your JMeter file, visible exclusively from the Dynatrace APM perspective. You can use this integration for a new or existing performance test.

No reports will be generated on the BlazeMeter side through your Dynatrace account.

To enable this integration, ensure that the access token in Dynatrace has the following scopes: entities.read, events.read, metrics.read, and metrics.ingest. For information about how to configure token scopes, see the Dynatrace documentation.
  1. Navigate to the BlazeMeter Test Configuration page.
  2. In the Integrations section, click Dynatrace APM (or Dynamic APM - deprecated).

  3. Select the Integrate using Dynatrace HTTP headers option.

    When you execute this test, BlazeMeter appends a header line to the JMX of the test. This action enables Dynatrace's agent to identify the load test and display BlazeMeter's requests in a specific format, featuring request labels, thread numbers, response codes, and more.

  4. Access these results within Dynatrace. For more information, see the Dynatrace documentation.

Integrate BlazeMeter with your DynaTrace Profiles

This integration enables you to access APM metrics from both the Dynatrace APM and BlazeMeter sides, depending on your profile setup.

You can use this integration for a new or an existing performance test.

  1. Navigate to the BlazeMeter Test Configuration page.
  2. In the Integrations section, click Dynatrace APM (or Dynamic APM - deprecated).

  3. Select the Integrate using specific Dynatrace system profile option.
  4. In BlazeMeter (not in a Dynatrace system profile), create new credentials by entering the following key details. You can locate the Environment ID and Token values in the Dynatrace documentation).

    Basic Configuration:

    • Key Name - Name of the key you want to create and reference in BlazeMeter
    • Environment ID -The full URL containing your environment ID (Exclude the trailing / in your URL, for example, http://yourHostAtDynatrace.com).
    • Token - Access token for your DynaTrace environment

    Advanced Configuration:

    • Harbor ID - The ID of the Private Location to use to run the APM functionality (see here for where to get this value).

      If you're using DynaTrace in the cloud, you don't need to provide the Harbour ID. The integration will work seamlessly without it.

  5. Once you've successfully added your key, proceed to the next screen to select your metrics and construct your profile. Here, you can specify your entity type, Dynatrace entity, and the metrics to include in your BlazeMeter report.

  6. After selecting your metrics, click Next to review a preview of what your profile will monitor. Provide a profile name and save it as a new profile for future tests.

  7. Upon saving your profile, you'll see the following screen, allowing you to choose the profile(s) you want. To apply the profile(s) to your test, click Apply.

    Edit_test__13_.png


Your test is now integrated with DynaTrace.

View DynaTrace Metrics in your Timeline Report

To view the metrics from Dynatrace, you can go to the Timeline Report, scroll to the bottom of the available KPIs, and then expand the Dynatrace APM section. You will then see all the metrics you selected listed there and can click the checkboxes to add them to your report, which you can see below:

Execution__29_.png