Using the Datadog dashboard widget

Overview

LaunchDarkly's Datadog dashboard widget lets you pin feature flags to your Datadog dashboards to monitor and toggle flags from within Datadog. This allows you to manage feature releases in individual environments while monitoring your application performance, without needing to switch between applications.

You can use the widget to organize, monitor, and toggle your flags on and off. You can filter flags by attributes such as project, environment, or tags. Additionally, you can employ a Datadog template variable to ensure the contents update with the rest of your Datadog view.

The Datadog dashboard widget uses the same permissions set for an account member's Datadog and LaunchDarkly accounts. When using a shared dashboard, account members can view and edit flags based on their permissions within the LaunchDarkly app.

You cannot use the widget to toggle feature flags in environments that require approval. Instead, click on a flag name to open the flag targeting page within LaunchDarkly and toggle the flag from there.

The toggle is disabled when a flag is in an environment requiring approvals:

Install the Datadog widget

To install the Datadog widget:

1. In Datadog, navigate to the Integrations page.
2. Search for LaunchDarkly or go directly to the LaunchDarkly listing.
3. Click Install.

Add the widget to a dashboard

To add the widget to your dashboard:

1. In Datadog, navigate to an existing dashboard or create a new one.

2. Click Add Widgets. The widget drawer appears.

3. Search for LaunchDarkly.

4. Click or drag the LaunchDarkly widget icon to your dashboard. The LaunchDarkly editor dialog appears.

5. Click Connect. A new window appears prompting you to authorize Datadog.

6. Click Authorize. You are returned to Datadog.

7. Configure the following widget options in the LaunchDarkly editor:

   • LaunchDarkly project: The name of the LaunchDarkly project you wish to associate with the dashboard widget.
   • LaunchDarkly environment: The name of the LaunchDarkly environment you wish to associate with the dashboard widget.
   • Environment template variable (optional): A Datadog template variable that overrides the LaunchDarkly environment option.
   • LaunchDarkly tag filter: An optional + separated list of tags used to filter the feature flags displayed in the widget. If multiple tags are included, only flags that match all included tags will appear. If omitted, all of the project's feature flags will appear.
   • Sort: The order the flags are displayed in the widget. Defaults to Newest.

8. (Optional) Enter a widget a title.

9. Click Save.