|
| 1 | +--- |
| 2 | +title: Unleash |
| 3 | +sidebar_order: 2 |
| 4 | +description: Learn about Sentry's Unleash integrations. |
| 5 | +--- |
| 6 | + |
| 7 | +## Evaluation Tracking |
| 8 | + |
| 9 | +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). |
| 10 | + |
| 11 | +### Set Up Evaluation Tracking |
| 12 | + |
| 13 | +To set up evaluation tracking, visit one of our supported languages pages: |
| 14 | +* [Python](/platforms/python/integrations/feature-flags/unleash/) |
| 15 | + |
| 16 | +## Change Tracking |
| 17 | + |
| 18 | +Sentry can track changes to feature flag definitions and report suspicious feature flag edits. |
| 19 | + |
| 20 | +### Set Up Change Tracking |
| 21 | + |
| 22 | +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. |
| 23 | + |
| 24 | +1. **Click the "Add New Provider" button.** |
| 25 | + - One webhook secret can be registered per provider type. |
| 26 | + - Select Unleash in the dropdown that says "Select a provider". |
| 27 | +2. **Register the webhook URL**. |
| 28 | + - 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. |
| 29 | + - Select the Webhook option. You should be on the `/integrations/create/webhook/` page. |
| 30 | + - Copy the provided Sentry webhook URL in settings and paste it into Unleash within their webhook integration UI. |
| 31 | + - Make sure the integration is toggled to Enabled. |
| 32 | +3. **Set the Signing Secret**. |
| 33 | + - 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. |
| 34 | + - Copy your authorization token from the Unleash UI and paste it into the input box next to "Secret" in Sentry settings. |
| 35 | +4. **Configure your webhook.** |
| 36 | + - Under the Events input box, specify which feature flag events you'd like to send to Sentry. We currently support the following events:  |
| 37 | + - Save the secret by clicking "Add Provider" in Sentry settings. |
| 38 | + - Save the webhook by clicking "Create" in Unleash. |
| 39 | + |
| 40 | +Once saved, Sentry will now accept and authenticate all inbound hooks to your organization's feature flag webhook endpoint. |
0 commit comments