# Superlog

## Docs

- [API Keys: Mint and Manage Ingest Keys](https://docs.superlog.sh/api/api-keys.md): Use the Superlog management API to programmatically mint project ingest keys for automated provisioning and key rotation workflows.
- [Authenticate with the Superlog Management API](https://docs.superlog.sh/api/authentication.md): Superlog uses Bearer token authentication. Use management keys for the REST API and ingest keys for OTLP data. Learn how to create and use each.
- [Connect AI Assistants to Superlog via MCP](https://docs.superlog.sh/api/mcp-overview.md): Superlog's MCP server lets Claude, Cursor, and other AI tools query your telemetry and incidents. Authenticate with a personal access token or OAuth.
- [Superlog MCP Tool Reference](https://docs.superlog.sh/api/mcp-tools.md): Complete reference for all Superlog MCP tools — query telemetry, search incidents, manage dashboards, configure agents, and set alerts.
- [OTLP Ingest Endpoints for Traces, Logs, and Metrics](https://docs.superlog.sh/api/otlp-ingest.md): Send OpenTelemetry data to Superlog over OTLP/HTTP. Dedicated endpoints accept traces, logs, and metrics in protobuf or JSON format.
- [Superlog Management API Reference](https://docs.superlog.sh/api/overview.md): The Superlog Management API lets you programmatically create projects, manage API keys, read telemetry, and automate your observability workflow.
- [Projects API: Create and Manage Superlog Projects](https://docs.superlog.sh/api/projects.md): REST endpoints to list, create, and update Superlog projects. Automate project provisioning with the management API.
- [Read Telemetry via the Superlog Management API](https://docs.superlog.sh/api/telemetry-read.md): Query logs, traces, and metrics stored in Superlog using the REST telemetry read endpoints. Authenticated with management API keys.
- [Agent Runs: AI-Powered Incident Investigations in Superlog](https://docs.superlog.sh/concepts/agent-runs.md): Agent runs are AI-powered investigations of your incidents. Each run analyzes telemetry, finds root causes, and may open a fix PR on GitHub.
- [Incidents: Error Grouping and Lifecycle in Superlog](https://docs.superlog.sh/concepts/incidents.md): Incidents are auto-grouped clusters of related errors and anomalies. Learn how Superlog creates, classifies, and resolves incidents from your telemetry.
- [Superlog Projects and Organizations: Structure Your Team](https://docs.superlog.sh/concepts/projects-and-orgs.md): Organize your telemetry with Superlog projects and organizations. Each project gets its own ingest keys, incidents, and agent configuration.
- [Sending OpenTelemetry Traces, Logs, and Metrics to Superlog](https://docs.superlog.sh/concepts/telemetry.md): Superlog ingests OpenTelemetry traces, logs, and metrics over OTLP/HTTP. Learn the ingest endpoints, auth headers, and resource attributes to get started.
- [Configure Superlog AI Agent Automation and PR Settings](https://docs.superlog.sh/configuration/agent-settings.md): Control how Superlog's AI agent opens and merges fix PRs. Configure auto-merge policy, merge strategy, and target branch per project.
- [Manage Superlog Ingest Keys and Management API Keys](https://docs.superlog.sh/configuration/ingest-keys.md): Ingest API keys authenticate your OpenTelemetry instrumentation with Superlog. Create, rotate, and revoke keys from the project settings page.
- [Set Up Superlog Webhooks for Incident Events](https://docs.superlog.sh/configuration/webhooks.md): Configure Superlog webhooks to relay incident events to Telegram, email, PagerDuty, a status page, or any HTTP endpoint. Two events — incident.created and incident.updated — each carry render-ready text plus the full structured state.
- [Teach Superlog Agents with Persistent Memory](https://docs.superlog.sh/features/agent-memory.md): Agent memories are reusable facts you store in Superlog that are injected into every AI investigation, improving accuracy over time.
- [Set Up Threshold Alerts on Logs, Traces, and Metrics](https://docs.superlog.sh/features/alerts.md): Create Superlog alerts that fire when log error counts, span rates, or custom metrics cross a threshold. Get notified via Slack or webhooks.
- [Build Custom Dashboards for Your Telemetry](https://docs.superlog.sh/features/dashboards.md): Superlog dashboards let you visualize traces, logs, and metrics with drag-and-drop widgets. Add timeseries charts, log tables, and trace tables to any dashboard.
- [Filter Noise with Superlog Issue Filters](https://docs.superlog.sh/features/issue-filters.md): Issue filters let you exclude noisy errors or restrict investigations to specific services and routes, reducing alert fatigue and focusing AI agent time.
- [Use Superlog's MCP Server with Your AI Assistant](https://docs.superlog.sh/features/mcp.md): Superlog exposes a Model Context Protocol server so Claude, Cursor, and other AI assistants can query your telemetry, incidents, and dashboards in real time.
- [Upload Source Maps for Readable JavaScript Stack Traces](https://docs.superlog.sh/features/source-maps.md): Upload JavaScript source maps to Superlog so stack traces in incidents and logs show original file names and line numbers instead of minified code.
- [Connect AWS to Superlog for Cloud Resource Visibility](https://docs.superlog.sh/integrations/aws.md): Connect your AWS account to Superlog to ingest CloudWatch metrics via Firehose and visualize your cloud service topology on the service map.
- [GitHub Integration: Automated Fix PRs with Superlog](https://docs.superlog.sh/integrations/github.md): Connect your GitHub repositories to Superlog so the AI agent can read source code, open fix PRs, and auto-merge when CI checks pass.
- [Connect Linear to Track Superlog Incidents as Tickets](https://docs.superlog.sh/integrations/linear.md): Link Superlog to Linear so the AI agent automatically creates issues for new incidents. Track fixes from investigation to ticket to merged PR.
- [Slack Integration: Superlog Incident Notifications](https://docs.superlog.sh/integrations/slack.md): Receive Superlog incident alerts and agent run results directly in Slack. Resolve incidents and leave feedback on investigations without leaving Slack.
- [Superlog](https://docs.superlog.sh/introduction.md): Superlog is an open-source agentic telemetry system: ingest OTLP data, group errors into incidents, and fix them with AI agents automatically.
- [Superlog Quickstart: Send Telemetry and Trigger AI Agents](https://docs.superlog.sh/quickstart.md): Create an account or spin up a local instance, send your first OpenTelemetry trace to Superlog, and watch an AI agent investigate your first incident.
- [Self-Host Superlog: Complete Stack on Your Infrastructure](https://docs.superlog.sh/self-hosting.md): Run Superlog on your own infrastructure using Docker Compose. All services — API, proxy, worker, and databases — start with a single command.