Feature Flags
Learn how to attach custom feature flag data to Sentry error events.
Currently in Beta
Feature flag change tracking and feature flag evaluation tracking is currently in open beta.
The Feature Flags integration allows you to manually track feature flag evaluations through an API. These evaluations are held in memory, and in the event an error occurs, sent to Sentry for review and analysis. At the moment, we only support boolean flag evaluations.
Install sentry-sdk from PyPI.
Copied
pip install --upgrade 'sentry-sdk'
Add FeatureFlagsIntegration() to your integrations list:
Copied
import sentry_sdk
from sentry_sdk.integrations.featureflags import FeatureFlagsIntegration
sentry_sdk.init(
dsn="https://examplePublicKey@o0.ingest.sentry.io/0",
integrations=[
FeatureFlagsIntegration(),
],
)
The integration is tested by calling the add_feature_flag API before capturing an exception.
Copied
import sentry_sdk
from sentry_sdk.integrations.featureflags import add_feature_flag
add_feature_flag('test-flag', False)
sentry_sdk.capture_exception(Exception("Something went wrong!"))
Visit the Sentry website and confirm that your error event has recorded the feature flag "test-flag" and its value "false".
Next Steps
- Track feature flag evaluations in other parts of your codebase. If needed, you can set up evaluation tracking for more than one SDK. Read the docs to learn more.
- Set up your change tracking webhook. In order to take full advantage of the feature flag capabilities Sentry offers there is an additional setup step needed. Your feature flag provider needs to notify Sentry when a feature flag definition has changed. A Sentry webhook URL can be registered with your provider. Learn how.
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").