• Home
  • Integrations
  • SDKs
  • Guides
  • API docs
No results for ""
EXPAND ALL

EDIT ON GITHUB

Using the SignalFx events integration

Read time: 2 minutes
Last edited: Oct 29, 2021
The SignalFx events integration is a Pro and Enterprise feature

The SignalFx events integration is available to customers on a Pro or Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.

Overview

This topic explains how to use the LaunchDarkly SignalFx integration.

SignalFx can detect and alert engineers when their applications are trending in an unstable direction. In doing so, these engineers will likely want to identify what changed and caused the application to become unstable. One potential cause could be the toggling of a feature flag. The LaunchDarkly SignalFx integration works to streamline this use case by exposing flag change data to SignalFx.

The SignalFx UI with a LaunchDarkly event.
The SignalFx UI with a LaunchDarkly event.

With clear data markers representing feature flag changes, SignalFx users can more easily correlate their feature flag rollouts with changes in operational health.

This integration supports triggers

You can use LaunchDarkly's triggers feature with SignalFx to automatically perform actions on feature flags.

To learn more, read Using triggers with SignalFx.

Prerequisites

To configure the SignalFx integration to send LaunchDarkly data to SignalFx, you must have the following prerequisites:

  • SignalFx access token: This token authenticates your LaunchDarkly account to send data to your SignalFx account. To learn more about about working with SignalFx access tokens, read SignalFx's documentation.
  • SignalFx realm: The realm identifies the self-contained deployment of SignalFx that hosts your organization. Find the name of your organization's realm on your SignalFx profile page.

Configuring the SignalFx integration

Here's how to configure the SignalFx integration:

  1. Navigate to the Integrations page page and find the SignalFx card.
  2. Click Add integration. The integration configuration screen appears.

The SignalFx integration configuration screen.
The SignalFx integration configuration screen.

  1. (Optional) Enter a human-readable Name.
  2. Paste in your SignalFx access token.
  3. Paste in your SignalFx realm.
  4. (Optional) Configure a custom policy to control which flag information LaunchDarkly sends to SignalFx. To learn more about this option, read Advanced configuration.
  5. After reading the Integration Terms and Conditions, check the I have read and agree to the Integration Terms and Conditions checkbox.
  6. Click Save configuration.

When you configure the integration correctly, LaunchDarkly sends flag change data to SignalFx.

Advanced configuration

The "Policy" configuration field allows you to control which kinds of LaunchDarkly events are sent to SignalFx. The default policy value restricts it to flag changes in production environments:

1proj/*:env/production:flag/*

Reasons to override the default policy include wanting to restrict the integration to:

  • a specific combination of LaunchDarkly projects/environments
  • a specific action (or set of actions)

For example, setting the policy configuration to the following will restrict LaunchDarkly such that only changes from the web-app project's production environment are sent to SignalFx:

1proj/web-app:env/production:flag/*

To learn more about setting custom policies, read Policies in custom roles.

Using the integration

After you configure the integration, SignalFx charts are annotated with LaunchDarkly flag changes.

To do this:

  1. Log into your SignalFx account.
  2. On the "Plot Editor" panel, click Add Metric or Event.
  3. Select LaunchDarkly flag changed.
  4. (Optional) Add a filter if you wish to filter by a specific LaunchDarkly attribute such as project or environment.
  5. Click Save to save your chart changes.

SignalFx's "Chart Options" tab also lets you view LaunchDarkly events as small marks or lines. Click on the annotations in your chart to see additional details.

To learn more, read SignalFx's documentation.

The SignalFx UI with LaunchDarkly event details.
The SignalFx UI with LaunchDarkly event details.