Skip to content

Add Cloudflare Agents guide to LLM Observability OpenTelemetry instrumentation - #40105

Merged
janine-c merged 3 commits into
masterfrom
kyle.verhoog/docs-llmobs-otel-cloudflare
Sep 28, 2026
Merged

janine-c merged 3 commits into
masterfrom
kyle.verhoog/docs-llmobs-otel-cloudflare

Conversation

@Kyle-Verhoog

@Kyle-Verhoog Kyle-Verhoog commented Sep 21, 2026 •

Copy link
Copy Markdown
Member

What does this PR do? What is the motivation?

Adds a "Using Cloudflare Agents" guide to the LLM Observability OpenTelemetry instrumentation page. Cloudflare Agents on Workers emit GenAI-convention spans, but the export path differs from every other framework on the page: the OTLP endpoint and headers are set on a destination in the Cloudflare dashboard rather than with OTEL_EXPORTER_OTLP_* environment variables. The guide covers enabling tracing in the Worker config, creating the Datadog destination with the dd-otlp-source=llmobs header, and wrapping the Vercel AI SDK with wrapAISDK() so model calls produce chat/invoke_agent spans. Also adds Cloudflare Agents to the Node.js tested-frameworks table.

Validated end-to-end: traces from a Cloudflare Agent land in Agent Observability with model, token usage, and input/output messages populated.

Merge readiness

  • Ready for merge

AI assistance

Drafted with Claude Code after validating the integration end-to-end against a live Cloudflare Agent and Datadog Agent Observability.

…mentation

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

@Kyle-Verhoog
Kyle-Verhoog marked this pull request as ready for review September 28, 2026 14:46
@Kyle-Verhoog
Kyle-Verhoog requested a review from a team as a code owner September 28, 2026 14:46

@janine-c janine-c left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Hey Kyle, looks great! I made some minor formatting changes so the steps you wrote would render as a numbered list, which I think makes it more readable, and a couple other minor formatting changes. I'll go ahead and merge for you when the checks pass 🙂 Thanks for adding this!

@janine-c
janine-c merged commit 79e5972 into master Sep 28, 2026
23 of 24 checks passed
@janine-c
janine-c deleted the kyle.verhoog/docs-llmobs-otel-cloudflare branch September 28, 2026 18:48
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