About Superlog
Superlog is an open-source observability workspace for OpenTelemetry data, aimed at teams debugging production systems. It ingests traces, logs, and metrics, groups noisy signals into incidents, and offers a local-first interface with pluggable investigation runners.
Key features
- 01Ingests OpenTelemetry traces, logs, and metrics
- 02Groups noisy signals into incidents
- 03Provides a local-first debugging workspace
- 04Supports pluggable investigation runners
- 05Includes a web app, API, and OTLP intake proxy
Use cases
- 01Debug production system incidents
- 02Organize incidents from noisy telemetry
- 03Query traces, logs, and metrics
- 04Run a local telemetry debugging workspace
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.superlog.sh/mcpclaude mcp add --transport http sh-superlog-superlog https://api.superlog.sh/mcp{"mcpServers":{"sh-superlog-superlog":{"type":"http","url":"https://api.superlog.sh/mcp"}}}Open in Cursor{"servers":{"sh-superlog-superlog":{"type":"http","url":"https://api.superlog.sh/mcp"}}}Open in VS Code{"mcpServers":{"sh-superlog-superlog":{"type":"http","url":"https://api.superlog.sh/mcp"}}}{"mcpServers":{"sh-superlog-superlog":{"serverUrl":"https://api.superlog.sh/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project README
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.