Dynatrace APM
Send monitoring events from Dynatrace to BigPanda.
Supported Versions | Type | Authentication Type |
---|---|---|
SaaS Deployments | Webhook | Org Bearer Token |
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
Tag | Description | Notes |
---|---|---|
ImpactedEntities | Details about the entities impacted by the problem in form of a json array | Not Supported |
ImpactedEntity | Entity impacted by the problem (or 'x impacted entities' when there are multiple) | Primary Property |
PID | Unique system identifier of the reported problem | Incident Identifier |
ProblemDetailsText | All problem event details, including root cause, as a text-formatted string | |
ProblemDetailsJSON | All problem event details including root cause as JSON | |
ProblemID | Display number of the reported problem | |
ProblemImpact | Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE | |
ProblemTitle | Short description of the problem | Secondary Property |
ProblemURL | URL of the problem within Dynatrace |
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 toaws_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
-
In the Dynatrace dashboard, navigate to Settings -> Integration -> Problem notifications and select Add a notification.
-
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:
Please reach out to BigPanda if you do not know your BigPanda org name.x-auth-token: <Your Org Bearer Token> x-app-key: <Your App Key>
- 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]}" }
- Display Name:
-
Enable Call webhook if new events merge into existing problems.
Save and Test
- Optionally assign this definition to an Alerting profile.
- Send a test notification and verify it makes it into your account.
- 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:
- 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.
- 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
- In the left-hand nav of the Dynatrace console, click Settings > Integration > Problem notifications.
- Click the BigPanda webhook and choose delete.
Delete the Integration in BigPanda
Take the following steps to delete the integration from BigPanda:
- In BigPanda, navigate to the Integrations tab and select the desired integration from the list.
- 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.
Updated 2 months ago