# LaunchDarkly | Sentry for Python

##### Currently in Beta

Feature flag change tracking and feature flag evaluation tracking is currently in open beta.

The [LaunchDarkly](https://launchdarkly.com/.md) integration tracks feature flag evaluations produced by the LaunchDarkly SDK. These evaluations are held in memory and are sent to Sentry on error and transaction events. **At the moment, we only support boolean flag evaluations.**

## [Install](https://docs.sentry.io/.md#install)

Install `sentry-sdk` from PyPI with the `launchdarkly` extra.

```bash
pip install "sentry-sdk[launchdarkly]"
```

## [Configure](https://docs.sentry.io/.md#configure)

Add `LaunchDarklyIntegration()` to your `integrations` list:

```python
import sentry_sdk
from sentry_sdk.integrations.launchdarkly import LaunchDarklyIntegration

sentry_sdk.init(
    dsn="https://examplePublicKey@o0.ingest.sentry.io/0",
    # Add data like request headers and IP for users, if applicable;
    # see https://docs.sentry.io/platforms/python/data-management/data-collected/ for more info
    send_default_pii=True,
    integrations=[
        LaunchDarklyIntegration(),
    ],
)
```

## [Verify](https://docs.sentry.io/.md#verify)

The integration is tested by evaluating a feature flag using your LaunchDarkly SDK before capturing an exception.

```python
import ldclient
import sentry_sdk

client = ldclient.get()
client.variation("hello", Context.create("test-context"), False)

sentry_sdk.capture_exception(Exception("Something went wrong!"))
```

Visit the Sentry website and confirm that your error event has recorded the feature flag "hello" and its value "false".

## [Supported Versions](https://docs.sentry.io/.md#supported-versions)

* launchdarkly-server-sdk >= 9.8.0
* sentry-sdk >= 2.19.2
* python >= 3.8

##### 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](https://docs.sentry.io/platforms/python/feature-flags.md#enable-evaluation-tracking) 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](https://docs.sentry.io/platforms/python/feature-flags.md#enable-change-tracking).
