Superlog is an open-source, Apache-2.0 agentic telemetry system that ingests OpenTelemetry traces, logs and metrics, groups noisy signals into incidents, and hands investigation work to pluggable agent runtimes — built for teams that want a local-first observability workspace they can self-host.

What it is

Superlog is an open-core observability workspace for OpenTelemetry data. The repository holds the fully open-source, free community edition, written in TypeScript: a Vite/React web app (apps/web), an HTTP API (apps/api), an OTLP intake proxy (apps/proxy), background workers and agent orchestration (apps/worker), a Drizzle schema and migrations package (packages/db), and telemetry fingerprinting helpers (packages/fingerprint). Telemetry queries are backed by ClickHouse, with Postgres holding the application schema.

The problem it solves is the gap between raw telemetry and an actionable incident. Superlog ingests OTLP traffic, uses fingerprinting to group repeated noisy signals into incidents, and gives teams a local-first product surface for debugging production systems. It also defines agent runner interfaces for pluggable investigation runtimes, so the investigation step is a swappable component rather than a hard-coded pipeline. In practice it replaces the manual triage between a signal arriving and someone deciding whether it matters.

Key capabilities

• Ingests OpenTelemetry traces, logs and metrics through a dedicated OTLP intake proxy (apps/proxy), listening on port 4101 in the local stack.
• Groups noisy signals into incidents rather than presenting an undifferentiated firehose of events.
• Stores telemetry for query through a ClickHouse-backed layer, with a Postgres schema and migrations managed by Drizzle in packages/db.
• Ships telemetry fingerprinting helpers in packages/fingerprint for signal grouping.
• Exposes agent runner interfaces for pluggable investigation runtimes, with a default community agent runner that records a local incident summary.
• Runs background workers for incident grouping and background jobs via apps/worker.
• Ships a skills installer for coding agents: npx skills add superloglabs/skills --all.

Who uses it and how

• Self-hosting teams that want to keep telemetry inside their own infrastructure run the full stack from docker compose, with the web app on 5173, the API on 4100 and OTLP intake on 4101.
• Teams already working inside a coding agent can install Superlog through the superloglabs/skills package instead of wiring the repository by hand.
• Platform and on-call engineers use the incident grouping and agent runner surfaces to turn repetitive production noise into summarised incidents.
• Teams that do not want to operate the stack can use Superlog Cloud, which offers a free tier, a pay-to-go plan and monthly credit packs.

Getting started

Install through a coding agent with npx skills add superloglabs/skills --all, or run the stack manually: pnpm install, then docker compose up -d, pnpm --filter @superlog/db db:migrate, and pnpm dev. Prerequisites are Node.js 20+, pnpm 9+ and Docker.

How it compares

No list of paid products that this project replaces is given in the available facts, and no comparable tools are named either, so Superlog stands alone in this registry on that axis. The one distinction the facts do support is internal: the repository is the free community edition under Apache-2.0, while the hosted Superlog Cloud edition is the commercial counterpart with a free tier, a pay-to-go plan and monthly credit packs.

When to use it — and when not to

A self-hoster takes on Docker, Postgres, ClickHouse-backed telemetry queries, and the worker and migration processes — that is real operational surface, not a single binary. Teams that want zero infrastructure ownership should look at the hosted edition instead of the community repository. The honest limitation is that the default community agent runner only records a local incident summary; richer investigation depends on plugging in another runtime, and the open issue count of 83 suggests an actively churning codebase.

Run npx skills add superloglabs/skills --all and use the skills to install Superlog in this project

pnpm install

docker compose up -d
pnpm --filter @superlog/db db:migrate
pnpm dev

pnpm typecheck