winget install --id=Stivio00.otel-viewer -e otel-viewer is a small OpenTelemetry collector that receives traces, metrics and logs over OTLP/gRPC, stores them in DuckDB and serves a web UI plus a REST query API with a read-only SQL console that automatically charts results. The desktop app bundles the collector, API and UI in a single Tauri window.
Self-hosted OTLP collector with a built-in telemetry viewer: one binary receives traces, metrics and logs over OTLP/gRPC, stores them in embedded DuckDB, and serves a web UI + REST query API. No external services.
OTLP exporters ──gRPC :4317──▶ otel-viewer ──▶ DuckDB
│
HTTP :6666 ┤── REST API (/api/*)
└── web UI (embedded)
Also available as a native desktop app (Tauri 2) — same stack, one window, persistent local database. See src-tauri/README.md.
Docs: (source in docs/).
~/.otel-viewer/dashboards/) with time-range + service/attribute
filters, line/point/bar/histogram/gauge/stat/heatmap panels(i))Main view — traces, logs and metrics side by side with live counters:
Metric detail — per-series line chart plus histogram buckets:
SQL console — auto line chart on the locust.current_users gauge:
Prebuilt binaries for macOS (.dmg) and Windows (.exe installer) are
attached to every release.
Package managers: brew trust stivio00/otel-viewer && brew tap stivio00/otel-viewer && brew install --cask otel-viewer (macOS, custom tap) and winget install Stivio00.otel-viewer (Windows, once the community manifest is merged) — details in the
installation docs.
cargo run -- --seed-demo # UI/API on http://localhost:6666, OTLP on :4317
Point any OTLP/gRPC exporter at localhost:4317. For a ready-made source of
realistic telemetry see locust-test/.
-f, --file DuckDB file (default: in-memory)
-h, --host web UI / REST API (default: localhost:6666)
-o, --otlp OTLP/gRPC receiver (default: 0.0.0.0:4317)
--seed-demo seed demo telemetry when the database is empty
Ports fall back automatically (6666→6670, 4317→4321, then OS-assigned);
actual addresses are in GET /api/health.
docker compose up -d --build # UI on :8080, OTLP on :4317, API on :6666
Details in docs/docker.md; prebuilt images on GHCR
(ghcr.io/stivio00/otel-viewer, ghcr.io/stivio00/otel-viewer-web).
pnpm install && pnpm -C web install
pnpm tauri build # → src-tauri/target/release/bundle/ (app/dmg/nsis)
cargo check && cargo test # rust
pnpm -C web build # web UI (tsc + vite → web/dist)
cargo run -- --seed-demo # collector on :6666
pnpm -C web dev # vite on :5173 (proxies /api → :6666)
See AGENTS.md for repository conventions and gotchas.
| Endpoint | Description |
|---|---|
GET /api/health | status, version, db file, OTLP address |
GET /api/stats | row counts, services, time range |
GET /api/dbstats | DuckDB storage stats (blocks, sizes, memory) |
GET /api/traces / GET /api/traces/{id} | trace list / detail |
GET /api/logs | log list with filters |
GET /api/metrics / GET /api/metrics/{name} | metric summaries / points |
GET /api/services / GET /api/schema | services / schema |
POST /api/query | read-only SQL ({"sql": "..."}) |
POST /api/reset | delete all telemetry data |
Full reference: docs/rest-api.md.
Apache-2.0 — see LICENSE.