feat(flags): Add OpenFeature and LaunchDarkly integration documentation (#11675)

Adds OpenFeature and LaunchDarkly integration documentation.

---------

Co-authored-by: Alex Krawiec <[email protected]>
Co-authored-by: Anton Pirker <[email protected]>

Author: 3 people

docs/platforms/python/integrations/index.mdx

@@ -59,6 +59,13 @@ The Sentry SDK uses integrations to hook into the functionality of popular libra
 | <LinkWithPlatformIcon platform="python.rq"       label="RQ"             url="/platforms/python/integrations/rq" />       |        ✓         |
 | <LinkWithPlatformIcon platform="python.ray"      label="Ray"            url="/platforms/python/integrations/ray" />      |                  |
 
+## Feature Flags
+
+|                                                                                                                         | **Auto-enabled** |
+| ----------------------------------------------------------------------------------------------------------------------- | :--------------: |
+| <LinkWithPlatformIcon platform="launchdarkly" label="LaunchDarkly" url="/platforms/python/integrations/launchdarkly" /> |                  |
+| <LinkWithPlatformIcon platform="openfeature"  label="OpenFeature"  url="/platforms/python/integrations/openfeature" />  |                  |
+
 ### Cloud Computing
 
 |                                                                                                                                                          | **Auto-enabled** |

docs/platforms/python/integrations/launchdarkly/index.mdx

@@ -0,0 +1,46 @@
+---
+title: LaunchDarkly
+description: "Learn about the LaunchDarkly integration and how to add it to your integrations list."
+---
+
+The [LaunchDarkly](https://launchdarkly.com/) integration tracks feature flag evaluations produced by the LaunchDarkly SDK. These evaluations are held in memory and, in the event an error occurs, sent to Sentry for review and analysis.
+
+## Install
+
+Install `sentry-sdk` from PyPI.
+
+```bash
+pip install --upgrade 'sentry-sdk'
+```
+
+## Configure
+
+Add `LaunchDarklyIntegration()` to your `integrations` list:
+
+```python
+import sentry_sdk
+from sentry_sdk.integrations.launchdarkly import LaunchDarklyIntegration
+
+sentry_sdk.init(
+    dsn="___PUBLIC_DSN___",
+    integrations=[
+        LaunchDarklyIntegration(),
+    ],
+)
+```
+
+## 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".

docs/platforms/python/integrations/openfeature/index.mdx

@@ -0,0 +1,46 @@
+---
+title: OpenFeature
+description: "Learn about the OpenFeature integration and how to add it to your integrations list."
+---
+
+The [OpenFeature](https://openfeature.dev/) integration tracks feature flag evaluations produced by the OpenFeature SDK. These evaluations are held in memory and, in the event an error occurs, sent to Sentry for review and analysis.
+
+## Install
+
+Install `sentry-sdk` from PyPI.
+
+```bash
+pip install --upgrade 'sentry-sdk'
+```
+
+## Configure
+
+Add `OpenFeatureIntegration()` to your `integrations` list:
+
+```python
+import sentry_sdk
+from sentry_sdk.integrations.OpenFeature import OpenFeatureIntegration
+
+sentry_sdk.init(
+    dsn="___PUBLIC_DSN___",
+    integrations=[
+        OpenFeatureIntegration(),
+    ],
+)
+```
+
+## Verify
+
+The integration is tested by evaluating a feature flag using your OpenFeature SDK before capturing an exception.
+
+```python
+from openfeature import api
+import sentry_sdk
+
+client = api.get_client()
+client.get_boolean_value("hello", default_value=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".

docs/product/issues/issue-details/img/feature-flags.png

@@ -102,6 +102,23 @@ If you’ve enabled [Session Replay](/product/explore/session-replay/), you’ll
 
 ![Session Replay](./img/issue-replay.png)
 
+## Feature Flags
+If you’ve enabled a feature flag integration you’ll have access to the feature flag table (if any are associated with the event). The table displays the list of flags and their evaluation result prior to encountering an error.
+
+![Feature Flags](./img/feature-flags.png)
+
+A timeline of suspect flags is also available if you're using one of our support service providers.  A Sentry web hook can be registered with the following providers:
+
+- LaunchDarkly
+
+To enable the suspect flags timeline please visit this page.  TODO!
+
+![Feature Flags](./img/suspect-flags-timeline.png)
+
+Suspect flags are displayed in the table with a yellow highlight.
+
+![Feature Flags](./img/suspect-flags-table.png)
+
 ## Breadcrumbs
 
 ![Breadcrumbs](./img/issue-breadcrumbs.png)