Skip to content

docs: add OpenTelemetry v2 tracing guide - #260

Merged
yassin-berriai merged 1 commit into
mainfrom
claude/charming-sagan-NxzfK
May 30, 2026
Merged

docs: add OpenTelemetry v2 tracing guide#260
yassin-berriai merged 1 commit into
mainfrom
claude/charming-sagan-NxzfK

Conversation

@yassin-berriai

Copy link
Copy Markdown
Contributor

Summary

Adds a user-facing documentation page for the opt-in OpenTelemetry v2 instrumentation introduced in BerriAI/litellm#28909.

The new page (docs/observability/opentelemetry_v2.md) is written for LiteLLM users and kept simple and example-driven, covering:

  • What it offers — one trace per request (HTTP → auth → guardrails → LLM call → DB writes), GenAI-semconv attributes, vendor presets, content-safe defaults.
  • Requirements — the extra opentelemetry-instrumentation-fastapi package.
  • Getting started — enabling with LITELLM_OTEL_V2=true and sending to any OTLP collector (HTTP/gRPC/console tabs).
  • Vendor presets — copy-paste config + env vars for Arize, Phoenix, Langfuse, Weave, Langtrace, Levo, and AgentOps.
  • Capturing prompts/responses — off by default, opt-in via OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT.
  • Excluded routes, multi-tenant per-key destinations, distributed tracing, a config reference table, and troubleshooting.

Also adds a short cross-link admonition from the existing OpenTelemetry doc so users discover v2.

The Observability sidebar is autogenerated from the docs/observability directory, so the new page is picked up automatically — no sidebars.js change needed.

Notes

  • Examples and env-var names were derived directly from the implementation in PR #28909 (presets, config.py, mount.py).
  • This documents an in-progress feature; the upstream PR is not yet merged.

https://claude.ai/code/session_01Udn22qopa89uH2b6jQbngU


Generated by Claude Code

Add a user-facing guide for the opt-in OTel v2 instrumentation: what it
offers, how to enable it (LITELLM_OTEL_V2), generic OTLP setup, vendor
presets (Arize, Phoenix, Langfuse, Weave, Langtrace, Levo, AgentOps),
content-capture control, excluded routes, and a config reference. Also
cross-link it from the existing OpenTelemetry doc.
@vercel

vercel Bot commented May 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
litellm Ready Ready Preview, Comment May 30, 2026 6:06am

Request Review

@yassin-berriai
yassin-berriai merged commit 5ccb3ad into main May 30, 2026
2 checks passed
@yassin-berriai
yassin-berriai deleted the claude/charming-sagan-NxzfK branch May 30, 2026 06:13
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.

3 participants