From 88182d2dae5fac33c71fe00bcef414ab030b2d9e Mon Sep 17 00:00:00 2001 From: Chris Guidry Date: Tue, 13 Jan 2026 17:00:03 -0500 Subject: [PATCH] Add otel-desktop-viewer to telemetry docs Lightweight single-binary alternative to Jaeger for local development. Co-Authored-By: Claude Opus 4.5 --- docs/servers/telemetry.mdx | 23 +++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/docs/servers/telemetry.mdx b/docs/servers/telemetry.mdx index f0844a18e..663fba19d 100644 --- a/docs/servers/telemetry.mdx +++ b/docs/servers/telemetry.mdx @@ -159,9 +159,28 @@ def greet(name: str) -> str: The SDK must be configured **before** importing FastMCP to ensure the tracer provider is set when FastMCP initializes. -### Local Development with Jaeger +### Local Development -For local trace visualization, run Jaeger: +For quick local trace visualization, [otel-desktop-viewer](https://github.com/CtrlSpice/otel-desktop-viewer) is a lightweight single-binary tool: + +```bash +# macOS +brew install nico-barbas/brew/otel-desktop-viewer + +# Or download from GitHub releases +``` + +Run it alongside your server: + +```bash +# Terminal 1: Start the viewer (UI at http://localhost:8000, OTLP on :4317) +otel-desktop-viewer + +# Terminal 2: Run your server with tracing +opentelemetry-instrument fastmcp run server.py +``` + +For more features, use [Jaeger](https://www.jaegertracing.io/): ```bash docker run -d --name jaeger \