LaunchDarkly Source
Source Info
- The LaunchDarkly Source is an Event Cloud source. This means that it sends data as events, which are behaviors or occurrences tied to a user and a point in time. Data from these sources can be loaded into your Segment warehouses, and also sent to Segment streaming destinations. Learn more about cloud sources.
- This integration is partner owned. Please reach out to the partner's support for any issues.
This Source is supported in US data processing regions.
This Source is only supported in workspaces configured to process data in the US region. Workspaces configured with data processing regions outside of the US cannot connect to this source. For more information, see Regional Segment.
LaunchDarkly is a feature management platform that empowers development teams to safely deliver and control software through feature flags.
This source is maintained by LaunchDarkly. For any issues with the source, contact the LaunchDarkly Support team.
- From your Segment UI's Sources page click on Add Source.
- Search for "LaunchDarkly" within the Sources Catalog and confirm by clicking Connect.
- Give the Source a nickname and follow the set up flow to add your source. The nickname will be used to designate the source in the Segment interface, and Segment will create a related schema name. The schema name is the namespace you'll be querying against in your warehouse. The nickname can be whatever you like, but we recommend sticking to something that reflects the source itself and distinguishes amongst your environments (for example, LaunchDarkly_Prod, LaunchDarkly_Staging, LaunchDarkly_Dev).
- Copy the Write key from the Segment UI and log in to your LaunchDarkly account. Navigate to Integrations > Data Export Destinations.
- Select Add destination and select "Segment" in the dropdown menu.
- Choose a name for the destination and the LaunchDarkly environment for which events will be forwarded to Segment
- Paste the Segment key into the "Write Key" textbox.
- Click Save Destination.
The following table lists events that LaunchDarkly sends to Segment. These events will show up as tables in your warehouse, and as regular events in your other Destinations. LaunchDarkly will send through the userId if available.
| Event name | Description |
|---|---|
| feature | A feature flag has been evaluated |
| click | A user clicked on a CSS selector for which they have configured a LaunchDarkly experimentation goal |
| Page | A user has loaded a page which is associated with a LaunchDarkly experimentation goal |
| Custom | A custom event was sent by the LaunchDarkly SDK |
The following tables outline the properties included in the events listed above.
| Property name | Description |
|---|---|
| event | event type |
| Common Properties | Properties common to all events. types |
| environment | The LaunchDarkly environment ID corresponding to event |
| project | The LaunchDarkly project ID corresponding to the event |
| key | The flag key corresponding to the event. In the case of experimentation events, this will be the goal key for the experiment. |
| Feature Request Event Properties | |
| value | The value the flag evaluated to |
| flagVersion | The version of the flag when it was evaluated |
| reasonKind | The evaluation reason for the flag. |
| prereqOf | Set to another flag's key if this flag evaluation was only performed in order to determine whether the prerequisite values were met for the indicated flag. See flag prerequisites. |
| default | Indicates whether the flag value was the result of the default variation being selected |
| variation | The variation of the flag requested. Flag variation values are stored in an array. This value corresponds to the index of the variation the array. Boolean flags show as 0 or 1 for true and false, and other flag types are numbered starting with 0 for their different variations. |
| Page View Event Properties | |
| url | The URL the user was on when the flag was evaluated |
| Click Event Properties | |
| url | The URL the user was on when the flag was evaluated |
| selector | Contains the CSS selector corresponding to the click event |
| Custom Event Properties | Custom Events have no additional properties besides the common properties. |
Now that your source is set up, you can connect it to destinations.
Log in to your downstream tools and check to see that your events are populating and they contains all the properties you expect. If all your events and properties are not showing up, refer to the relevant destination docs for troubleshooting.
If you experience any issues with how the events arrive in Segment, contact the LaunchDarkly team.