Skip to main content

LaunchDarkly

CatalogScorecards

Summary

LaunchDarkly is a feature flag management platform. You can use LaunchDarkly to drive insights into values such as:

  • Feature flags

Setup

In order to connect Cortex to your LaunchDarkly instance, you’ll need to create a LaunchDarkly access token with the "Reader" role & "20220603" API version and add it under Settings → LaunchDarkly.

caution

If you do not see the settings page you're looking for, you likely don't have the proper permissions and need to contact your admin.

Feature flag management

Discovery

By default, Cortex will try to "best-guess" the corresponding project in LaunchDarkly based on the key or tags.

Cortex first looks up a LaunchDarkly project using the entity name (e.g. My Service), then the entity identifier (e.g. my-service). For example, if your entity name is “My Service”, then the corresponding LaunchDarkly project's key or tag should contain either “My Service” or "my-service".

If no project was matched, Cortex will try to "best-guess" feature flags from all available projects using feature flag tags.

Entity descriptor

You can find the project key and tags by visiting LaunchDarkly → Account settings → Projects. The URL for the project will contain the key; for example: https://app.launchdarkly.com/settings/projects/<key>/environments.

If you prefer to use the project tags in the registration instead, you can find it in the projects table or project settings page.

x-cortex-launch-darkly:
projects:
- key: project-key
environments: # Optional
- environmentName: prod
- environmentName: staging
alias: alias-1 # alias is optional and only relevant if you have opted into multi account support
- tag: project-tag
environments: # Optional
- environmentName: prod
alias: alias-2 # alias is optional and only relevant if you have opted into multi account support
feature-flags:
- tag: feature-flag-tag
environments: # Optional
- environmentName: staging
alias: alias-3 # alias is optional and only relevant if you have opted into multi account support