Documentation

Dynatrace

Elevate, May 20-22-2025, Miami Beach, Florida

Monitor and observe your SDK with Dynatrace.

Dynatrace provides real-time monitoring of user interactions, backend services, and infrastructure. Dynatrace supports various environments including cloud, on-premise, and hybrid setups.

Java SDK

Prerequisites

  • Version 17.3 (or later) of the Java SDK

Dynatrace OneAgent

To monitor your application using Dynatrace OneAgent, there is no need to change the SDK.
Follow the steps to install the OneAgent on your host and configure it to monitor your application.
To test an application with Java SDK and OneAgent, you can use the provided example application.

Dynatrace OpenTelemetry

To monitor your application using OpenTelemetry, follow the steps for OpenTelemetry in the Java SDK.

TypeScript SDK

Prerequisites

Include the monitoring package in your SDK

Create a oneagent-tracer.js file in your project to capture and send request and response data to Dynatrace using OpenTelemetry traces and metrics. You can find a sample oneagent-tracer.js file here. For more information on configuring your tracer, check the Dynatrace documentation.
This file uses environment variables that you need to set up according to your commercetools and Dynatrace configurations. Check our example environment file for guidance.
You can use the oneagent-metric.js module, which exposes metric tracking functions, to record specific function values or object properties.
To integrate Dynatrace into your project, use the @commercetools/ts-sdk-apm package with withTelemetryMiddleware() method in your SDK client setup. The following code demonstrates how to implement this middleware in your SDK client.
// Import the @commercetools/ts-sdk-apm package
import { createTelemetryMiddleware } from '@commercetools/ts-sdk-apm'
import { ClientBuilder } from '@commercetools/ts-client'

// Configure the telemetry options
const telemetryOptions = {
  tracer: () => require('./path/to/oneagent-tracer.js'),
  userAgent: 'typescript-sdk-middleware-dynatrace',
  createTelemetryMiddleware,
  customMetrics: {
    newrelic: false,
    datadog: false,
  },
}

// Create the client with the withTelemetryMiddleware() middleware
const client = new ClientBuilder()
  .withClientCredentialsFlow(...)
  .withHttpMiddleware(...)
  .withTelemetryMiddleware(telemetryOptions) // telemetry middleware
  ...
  .build()
For an example of integrating Dynatrace with the TypeScript SDK, refer to the Dynatrace Express example application.

PHP SDK

Prerequisites

  • Version 10.5 (or later) of the PHP SDK

Dynatrace OneAgent

If you want to monitor your application by using Dynatrace OneAgent, then there is no need to change the SDK. To set up your Docker environment, follow the steps in the README file.
To test an application with the PHP SDK and Dynatrace OneAgent, use the provided example application.

.NET SDK

Prerequisites

  • Version 11.0 (or later) of the .NET SDK

Dynatrace OneAgent

If you want to monitor your application by using Dynatrace OneAgent, then there is no need to change the SDK. To install Dynatrace OneAgent on your host and configure it to monitor your application, follow the steps mentioned in Dynatrace's documentation.
To test an application with .NET SDK and Dynatrace OneAgent, use the provided example application.

Dynatrace OpenTelemetry

To monitor your application by using OpenTelemetry, follow the steps for OpenTelemetry in the .NET SDK.

Use the Dynatrace dashboard

You can now send requests in your application to commercetools Composable Commerce through the SDK and monitor the reported data on the Dynatrace visual dashboard.

For more information on using Dynatrace dashboards, consult Use dashboards and other Dynatrace documentation.