Website · Code · Skills · Helpers · Discord
About
Superlog is an open-source agentic telemetry system. It ingests traces, logs, and metrics, groups noisy signals into incidents, and watches your infra while you sleep.
Installation
You can install Superlog in your project by using our skills in your favourite coding agent:
Run npx skills add superloglabs/skills --all and use the skills to install Superlog in this project
What is Superlog?
Superlog is an open-core observability workspace for OpenTelemetry data. It ingests traces, logs, and metrics, groups noisy signals into incidents, and gives teams a local-first product surface for debugging production systems.
This repository contains the fully open-source, free community edition:
- Web app and API
- OTLP ingest proxy
- Worker processes for incident grouping and background jobs
- Postgres schema and ClickHouse-backed telemetry queries
- Agent runner interfaces for pluggable investigation runtimes
- A default
communityagent runner that records a local incident summary
We also provide a hosted Superlog Cloud edition with a free tier, a pay-to-go plan and monthly credit packs.
Quick Start
Prerequisites:
- Node.js 20+
- pnpm 9+
- Docker
Install dependencies:
pnpm install
Start the local stack:
docker compose up -d
pnpm --filter @superlog/db db:migrate
pnpm dev
The default local services are:
- Web:
http://localhost:5173 - API:
http://localhost:4100 - OTLP intake:
http://localhost:4101
Development
Run typechecks:
pnpm typecheck
Repository Layout
apps/web- Vite/React frontendapps/api- HTTP APIapps/proxy- OTLP intake proxyapps/worker- background workers and agent orchestrationpackages/db- Drizzle schema and migrationspackages/fingerprint- telemetry fingerprinting helpers
License
Superlog is licensed under the Apache License 2.0.