
<a href="https://superlog.sh">
  <img width="1200" height="675" alt="Twitter post - 2" src="https://github.com/user-attachments/assets/c6ac3418-8e2f-4f8b-b25c-d75b3a094036" />

</a>

<div align="center" style="margin:24px 0;">
  
<br />

[![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)
[![Apache 2.0 License](https://img.shields.io/badge/License-Apache_2.0-555555.svg?labelColor=333333&color=666666)](./LICENSE.md)
<br>
[![Discord](https://img.shields.io/discord/1511214206123380867?logo=discord&logoColor=white&label=Discord&color=5865F2)](https://discord.gg/wJ56aRh8hx)
<a href="https://www.ycombinator.com"><img src="https://img.shields.io/badge/Y%20Combinator-P26-orange" alt="Y Combinator P26"></a>
[![Follow @superlogYC on X](https://img.shields.io/twitter/follow/superlogyc?logo=X&color=%23f5f5f5)](https://twitter.com/intent/follow?screen_name=superlogYC)

</div>

<p align="center">
  <a href="https://superlog.sh">Website</a>
  ·
  <a href="https://github.com/superloglabs/superlog">Code</a>
  ·
  <a href="https://github.com/superloglabs/skills">Skills</a>
  ·
  <a href="https://github.com/superloglabs/otel-helpers">Helpers</a>
  ·
  <a href="https://discord.gg/wJ56aRh8hx">Discord</a>
</p>

## 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).
