Skip to content

[FFL-2449] Add server-side flag evaluation metrics documentation#37257

Open
vjfridge wants to merge 12 commits into
masterfrom
vickie/FFL-2449-server-flag-eval-metrics-docs
Open

[FFL-2449] Add server-side flag evaluation metrics documentation#37257
vjfridge wants to merge 12 commits into
masterfrom
vickie/FFL-2449-server-flag-eval-metrics-docs

Conversation

@vjfridge
Copy link
Copy Markdown
Contributor

@vjfridge vjfridge commented Jun 4, 2026

What does this PR do? What is the motivation?

Fixes FFL-2449

Adds public documentation for setting up server-side flag evaluation metrics, which were previously undocumented beyond a one-liner env var mention. The setup requires enabling the Datadog Agent OTLP receiver and pointing the application at it — neither of which existed in any public docs.

Changes

  • New guide page feature_flags/guide/server_flag_evaluation_metrics — step-by-step setup for Agent OTLP receiver, application env vars, metric verification, Historical Metrics retention, and a dashboard query reference. Includes a minimum tracer version table per SDK and marks feature_flag.evaluations as experimental.
  • New concepts page feature_flags/concepts/flag_graphs — describes the graphs on the flags list page and flag details page (targeting rule distribution, server evaluations, client evaluations, errors/latency, export to dashboard) for both client and server SDKs.
  • Updated feature_flags/server/_index.md — existing DD_METRICS_OTEL_ENABLED alert updated to note the metric is experimental and link to the new guide.
  • Updated getting_started/feature_flags/_index.md — Step 5 now references the new metrics guide for server-side apps.
  • Updated feature_flags/guide/_index.md and feature_flags/concepts/_index.md — new pages added to navigation indexes.
  • All 6 server SDK pages (dotnet, go, java, nodejs, python, ruby) — added experimental warning alert next to the DD_METRICS_OTEL_ENABLED env var.

Merge instructions

Merge readiness:

  • Ready for merge

vjfridge and others added 5 commits June 4, 2026 09:47
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
… metrics guide

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…rver SDK pages

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@vjfridge vjfridge requested a review from a team as a code owner June 4, 2026 14:02
@vjfridge
Copy link
Copy Markdown
Contributor Author

vjfridge commented Jun 4, 2026

@codex review

@github-actions github-actions Bot added the Guide Content impacting a guide label Jun 4, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7b42c572b5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread content/en/feature_flags/concepts/flag_graphs.md Outdated
@@ -0,0 +1,146 @@
---
title: Set Up Server-Side Flag Evaluation Metrics
Copy link
Copy Markdown
Contributor Author

@vjfridge vjfridge Jun 4, 2026

Choose a reason for hiding this comment

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

@@ -0,0 +1,72 @@
---
title: Feature Flag Graphs
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added the Images Images are added/removed with this PR label Jun 4, 2026
@@ -8,6 +8,9 @@ further_reading:
- link: "/remote_configuration/"
tag: "Documentation"
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

vjfridge and others added 2 commits June 4, 2026 12:55
…ng links

Remove DD_METRICS_OTEL_ENABLED from all server SDK pages and replace with
comments pointing to the setup guide, matching the _index.md pattern. Add
further_reading links to server_flag_evaluation_metrics and flag_graphs on
all SDK pages.

Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
@@ -8,6 +8,12 @@ further_reading:
- link: "/tracing/trace_collection/dd_libraries/dotnet-core/"
tag: "Documentation"
text: ".NET Tracing"
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@@ -8,6 +8,12 @@ further_reading:
- link: "/tracing/trace_collection/dd_libraries/go/"
tag: "Documentation"
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@@ -8,10 +8,18 @@ further_reading:
- link: "/tracing/trace_collection/automatic_instrumentation/dd_libraries/java/"
tag: "Documentation"
text: "Java APM and Distributed Tracing"
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@@ -11,6 +11,12 @@ further_reading:
- link: "/tracing/"
tag: "Documentation"
text: "Learn about Application Performance Monitoring (APM)"
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@@ -8,6 +8,12 @@ further_reading:
- link: "/tracing/trace_collection/dd_libraries/python/"
tag: "Documentation"
text: "Python Tracing"
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@@ -11,6 +11,12 @@ further_reading:
- link: "/tracing/"
tag: "Documentation"
text: "Learn about Application Performance Monitoring (APM)"
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

@OliviaShoup OliviaShoup added the editorial review Waiting on a more in-depth review label Jun 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

editorial review Waiting on a more in-depth review Guide Content impacting a guide Images Images are added/removed with this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants