Dynatrace APM

The Dynatrace APM integration configures the Webhooks integration feature for problem notifications (referred to as alerts in this document). A BigPanda URL endpoint is added, which prompts Dynatrace to forward all relevant alert information to BigPanda. BigPanda then processes and correlates the alert data from Dynatrace to create and maintain up-to-date incidents in BigPanda.

👍

Open Integration Manager

The Open Integration Manager is available for use with Dynatrace APM. For more information, see the Open Integration Manager documentation.

❗️

Payload Size

Alert payloads must be 6MB or smaller. Larger payloads will fail to process with BigPanda. We recommend reviewing your configurations to ensure that only actionable, useful information is being sent to BigPanda.

Key Features

• Uses the Dynatrace Webhooks integration feature to forward alerts to BigPanda.
• Correlates alerts into incidents to help you understand and respond faster to production issues.
• Automatically opens and resolves alerts based on the state of the notification.
• Supports custom tags through the tags attribute of an alert.

Dynatrace Data Model

BigPanda normalizes alert data from Dynatrace into tags. You can use tag values to filter the incident feed and to define filter conditions for Environments. The primary and secondary properties are also used during the correlation process.

❗️

Dynatrace Timestamps

Dynatrace alert timestamps in BigPanda are generated from the rankedEvents section of the Dynatrace payload, if available. OK alerts use the latest end time and all other alerts use the latest start time. If neither the start or end time is populated, BigPanda will use the current time.

Standard Tags

📘

Custom Tag Normalization

BigPanda will automatically normalize custom tag names received from Dynatrace to ensure that they meet our Enrichment Tag Naming Requirements. This involves converting all letters to lower-case, replacing any special characters with an underscore (_), and trimming any non-letter characters from the start of the tag name.

For example, [AWS]Services will be normalized to aws_services.

Install the Integration

Create an App Key

Create an app key in BigPanda.

👍

Integration Specific

You'll need a separate app key for each integrated system.

Configure BigPanda Webhook

1. In the Dynatrace dashboard, navigate to Settings -> Integration -> Problem notifications and select Add a notification.

2. Choose Custom Integration and configure the webhook details as follows:

   • Display Name: BigPanda
   • Webhook URL: https://integrations.bigpanda.io/dynatrace_v2/alerts
   • Additional HTTP Headers: Add the following header values:

     x-auth-token: <Your Org Bearer Token>
     x-app-key: <Your App Key>
     
     

     Please reach out to BigPanda if you do not know your BigPanda org name.
   • Custom Payload: Enter the following payload:

      {
          "ImpactedEntity": "{ImpactedEntity}",
          "PID": "{PID}",
          "ProblemDetails": "{ProblemDetailsText}",
          "ProblemDetailsJSON": {ProblemDetailsJSON},
          "ProblemID": "{ProblemID}",
          "ProblemImpact": "{ProblemImpact}",
          "ProblemSeverity": "{ProblemSeverity}",
          "ProblemTitle": "{ProblemTitle}",
          "ProblemURL": "{ProblemURL}",
          "State": "{State}",
          "Tags": "{Tags}",
          "CustomTagName1":"{Tags[dyntrace_tag_name]}",
          "CustomTagName2":"{Tags[additional_dt_tag_name]}"
      }
     

3. Enable Call webhook if new events merge into existing problems.

Save and Test

1. Optionally assign this definition to an Alerting profile.
2. Send a test notification and verify it makes it into your account.
3. Click Save

Delete the Integration

Deleting an integration requires that you remove the integration in both the integrated system and BigPanda. We recommend that you first uninstall the integration on the integrated system to prevent traffic from being sent and rejected by BigPanda, since the app key will not exist once you delete the integration in BigPanda.

❗️

Caution During Replacement

When replacing an existing integration with a new tool or system, we recommend configuring the new integration first to ensure no data is lost.

Deactivate Inbound Integration

If you want to stop sending data to BigPanda but don’t want to delete your integration, you can temporarily deactivate it.

To deactivate an inbound integration:

1. In BigPanda, navigate to the Integrations tab and select the desired integration from the list. This will open integration details on the right side of the window.
2. At the top of the integration details, click the Active/Inactive toggle next to the application name to change the status of the integration.

In the integrations list, inactive integrations will be marked with a gray bar.

Stop Sending Data to BigPanda

1. In the left-hand nav of the Dynatrace console, click Settings > Integration > Problem notifications.
2. Click the BigPanda webhook and choose delete.

Delete the Integration in BigPanda

Take the following steps to delete the integration from BigPanda:

1. In BigPanda, navigate to the Integrations tab and select the desired integration from the list.
2. In the integration details on the right of the page, click the trash icon, then confirm you want to delete the integration. The integration will be removed immediately.

👍

️Automatic Alert Resolution for Deleted Integrations

All active alerts from the integration will be resolved after deletion.

❗️

Data Removal

This procedure does not remove any data from the integrated system.