Skip to content

docs: expand Datadog observability guides - #1014

Open
danehans wants to merge 22 commits into
agentgateway:mainfrom
danehans:datadog-observability-docs
Open

docs: expand Datadog observability guides#1014
danehans wants to merge 22 commits into
agentgateway:mainfrom
danehans:datadog-observability-docs

Conversation

@danehans

@danehans danehans commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator

Company

Not applicable. This change expands the existing Datadog documentation.

Contribution summary

  • Add complete standalone and Kubernetes Datadog observability workflows while preserving the direct trace-only setup.
  • Document metrics, dashboard import, LLM trace verification, compatibility, cleanup, and troubleshooting.
  • Add Datadog UI screenshots and link the LLM observability indexes to the guides.
  • Share common content across the main and latest versions.

This PR depends on agentgateway/agentgateway#3259 for the referenced runnable examples and dashboard.

Related to agentgateway/agentgateway#3230.

Checklist

Logo file

  • Not applicable; no company logo is added.

Listing

  • Not applicable; no contributor listing is changed.

Preview

  • make build
  • Reviewed the rendered standalone guide and both Datadog screenshots locally.

danehans and others added 20 commits September 2, 2026 12:58
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
Signed-off-by: Daneyon Hansen <daneyon.hansen@solo.io>
The alias edits conflicted with main, which already carries both aliases
with a trailing slash and with the comments explaining why they must be
version-scoped. The otel-stack tabs normalization is correct but unrelated.
All three want their own PR; the diff is saved in unrelated-changes.patch.

Signed-off-by: Kristin Brown <kristin.brown@solo.io>
Signed-off-by: Kristin Brown <kristin.brown@solo.io>
@kristin-kronstain-brown

Copy link
Copy Markdown
Collaborator

Need to wait to merge this until agentgateway/agentgateway#3259 merges.

- Scope the shared verify snippet to LLM traces, which both setups export.
  The metrics and dashboard steps now sit inside each page's complete-example
  procedure, so the direct-export path no longer tells readers to search for
  metrics it does not collect or to filter by an env tag only the example sets.
- Restore the proxy and LLM-provider prerequisites on the Kubernetes page,
  which the direct-export policy depends on, and add the loopback ports both
  examples need.
- Note that the examples pin the versions they were tested against, so a
  reader on a newer release knows to check before running them.
- Use the policy, namespace, and product-name snippets instead of hardcoding
  agentgatewaypolicy and agentgateway-system; the enterprise build overrides
  the policy snippet and rendered the wrong kind.
- Update the Kubernetes wrapper descriptions to match the expanded body and
  mark them test: skip, matching the standalone wrappers.
- Fold trailing explanations into the steps they belong to, and collapse the
  paired reuse-image/reuse-image-dark calls to a single reuse-image, since
  both pointed at the same asset.
- Fix "For a complete ... metrics" in the four llm-observability indexes.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Signed-off-by: Kristin Brown <kristin.brown@solo.io>
I removed this as unrelated in c1ee21c and was wrong: the extras
tab-syntax spec scans the whole source tree, and these two files hold the
last 'tabTotal='/'items='/'tabName=' violations. Reverting them turned
"Static + content checks" red. The fix belongs in this PR after all.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Signed-off-by: Kristin Brown <kristin.brown@solo.io>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants