Using flag triggers with Dynatrace
Read time: 3 minutes
Last edited: Aug 23, 2024
Overview
This topic explains how to use LaunchDarkly's triggers feature with Dynatrace. For example, you can create an alert in Dynatrace that uses a LaunchDarkly trigger to toggle a flag's targeting on or off when Dynatrace triggers a predefined or custom event.
We recommend specifying a custom Dynatrace alerting profile for your triggers. This ensures that the scope of events that send a webhook to your LaunchDarkly trigger is correct. To learn more about how to create custom alerting profiles, read Dynatrace's documentation on alerting profiles.
To learn more about how Dynatrace uses triggers, read Dynatrace's documentation on webhooks.
Prerequisites
In order to complete this topic, you must meet the following prerequisites:
- You must have a feature flag with a "Dynatrace" trigger type. To learn how to create one, read Creating flag triggers.
- You must have access to the trigger's URL. To learn more about accessing trigger URLs, read Flag trigger security.
- You must have an existing Dynatrace account.
Connect a LaunchDarkly trigger to Dynatrace
In order to configure a LaunchDarkly trigger in Dynatrace, you must perform two steps:
- Create an alerting profile in Dynatrace to determine what Dynatrace events you want associated with your trigger, and
- Create a webhook in Dynatrace that includes a custom JSON template that specifies your trigger URL and alerting profile.
Create a custom alerting profile in Dynatrace
We strongly recommend that you use a custom alerting profile. Alerting profiles specify what Dynatrace event or set of events will invoke the webhook. In the absence of a user-specified alerting profile, Dynatrace's default alerting profile sends a webhook to LaunchDarkly for all Dynatrace events.
To create a custom alerting profile:
- Log in to Dynatrace.
- Create a new alerting profile that filters for the specific events you want to be associated with your LaunchDarkly trigger. To learn more, read Dynatrace's Alerting profiles documentation.
- Give the alerting profile a human-readable Name.
- Click Done in the top right-hand corner of the page.
Create a webhook in Dynatrace with a JSON template
To display event details associated with the invocation of a LaunchDarkly trigger, you must configure a JSON template when you set up the webhook in Dynatrace.
To configure the template:
-
Create a new webhook in Dynatrace. To learn how, read Dynatrace's Webhook integration documentation.
-
Paste the LaunchDarkly trigger URL into the Webhook URL field.
-
Copy this payload into the Custom payload field in Dynatrace:
{"title": "{ProblemTitle}","url": "{ProblemURL}"}
LaunchDarkly uses the payload title
and url
fields to create the main body of trigger audit log entries. If you use a different JSON template than the one provided above, you must include the title
and url
fields or the trigger will not save useful data about the event in the flag's audit log. The url
is the URL of your Dynatrace event.
- Select your pre-configured alerting profile from the Alerting profile menu.
- Click Send test notification. If the integration was successful, a "Custom Integration test successful" message appears.
- Return to the LaunchDarkly flag's Settings page and verify that the test notification has arrived. To do this, click on the trigger's overflow menu confirm that the execution count has incremented.
- Return to Dynatrace and click Save changes.
Your new Dynatrace webhook now triggers flag changes based on the action you specified in LaunchDarkly.
For more granular problem detection and alerting, you may want to explore static thresholds in Dynatrace’s custom alerting settings. To learn more, read Dynatrace's Static thresholds documentation.