Using flag triggers with Dynatrace
Read time: 2 minutes
Last edited: Jan 20, 2022
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 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.
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 a new flag trigger.
- You must have access to the trigger's URL. To learn more about accessing trigger URLs, read Understanding flag triggers' security.
- You must have an existing Dynatrace account.
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.
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.
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:
LaunchDarkly uses the payload
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
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 dropdown field.
- 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.