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 reader access token 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