[![Last Commit](https://img.shields.io/github/last-commit/superloglabs/superlog?labelColor=333333&color=666666)](https://github.com/superloglabs/superlog/commits/main) [![Commit Activity](https://img.shields.io/github/commit-activity/m/superloglabs/superlog?labelColor=333333&color=666666)](https://github.com/superloglabs/superlog/graphs/commit-activity) [![MCP Toplist](https://mcptoplist.com/badge/sh.superlog%2Fsuperlog.svg)](https://mcptoplist.com/server/sh.superlog%2Fsuperlog) [![Apache 2.0 License](https://img.shields.io/badge/License-Apache_2.0-555555.svg?labelColor=333333&color=666666)](./LICENSE.md)
[![Discord](https://img.shields.io/discord/1511214206123380867?logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/wJ56aRh8hx)

[![Follow @superlogYC on X](https://img.shields.io/twitter/follow/superlogyc?logo=X&color=%23f5f5f5)](https://twitter.com/intent/follow?screen_name=superlogYC)

Website · Code · Skills · Helpers · Discord

## About [Superlog](https://superlog.sh) 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](https://superlog.sh) 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 `community` agent 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: ```bash pnpm install ``` Start the local stack: ```bash 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: ```bash pnpm typecheck ``` ## Repository Layout - `apps/web` - Vite/React frontend - `apps/api` - HTTP API - `apps/proxy` - OTLP intake proxy - `apps/worker` - background workers and agent orchestration - `packages/db` - Drizzle schema and migrations - `packages/fingerprint` - telemetry fingerprinting helpers ## License Superlog is licensed under the [Apache License 2.0](./LICENSE.md).