Skip to content

Change Tracking Feature Flags #29934

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 13 commits into
base: master
Choose a base branch
from
Open

Change Tracking Feature Flags #29934

wants to merge 13 commits into from

Conversation

brett0000FF
Copy link
Contributor

@brett0000FF brett0000FF commented Jun 12, 2025

What does this PR do? What is the motivation?

  • Adds a dedicated page for feature flag tracking with Change Tracking.

  • Consolidates/removes existing feature flag tracking info on the Change Tracking landing page.

  • TODO: Update Launchdarkly page in integrations-extras (separate PR)

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

Additional notes

@github-actions github-actions bot added Architecture Everything related to the Doc backend Images Images are added/removed with this PR labels Jun 12, 2025
Copy link
Contributor

github-actions bot commented Jun 12, 2025

📝 Documentation Team Review Required

This pull request requires approval from the @DataDog/documentation team before it can be merged.

Please ensure your changes follow our documentation guidelines and wait for a team member to review and approve your changes.

Copy link
Contributor

Preview links (active after the build_preview check completes)

New or renamed files

Modified Files

@brett0000FF brett0000FF requested a review from aaronvweber June 13, 2025 21:32
@brett0000FF brett0000FF marked this pull request as ready for review June 16, 2025 16:44
@brett0000FF brett0000FF requested a review from a team as a code owner June 16, 2025 16:44
| SQL Server Database Settings Change | [Database Monitoring (DBM)][8], [Correlate Database Monitoring and Traces][10] |
| Kafka Schema Updates | [Data Streams Monitoring (DSM)][9] |
| Manual Kubernetes Deployment Scale Events | Kubernetes Audit Logging |
| Cloud Infrastructure Resource Changes (AWS, Azure, GCP) | [Resource Changes][13] - Enable Resource Collection and optionally cloud provider event forwarding |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@brett0000FF can we denote that this is currently in preview and limited to a small sample of cloud infra resource changes.

Replaced the example request object with the same example from Event Management
1. Create a custom span with the operation name `experiments.IsEnabled` to track feature flag evaluations.
3. Tag the span with `experiment_id:<flag-id>`, where `<flag-id>` matches the feature flag ID.

For example:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @edcheung24 can you review this example snippet for automatic feature flag detection?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good to me, i added a minor comment to keep things consistent with the example above.

@maycmlee
Copy link
Contributor

Created DOCS-11252 for docs review.

@maycmlee maycmlee added the editorial review Waiting on a more in-depth review label Jun 17, 2025
```python
# Trace feature flag evaluation to enable auto-detection
with tracer.trace("experiments.IsEnabled") as span:
span.set_tag("experiment_id", "payment-gateway-flag")

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

perhaps update payment-gateway-flag to fallback_payments_test or vice versa to reflect the example above and to keep it consistent.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great point--thanks!


1. Enable the [LaunchDarkly integration][1] in Datadog.
1. Go to **Flags > `<your-feature-flag-name>` > Settings** in LaunchDarkly.
1. In **Custom properties**, add a tag with key `service` and value `<your-service-name>`, matching your Datadog service name exactly.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should be explicit that in the following example, the Datadog service (DD_SERVICE) is payments_api And after submitting the event, users can navigate to the payments_api service catalog page and be able to see the fallback_payments_test feature flag in the change tracking widget.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Architecture Everything related to the Doc backend editorial review Waiting on a more in-depth review Images Images are added/removed with this PR
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants