No results for ""
EXPAND ALL
  • Home
  • API docs

GIVE DOCS FEEDBACK

Using flag triggers with Dynatrace

Read time: 3 minutes
Last edited: Sep 29, 2023
Flag triggers is an Enterprise feature

Flag triggers is available to customers on an Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.

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 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.

Connecting a LaunchDarkly trigger to Dynatrace

In order to configure a LaunchDarkly trigger in Dynatrace, you must perform two steps:

  1. Create an alerting profile in Dynatrace to determine what Dynatrace events you want associated with your trigger, and
  2. Create a webhook in Dynatrace that includes a custom JSON template that specifies your trigger URL and alerting profile.

Creating a custom alerting profile in Dynatrace

Create a custom alerting profile in Dynatrace to associate with your trigger

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:

  1. Log in to Dynatrace.
  2. 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.
  3. Give the alerting profile a human-readable Name.
  4. Click Done in the top right-hand corner of the page.

Creating 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:

  1. Create a new webhook in Dynatrace. To learn how, read Dynatrace's Webhook integration documentation.

  2. Paste the LaunchDarkly trigger URL into the Webhook URL field.

  3. Copy this payload into the Custom payload field in Dynatrace:

    {
    "title": "{ProblemTitle}",
    "url": "{ProblemURL}"
    }
You must customize the payload to render LaunchDarkly audit logs correctly

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.

  1. Select your pre-configured alerting profile from the Alerting profile menu.
  2. Click Send test notification. If the integration was successful, a "Custom Integration test successful" message appears.
  3. 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.
  4. 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.