Previous

Next

A brief overview of LaunchDarkly.

The LaunchDarkly dashboard configured with the LaunchDarkly flags widget and events integration.

The LaunchDarkly dashboard with a the flag change side panel open.

Overview

LaunchDarkly provides the following integrations with Datadog:

Events integration

The LaunchDarkly events integration for Datadog brings flag event markers to your monitoring dashboards, so you can see the effects of your LaunchDarkly feature deployments on your customer’s services or systems. For instance, if a deployed feature causes a service to slow down, you can see the cause within Datadog.

Feature flag tracking integration

LaunchDarkly’s feature flag tracking integration enriches your RUM data with your feature flags to provide visibility into performance monitoring and behavioral changes. Determine which users are shown a user experience and if it is negatively affecting the user’s performance.

Dashboard widget

LaunchDarkly’s dashboard widget lets you pin a subset feature flag targeting toggles to your Datadog dashboards to monitor and perform a feature go-live from a single window.

Relay proxy metrics integration

If you are using the LaunchDarkly Relay Proxy, you can configure it to export metrics, such as active and cumulative connections, to Datadog.

Setup

Events integration

The LaunchDarkly events integration uses a Datadog API key, which can be created by a Datadog admin. Once you obtain a Datadog API key, see the LaunchDarkly documentation for the Datadog integration to learn how to setup the LaunchDarkly events integration for Datadog.

Feature flag tracking setup

Feature flag tracking is available in the RUM Browser SDK. For detailed set up instructions, visit the Getting started with Feature Flag data in RUM guide.

1. Update your Browser RUM SDK version 4.25.0 or above.
2. Initialize the RUM SDK and configure the enableExperimentalFeatures initialization parameter with ["feature_flags"].
3. Initialize LaunchDarkly’s SDK and create an inspector reporting feature flag evaluations to Datadog using the snippet of code shown below.

const client = LDClient.initialize("<APP_KEY>", "<USER_ID>", {
  inspectors: [
    {
      type: "flag-used",
      name: "dd-inspector",
      method: (key: string, detail: LDClient.LDEvaluationDetail) => {
        datadogRum.addFeatureFlagEvaluation(key, detail.value);
      },
    },
  ],
});

Dashboard widget

1. On the LaunchDarkly integration tile, make sure the LaunchDarkly integration is installed.

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

3. Press the Add Widgets button to expose the widget drawer.

4. Search for LaunchDarkly to find the LaunchDarkly widget in the Apps section of the widget drawer.

5. Click or drag the LaunchDarkly widget icon to add it your your dashboard and open the LaunchDarkly editor modal.

6. Press the Connect button to connect your LaunchDarkly account. A new window opens, prompting you to authorize Datadog.

7. Click Authorize, which should navigate you back to Datadog.

8. Next, 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: An optional Datadog template variable used to override the LaunchDarkly environment option.
   • LaunchDarkly tag filter: An optional + separated list tags used to filter the feature flags displayed in the widget. If multiple tags are included, only flags that match all included tags appear in the widget. If omitted, all of the project’s feature flags appear in the widget.
   • Sort: The order the flags are displayed in the widget. Defaults to Newest.

9. Optionally, give the widget a title.

10. Press Save to finish configuring the Datadog dashboard widget.

Relay Proxy metrics

Follow the Relay Proxy’s Metrics integrations documentation to configure this feature.

Data Collected

Metrics

The LaunchDarkly Relay Proxy can be configured to send the following metrics to Datadog:

• connections: The number of currently existing stream connections from SDKs to the Relay Proxy.
• newconnections: The cumulative number of stream connections that have been made to the Relay Proxy since it started up.
• requests: The cumulative number of requests received by all of the Relay Proxy’s service endpoints (except for the status endpoint) since it started up.

Events

The LaunchDarkly events integration sends flag, project, and environment events from LaunchDarkly to Datadog.

Service Checks

The LaunchDarkly integration does not include any service checks.

Support

Need help? Contact Datadog Support.

Further Reading

Learn more about LaunchDarkly and the Datadog events integration.