Tiny, standards-based telemetry tool, built from first principles
"Imperative for user, declarative for agent."
Warning
Still in heavy development — not ready for production use.
Why Tiny Telemetry exists
Tiny Telemetry is a thin layer that ingests telemetry/analytics, stores them in DuckDB, and exposes a read-only HTTP API queryable by AI agents and scripts. A TUI dashboard (tiny-telemetry-tui) is included for humans, organized into pages (Logs, Metrics, Analytics) with switchable views within each page.
Design principles:
- Standards first — built on OpenTelemetry standards by default
- Zero friction — drop the binary, pipe your output, done
- Agent-first — the HTTP API is the primary read surface, designed for autonomous programmatic access
- Minimal by intent — keep only essential ingestion, storage, and query surfaces
- No noise — no heavy platform layers, no observability-suite sprawl
- Single source of truth — all state lives in DuckDB, no caches, no secondary stores
- Thin by design — easy to extend with new inputs or read surfaces because there's almost nothing in the way
Architecture
Input Plugins Processing Storage Read Surfaces
───────────── ────────────── ───────────── ─────────────────
HTTP:4000 ──┐ ┌─ Processor ─┐ ┌───────────┐ ┌─ HTTP API
├──→ │ + parser │──→ │ DuckDB │──→ │ (agents, scripts)
stdin ──┘ │ │ │ │ └──────────────
↑ └─────────────┘ │ │ ┌─ Socket RPC
│ ↓ │ │──→ │ (tiny-telemetry-tui)
SourceMux InsertBuffer │ │ └──────────────
(batch append) └───────────┘
Themes
Tiny Telemetry ships with 12 color themes:
Available: tiny-telemetry-dark, tiny-telemetry-light, dracula, github-light, gruvbox, matrix, monokai, nord, solarized-dark, solarized-light, spring, vs-code-light.
Screenshots
License
See LICENSE for details.