# rustrak/rustrak architecture

> Architecture diagram of the GitHub repository rustrak/rustrak, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rustrak/rustrak
- Repository: https://github.com/rustrak/rustrak

## Overview

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: [`apps/dashboard/src/router.tsx`](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/router.tsx) (Dashboard router), [`apps/server/src/routes/ingest.rs`](https://github.com/rustrak/rustrak/blob/main/apps/server/src/routes/ingest.rs) (Envelope API), [`apps/server/src/digest/processors/mod.rs`](https://github.com/rustrak/rustrak/blob/main/apps/server/src/digest/processors/mod.rs) (Digest processors), [`packages/client/src/resources/storage.ts`](https://github.com/rustrak/rustrak/blob/main/packages/client/src/resources/storage.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingestion["Ingestion pipeline"]
  node_ingest_api["Envelope API<br/>[ingest.rs]"]
  node_envelope[("Envelope storage<br/>[storage.rs]")]
end

subgraph group_processing["Event processing"]
  node_processors["Digest processors<br/>[mod.rs]"]
  node_event_proc["Event grouping<br/>[event.rs]"]
  node_db[("Application database<br/>[mod.rs]")]
end

subgraph group_explore["Dashboard insights"]
  node_issue["Issue triage<br/>[issues-list.tsx]"]
  node_event_detail["Event detail<br/>[event-details.tsx]"]
  node_agent_trace["Agent traces"]
  node_performance["Performance<br/>[span-waterfall.tsx]"]
  node_logs["Logs<br/>[logs-list.tsx]"]
  node_release_health["Release health"]
  node_dashboard["Dashboard router<br/>[router.tsx]"]
end

subgraph group_admin["Project administration"]
  node_project_admin["Project settings"]
  node_alerts["Alert rules"]
  node_storage_ui["Storage admin"]
  node_storage_api["Storage routes<br/>[storage.rs]"]
  node_storage_service["Retention service<br/>[storage.rs]"]
  node_client["API client<br/>[storage.ts]"]
  node_mcp["MCP tools<br/>[storage.ts]"]
end

node_sdk(("Sentry SDK"))
node_admin_user(("Administrator"))

node_sdk -->|"sends envelopes"| node_ingest_api
node_ingest_api -->|"stages events"| node_envelope
node_ingest_api -->|"dispatches processing"| node_processors
node_processors -->|"dispatches events"| node_event_proc
node_processors -.->|"persists results"| node_db
node_event_proc -.->|"groups into issues"| node_issue
node_dashboard -->|"routes to"| node_issue
node_dashboard -.->|"routes to"| node_event_detail
node_dashboard -.->|"routes to"| node_agent_trace
node_dashboard -.->|"routes to"| node_performance
node_dashboard -.->|"routes to"| node_logs
node_dashboard -.->|"routes to"| node_release_health
node_admin_user -.->|"configures projects"| node_project_admin
node_admin_user -.->|"configures alerts"| node_alerts
node_admin_user -.->|"manages storage"| node_storage_ui
node_storage_ui -->|"requests cleanup"| node_client
node_client -->|"calls API"| node_storage_api
node_mcp -->|"invokes storage methods"| node_client
node_storage_api -->|"runs retention"| node_storage_service
node_storage_service -->|"queries and cleans"| node_db

click node_ingest_api "https://github.com/rustrak/rustrak/blob/main/apps/server/src/routes/ingest.rs"
click node_envelope "https://github.com/rustrak/rustrak/blob/main/apps/server/src/ingest/storage.rs"
click node_processors "https://github.com/rustrak/rustrak/blob/main/apps/server/src/digest/processors/mod.rs"
click node_event_proc "https://github.com/rustrak/rustrak/blob/main/apps/server/src/digest/processors/event.rs"
click node_issue "https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/issue/ui/components/issues-list/issues-list.tsx"
click node_event_detail "https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/event/ui/components/event-details.tsx"
click node_agent_trace "https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/agent-trace/ui/components/agent-trace-waterfall.tsx"
click node_performance "https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/transaction/ui/components/span-waterfall.tsx"
click node_logs "https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/log/ui/components/logs-list.tsx"
click node_release_health "https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/release/ui/components/session-health-area.tsx"
click node_dashboard "https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/router.tsx"
click node_project_admin "https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/project/ui/components/general-settings-form/general-settings-form.tsx"
click node_alerts "https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/alert/ui/components/alert-rule-dialog/alert-rule-dialog.tsx"
click node_storage_ui "https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/storage/ui/components/storage-cleanup.tsx"
click node_storage_api "https://github.com/rustrak/rustrak/blob/main/apps/server/src/routes/storage.rs"
click node_storage_service "https://github.com/rustrak/rustrak/blob/main/apps/server/src/services/storage.rs"
click node_client "https://github.com/rustrak/rustrak/blob/main/packages/client/src/resources/storage.ts"
click node_mcp "https://github.com/rustrak/rustrak/blob/main/packages/mcp/src/tools/storage.ts"
click node_db "https://github.com/rustrak/rustrak/blob/main/apps/server/src/db/mod.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ingest_api,node_envelope toneBlue
class node_processors,node_event_proc,node_db toneAmber
class node_issue,node_event_detail,node_agent_trace,node_performance,node_logs,node_release_health,node_dashboard toneMint
class node_project_admin,node_alerts,node_storage_ui,node_storage_api,node_storage_service,node_client,node_mcp toneRose
class node_sdk,node_admin_user toneIndigo
```

## Components

### Ingestion pipeline

- [Envelope API](https://github.com/rustrak/rustrak/blob/main/apps/server/src/routes/ingest.rs): `apps/server/src/routes/ingest.rs`
- [Envelope storage](https://github.com/rustrak/rustrak/blob/main/apps/server/src/ingest/storage.rs): `apps/server/src/ingest/storage.rs`

### Event processing

- [Digest processors](https://github.com/rustrak/rustrak/blob/main/apps/server/src/digest/processors/mod.rs): `apps/server/src/digest/processors/mod.rs`
- [Event grouping](https://github.com/rustrak/rustrak/blob/main/apps/server/src/digest/processors/event.rs): `apps/server/src/digest/processors/event.rs`
- [Application database](https://github.com/rustrak/rustrak/blob/main/apps/server/src/db/mod.rs): `apps/server/src/db/mod.rs`

### Dashboard insights

- [Issue triage](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/issue/ui/components/issues-list/issues-list.tsx): `apps/dashboard/src/features/issue/ui/components/issues-list/issues-list.tsx`
- [Event detail](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/event/ui/components/event-details.tsx): `apps/dashboard/src/features/event/ui/components/event-details.tsx`
- [Agent traces](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/agent-trace/ui/components/agent-trace-waterfall.tsx): `apps/dashboard/src/features/agent-trace/ui/components/agent-trace-waterfall.tsx`
- [Performance](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/transaction/ui/components/span-waterfall.tsx): `apps/dashboard/src/features/transaction/ui/components/span-waterfall.tsx`
- [Logs](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/log/ui/components/logs-list.tsx): `apps/dashboard/src/features/log/ui/components/logs-list.tsx`
- [Release health](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/release/ui/components/session-health-area.tsx): `apps/dashboard/src/features/release/ui/components/session-health-area.tsx`
- [Dashboard router](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/router.tsx): `apps/dashboard/src/router.tsx`

### Project administration

- [Project settings](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/project/ui/components/general-settings-form/general-settings-form.tsx): `apps/dashboard/src/features/project/ui/components/general-settings-form/general-settings-form.tsx`
- [Alert rules](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/alert/ui/components/alert-rule-dialog/alert-rule-dialog.tsx): `apps/dashboard/src/features/alert/ui/components/alert-rule-dialog/alert-rule-dialog.tsx`
- [Storage admin](https://github.com/rustrak/rustrak/blob/main/apps/dashboard/src/features/storage/ui/components/storage-cleanup.tsx): `apps/dashboard/src/features/storage/ui/components/storage-cleanup.tsx`
- [Storage routes](https://github.com/rustrak/rustrak/blob/main/apps/server/src/routes/storage.rs): `apps/server/src/routes/storage.rs`
- [Retention service](https://github.com/rustrak/rustrak/blob/main/apps/server/src/services/storage.rs): `apps/server/src/services/storage.rs`
- [API client](https://github.com/rustrak/rustrak/blob/main/packages/client/src/resources/storage.ts): `packages/client/src/resources/storage.ts`
- [MCP tools](https://github.com/rustrak/rustrak/blob/main/packages/mcp/src/tools/storage.ts): `packages/mcp/src/tools/storage.ts`

### Other components

- **Sentry SDK**
- **Administrator**

## Connections

- Sentry SDK → Envelope API: sends envelopes (evidence: `README.md`)
- Envelope API → Envelope storage: stages events (evidence: `apps/server/src/routes/ingest.rs`)
- Envelope API → Digest processors: dispatches processing (evidence: `apps/server/src/routes/ingest.rs`)
- Digest processors → Event grouping: dispatches events (evidence: `apps/server/src/digest/processors/mod.rs`)
- Digest processors → Application database: persists results (evidence: `apps/server/src/digest/processors/mod.rs`)
- Event grouping → Issue triage: groups into issues (evidence: `README.md`)
- Dashboard router → Issue triage: routes to (evidence: `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 (evidence: `apps/dashboard/src/features/storage/ui/components/storage-cleanup.tsx`)
- API client → Storage routes: calls API (evidence: `packages/client/src/resources/storage.ts`)
- MCP tools → API client: invokes storage methods (evidence: `packages/mcp/src/tools/storage.ts`)
- Storage routes → Retention service: runs retention (evidence: `apps/server/src/routes/storage.rs`)
- Retention service → Application database: queries and cleans (evidence: `apps/server/src/services/storage.rs`)
