diff --git a/docs/organization/integrations/feature-flag/index.mdx b/docs/organization/integrations/feature-flag/index.mdx index ac8f10b752267..231f7596a4609 100644 --- a/docs/organization/integrations/feature-flag/index.mdx +++ b/docs/organization/integrations/feature-flag/index.mdx @@ -7,3 +7,4 @@ description: "Learn more about Sentry's feature flag integrations." - [LaunchDarkly](/organization/integrations/feature-flag/launchdarkly/) - [Generic](/organization/integrations/feature-flag/generic/) - [Split](/organization/integrations/feature-flag/split/) +- [Unleash](/organization/integrations/feature-flag/unleash/) diff --git a/docs/organization/integrations/feature-flag/launchdarkly/img/ff-integration-ui.png b/docs/organization/integrations/feature-flag/launchdarkly/img/ff-integration-ui.png deleted file mode 100644 index faddb9def476a..0000000000000 Binary files a/docs/organization/integrations/feature-flag/launchdarkly/img/ff-integration-ui.png and /dev/null differ diff --git a/docs/organization/integrations/feature-flag/split/index.mdx b/docs/organization/integrations/feature-flag/split/index.mdx index 284f464774285..8c6de468d477a 100644 --- a/docs/organization/integrations/feature-flag/split/index.mdx +++ b/docs/organization/integrations/feature-flag/split/index.mdx @@ -1,6 +1,6 @@ --- title: Split -sidebar_order: 1 +sidebar_order: 4 description: "Learn more about Sentry's Split integration, which allows you to use Sentry data in your Split analyses." --- diff --git a/docs/organization/integrations/feature-flag/unleash/img/unleash-events.png b/docs/organization/integrations/feature-flag/unleash/img/unleash-events.png new file mode 100644 index 0000000000000..82ebf8bf846ea Binary files /dev/null and b/docs/organization/integrations/feature-flag/unleash/img/unleash-events.png differ diff --git a/docs/organization/integrations/feature-flag/unleash/index.mdx b/docs/organization/integrations/feature-flag/unleash/index.mdx new file mode 100644 index 0000000000000..f0168cb9b52cb --- /dev/null +++ b/docs/organization/integrations/feature-flag/unleash/index.mdx @@ -0,0 +1,40 @@ +--- +title: Unleash +sidebar_order: 2 +description: Learn about Sentry's Unleash integrations. +--- + +## Evaluation Tracking + +Sentry can track flag evaluations as they happen within your application. Flag evaluations will appear in the "Feature Flag" section of the Issue Details page as a table, with "suspect" flag predictions highlighted in yellow. Learn more about how to interact with feature flag insights within the Sentry UI by reading the [Issue Details page documentation](/product/issues/issue-details/#feature-flags). + +### Set Up Evaluation Tracking + +To set up evaluation tracking, visit one of our supported languages pages: +* [Python](/platforms/python/integrations/feature-flags/unleash/) + +## Change Tracking + +Sentry can track changes to feature flag definitions and report suspicious feature flag edits. + +### Set Up Change Tracking + +Enabling Change Tracking is a three-step process. To get started visit the [feature-flags settings page](https://sentry.io/orgredirect/organizations/:orgslug/settings/feature-flags) in a new tab. Then follow the steps listed below. + +1. **Click the "Add New Provider" button.** + - One webhook secret can be registered per provider type. + - Select Unleash in the dropdown that says "Select a provider". +2. **Register the webhook URL**. + - Go to your Unleash homepage and navigate to the `/integrations/` page, which can be found by clicking Integrations on the left-hand sidebar navigation, under the Configure heading. + - Select the Webhook option. You should be on the `/integrations/create/webhook/` page. + - Copy the provided Sentry webhook URL in settings and paste it into Unleash within their webhook integration UI. + - Make sure the integration is toggled to Enabled. +3. **Set the Signing Secret**. + - In the Unleash webhook UI, under the Authorization input box, type in any 32-character string to use as your authorization token ("secret"). Keep this string safe and note it down somewhere in case you need it in the future; Unleash will not show you the token once you save the webhook. We recommend not using any sensitive tokens. + - Copy your authorization token from the Unleash UI and paste it into the input box next to "Secret" in Sentry settings. +4. **Configure your webhook.** + - Under the Events input box, specify which feature flag events you'd like to send to Sentry. We currently support the following events: ![Supported Unleash events](./img/unleash-events.png) + - Save the secret by clicking "Add Provider" in Sentry settings. + - Save the webhook by clicking "Create" in Unleash. + +Once saved, Sentry will now accept and authenticate all inbound hooks to your organization's feature flag webhook endpoint. diff --git a/docs/platforms/python/feature-flags/index.mdx b/docs/platforms/python/feature-flags/index.mdx index 51f9f778362bd..3877517130fb9 100644 --- a/docs/platforms/python/feature-flags/index.mdx +++ b/docs/platforms/python/feature-flags/index.mdx @@ -16,6 +16,7 @@ Evaluation tracking requires enabling an SDK integration. Integrations are provi - [OpenFeature](/platforms/python/integrations/feature-flags/openfeature/) - [LaunchDarkly](/platforms/python/integrations/feature-flags/launchdarkly/) +- [Unleash](/platforms/python/integrations/feature-flags/unleash/) - [Generic](/platforms/python/integrations/feature-flags/generic/)