English Français العربية

Superlog

السجل الرسمي الذكاء الاصطناعي والوكلاء

Open-source agent that observes and fixes your application. Query logs, traces, metrics, incidents.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http superlog 'https://api.superlog.sh/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "superlog": {
            "type": "http",
            "url": "https://api.superlog.sh/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. About
  2. Installation
  3. What is Superlog?
  4. Quick Start
  5. Development
  6. Repository Layout
  7. License

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.

الأسئلة الشائعة

ما هو Superlog؟

Open-source agent that observes and fixes your application. Query logs, traces, metrics, incidents.

كيف أثبّت Superlog؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http superlog 'https://api.superlog.sh/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Superlog إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Superlog مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون Superlog؟

ينشره superloglabs. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.