Repository navigation
Releases
Releases · hamin/lotel
lotel 0.1.0
First release: one static binary that ingests OpenTelemetry over HTTP into a
capped DuckDB store and serves a server-rendered UI. Telemetry stays for as
long as you set, then is forgotten on schedule.
Ingest and storage
- OTLP/HTTP ingest of traces, logs and metrics (protobuf and JSON) through
theotlpextension'sotlp_serve, bearer-token authenticated. - Storage in
cappedtables with
per-signal retention (age and size caps); thecapped,otlpandfts
extensions are embedded in the binary, so there is no network dependency
at runtime. - Read queries run on a pool of connections while ingest keeps its own
writer;LOTEL_MEMORY_LIMIT(default 1 GB) andLOTEL_THREADSbound
DuckDB. - A data directory keeps the retention it was created with. If
LOTEL_TTL_*orLOTEL_MAX_BYTESdisagree with it, lotel warns at start
and uses the stored limits.
UI
- Dashboard with signal counts, an error-rate trend and ingest and
storage status. - Logs with live tail, facets (top values under the current filters)
and BM25 full-text search. - Traces with a span waterfall, a p95 trend and a span-duration
histogram. - Metrics charts for gauges and sums, and bucket bars for histograms and
exponential histograms. - Explore: a query builder (datasets, count/percentile computations,
filters, breakdowns), a facets sidebar, an events view, and a read-only
SQL console. - Services: a service map with per-service error and p95 sparklines.
- Storage: what each capped table holds and when it forgets.
- Agents:
/sessionswith per-session timelines,/spend,/toolsand
/setupfor Claude Code, Codex and opencode telemetry, with cross-links to
the matching logs and traces. Prompt and tool content is masked at render
unlessLOTEL_AGENT_SHOW_CONTENT=1. - A theme panel (palette, type, colour scheme, style) that works without
JavaScript; fonts are embedded and served by the binary. - Phone-width layouts.
Operations
lotel --versionprints the version, git SHA and the DuckDB and capped
versions.- Prebuilt binaries for macOS (Apple silicon, Intel) and Linux (x86_64,
arm64) on GitHub Releases, withSHA256SUMS.txt. - Install with
curl -fsSL https://lotel.io/install.sh | sh, Homebrew
(brew install hamin/tap/lotel),cargo binstall lotelor
cargo install lotel. A container image builds withjust docker. - A failed query shows an error and leaves the server usable; it never takes
the UI down. - Test ladder: unit tests,
just smoke, and local stress, soak and agent
stress runs (see docs/load-testing.md). scripts/otlp-gen.py, a dependency-free OTLP traffic generator.