Documentation
Everything you need to use Bilge: the web app, event ingest, programmatic access with personal access tokens and project API keys, and MCP for AI agents in your IDE.
Guides
| Guide | Description |
|---|---|
| Packages & installation | One place to install: Composer (bilgesh/tracing), Rails module, CLI, RUM, embed JS, and subtree mirror repos. |
| Using the app | Organizations, projects, teams, dashboard, issues list, search, alerts, billing, and integrations from a member’s point of view. |
| REST API (v1) | Sanctum personal access tokens: projects, grouped errors, occurrences, resolve/snooze, and automation. Links to the machine-readable OpenAPI description. |
| MCP server | Connect Cursor and other AI agents: 17 tools, docs resources, and triage prompts over POST /mcp/bilge. |
| Ingest API | POST errors, traces, deploy markers, crons, and profiles with your project API key. Full field reference, throttles, and outbound webhooks. |
| Edge ingest (Cloudflare) | Operators: deploy the edge Worker tier, BILGE_INGEST_EDGE_TOKEN, KV sync, and customer DSN hostname. |
| Protocol overview | How payloads map to stored events, fingerprints, and the UI—without framework-specific code. |
| Monitoring modes | Error monitoring vs error plus performance traces, project-level trace gate, and the canonical ingest contract. |
| Framework integrations | Laravel, Rails, WordPress, and JavaScript-oriented notes for breadcrumbs, exceptions, and common patterns. |
| OpenAPI 3 — v1.yaml | Download or import into Postman, Insomnia, or codegen tools. Describes REST v1 and key-authenticated read endpoints. |