How rustrak/rustrak works
Rustrak is a self-hosted Sentry-protocol error and observability tracker. SDKs send envelopes to the server; ingestion durably stages them before asynchronous processing, which feeds error issues, logs, transactions/spans, AI traces, and release health. Users explore those results in the dashboard and manage projects, alerts, integrations, and storage. The graph emphasizes documented ingestion, storage administration, and dashboard entry points; other feature links reflect README capabilities where server call paths were not sampled.
Main entry points: router.tsx Dashboard router · ingest.rs Envelope API · mod.rs Digest processors · storage.ts API client
Components 21
Ingestion pipeline
- Envelope API
apps/server/src/routes/ingest.rs - Envelope storage
apps/server/src/ingest/storage.rs
Event processing
- Digest processors
apps/server/src/digest/processors/mod.rs - Event grouping
apps/server/src/digest/processors/event.rs - Application database
apps/server/src/db/mod.rs
Dashboard insights
- Issue triage
apps/dashboard/src/features/issue/ui/components/issues-list/issues-list.tsx - Event detail
apps/dashboard/src/features/event/ui/components/event-details.tsx - Agent traces
apps/dashboard/src/features/agent-trace/ui/components/agent-trace-waterfall.tsx - Performance
apps/dashboard/src/features/transaction/ui/components/span-waterfall.tsx - Logs
apps/dashboard/src/features/log/ui/components/logs-list.tsx - Release health
apps/dashboard/src/features/release/ui/components/session-health-area.tsx - Dashboard router
apps/dashboard/src/router.tsx
Project administration
- Project settings
apps/dashboard/src/features/project/ui/components/general-settings-form/general-settings-form.tsx - Alert rules
apps/dashboard/src/features/alert/ui/components/alert-rule-dialog/alert-rule-dialog.tsx - Storage admin
apps/dashboard/src/features/storage/ui/components/storage-cleanup.tsx - Storage routes
apps/server/src/routes/storage.rs - Retention service
apps/server/src/services/storage.rs - API client
packages/client/src/resources/storage.ts - MCP tools
packages/mcp/src/tools/storage.ts
Other components
- Sentry SDK
- Administrator
Connections 20
- Sentry SDK → Envelope API: sends envelopes
README.md - Envelope API → Envelope storage: stages events
apps/server/src/routes/ingest.rs - Envelope API → Digest processors: dispatches processing
apps/server/src/routes/ingest.rs - Digest processors → Event grouping: dispatches events
apps/server/src/digest/processors/mod.rs - Digest processors → Application database: persists results
apps/server/src/digest/processors/mod.rs - Event grouping → Issue triage: groups into issues
README.md - Dashboard router → Issue triage: routes to
apps/dashboard/src/router.tsx - Dashboard router → Event detail: routes to
- Dashboard router → Agent traces: routes to
- Dashboard router → Performance: routes to
- Dashboard router → Logs: routes to
- Dashboard router → Release health: routes to
- Administrator → Project settings: configures projects
- Administrator → Alert rules: configures alerts
- Administrator → Storage admin: manages storage
- Storage admin → API client: requests cleanup
apps/dashboard/src/features/storage/ui/components/storage-cleanup.tsx - API client → Storage routes: calls API
packages/client/src/resources/storage.ts - MCP tools → API client: invokes storage methods
packages/mcp/src/tools/storage.ts - Storage routes → Retention service: runs retention
apps/server/src/routes/storage.rs - Retention service → Application database: queries and cleans
apps/server/src/services/storage.rs