Superlog — Jefferson Gonçalves — Full Stack PHP Developer

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 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:

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