xMatters integration

xMatters is a digital service availability platform that prevents technology issues from becoming business problems. With this xMatters integration, Dynatrace actively pushes problem alerts, along with all related metadata, into your xMatters instance. You can acknowledge xMatters alerts and comment on Dynatrace-detected problems via your preferred device. xMatters automatically records your responses in Dynatrace.

You'll need an API key for proper integration of Dynatrace and xMatters. If you don't already have the API key (token), you can generate it in Dynatrace.

Create an API key

To create an API key for your Dynatrace environment

  1. In the Dynatrace menu, go to Settings > Integration > Dynatrace API.
  2. Select Generate token.
  3. Give the token a name.
  4. Set permissions for the token.
  5. Select Generate.

Use this token for secure communication between Dynatrace and xMatters.

Configure xMatters

To set up the integration on the xMatters end

  1. In xMatters, select the Dynatrace integration on the Integrations page.

  2. Enter your Dynatrace API token and Dynatrace Endpoint URL (Dynatrace environment URL).

  3. Select Save.
    After you save, you’ll see the xMatters webhook URL and default payload mapping.

  4. Copy the provided xMatters webhook URL.
    You'll need this URL to complete the integration on the Dynatrace side.

Configure Dynatrace

To set up the integration on the Dynatrace end

  1. In the Dynatrace menu, go to Settings > Integration > Problem notifications.
  2. Select Add notification.
  3. Select xMatters from the available notification types.
  4. Configure the notification:
    • Display name—the freeform name of this integration that will be displayed in Dynatrace on Settings > Integration > Problem notifications when you finish this configuration.
    • xMatters URL—the xMatters webhook URL.
    • optional Additional HTTP headers—custom HTTP header fields such as 'Content-Type' or 'Authorization' that can be used if the target endpoint needs an authentication token within the HTTP header or if you would like to send a different content type such as 'text/plain' or 'application/xml'.
    • Custom payload—once a problem is detected or resolved, this customizable payload is pushed through an HTTP POST to the target system. Use specific placeholders to dynamically populate the payload with problem-related information, such as problem state or title.
    • optional Turn on Accept any SSL certificate option. We recommend that you use a valid SSL certificate (even for internal installations), but you can ignore the certificate for convenience.
    • Assign an Alerting profile.
  5. Select Send test notification to make sure your xMatters integration is working.
  6. Save changes.

After you’ve finished integration with Dynatrace, you’ll see your newly created xMatters integration in your list of integrations.