whatisgithub

What is superlog?

superloglabs/superlog — explained in plain English

Analysis updated 2026-05-18

43TypeScriptAudience · ops devopsComplexity · 4/5LicenseSetup · moderate

In one sentence

An open-source observability tool that ingests OpenTelemetry traces, logs, and metrics, then groups noisy signals into summarized incidents for debugging.

Mindmap

mindmap
  root((repo))
    What it does
      Ingests telemetry
      Groups incidents
      Summarizes issues
    Tech stack
      TypeScript
      React
      Postgres
      ClickHouse
    Use cases
      Debug production issues
      Reduce alert noise
      Monitor infra
    Audience
      Developers
      Ops teams
    Requirements
      Node 20 plus
      pnpm
      Docker

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Collect OpenTelemetry traces, logs, and metrics from your production systems in one place.

USE CASE 2

Automatically group related noisy signals into a single, summarized incident.

USE CASE 3

Run a self-hosted observability stack instead of paying for a hosted platform.

USE CASE 4

Plug in a custom agent runner to automate parts of incident investigation.

What is it built with?

TypeScriptReactVitePostgresClickHouseDrizzleOpenTelemetry

How does it compare?

superloglabs/superlogfberrez/quietdash.comflaviojmendes/dinamos
Stars434343
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardmoderate
Complexity4/54/53/5
Audienceops devopsvibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 20+, pnpm 9+, and Docker to run the local stack.

Use freely, including commercially, but you must include the license and note any changes you make to the code.

So what is it?

Superlog is an open source observability system, meaning a tool that watches a running software application and helps engineers understand what it is doing and why something went wrong. It works with OpenTelemetry, a common industry standard for collecting three kinds of data from running systems: traces, which follow a single request as it moves through different parts of an app, logs, which are the text messages a system writes out as it runs, and metrics, which are numeric measurements over time like response times or error counts. What makes Superlog different from a plain logging tool is that it tries to reduce noise automatically. Rather than dumping every trace and log line in front of a human, it groups related, noisy signals together into incidents, trying to summarize what actually went wrong instead of leaving the engineer to piece it together by hand. The repository also includes a pluggable interface for agent runners, along with a basic default agent that records a local summary of each incident, hinting at a broader goal of having automated systems help investigate problems rather than just surface raw data. This repository is the fully open source community edition of Superlog, which includes the web app and its API, a proxy for receiving OpenTelemetry data, background worker processes that group incidents and run jobs, and the database schema for storing telemetry data using Postgres and ClickHouse. A separate paid, hosted version called Superlog Cloud also exists with a free tier. To run it locally, you need Node.js 20 or newer, the pnpm package manager, and Docker, since the local stack runs supporting services like the database through Docker Compose before starting the web app, API, and telemetry intake service. The project is written in TypeScript, uses Vite and React for its frontend, and Drizzle for its database schema and migrations. It is released under the Apache 2.0 license.

Copy-paste prompts

Prompt 1
Help me set up Superlog locally with Docker Compose and connect it to my app's OpenTelemetry output.
Prompt 2
Explain how Superlog groups noisy telemetry signals into a single incident.
Prompt 3
Walk me through the repository layout so I understand what apps/worker and packages/fingerprint do.
Prompt 4
Show me how to write a custom agent runner for Superlog's investigation interface.

Frequently asked questions

What is superlog?

An open-source observability tool that ingests OpenTelemetry traces, logs, and metrics, then groups noisy signals into summarized incidents for debugging.

What language is superlog written in?

Mainly TypeScript. The stack also includes TypeScript, React, Vite.

What license does superlog use?

Use freely, including commercially, but you must include the license and note any changes you make to the code.

How hard is superlog to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is superlog for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.