# oneuptime/oneuptime architecture

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

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

## Overview

OneUptime is a self-hostable observability and incident-response platform. Its principal workflow is to detect service problems through monitors and telemetry, create and route incidents to on-call responders, communicate status to customers, then correlate telemetry for diagnosis and optionally draft a repository fix. The graph preserves major README capabilities and uses the sampled telemetry and agent modules where available. Several product branches are documented in the README but their implementation was not sampled, so those relationships are documented rather than inferred from code.

Main entry points: [`packages/App/FeatureSet/Telemetry/Services/OtelIngestBaseService.ts`](https://github.com/oneuptime/oneuptime/blob/master/packages/App/FeatureSet/Telemetry/Services/OtelIngestBaseService.ts) (OTel ingest), [`packages/Common/Server/Utils/AI/SRE/AIInvestigationEngine.ts`](https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Server/Utils/AI/SRE/AIInvestigationEngine.ts) (AI investigation), [`packages/Common/Server/Services/IncidentService.ts`](https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Server/Services/IncidentService.ts) (Incident management), [`packages/App/FeatureSet/Dashboard`](https://github.com/oneuptime/oneuptime/tree/master/packages/App/FeatureSet/Dashboard) (Dashboards and APM)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_observe["Monitoring and telemetry"]
  node_probes["Uptime probes"]
  node_synthetic["Synthetic checks"]
  node_otel["OTel ingest"]
  node_metrics["Metrics ingest"]
  node_replay["Session replay ingest"]
  node_logs["Log management"]
end

subgraph group_respond["Incident response"]
  node_incident["Incident management<br/>[IncidentService.ts]"]
  node_alerts["Alerting and on-call<br/>[AlertService.ts]"]
  node_status["Status pages"]
end

subgraph group_diagnose["Diagnosis and remediation"]
  node_ai["AI investigation"]
  node_resourceagent["Resource AI agent<br/>[Agent.ts]"]
  node_k8sagent["Kubernetes AI agent<br/>[Agent.ts]"]
  node_runner["Fix and review runner"]
end

subgraph group_platform["Product surfaces and core services"]
  node_dashboard["Dashboards and APM"]
  node_mobile["Responder mobile app<br/>[App.tsx]"]
  node_project["Projects and configuration<br/>[ProjectService.ts]"]
  node_cli["CLI<br/>[Program.ts]"]
end

node_team(("Engineering team"))
node_customers(("Customers and subscribers"))
node_repository["Source repository"]

node_team -->|"configures monitors"| node_probes
node_probes -->|"detects incidents"| node_incident
node_synthetic -.->|"reports failures"| node_incident
node_otel -->|"handles metrics"| node_metrics
node_otel -.->|"ingests telemetry"| node_replay
node_otel -->|"ingests logs"| node_logs
node_otel -->|"feeds observability"| node_dashboard
node_metrics -->|"feeds dashboards"| node_dashboard
node_incident -->|"routes response"| node_alerts
node_alerts -->|"pages responders"| node_mobile
node_incident -->|"communicates updates"| node_status
node_status -->|"notifies subscribers"| node_customers
node_dashboard -->|"supports diagnosis"| node_ai
node_ai -.->|"investigates resources"| node_resourceagent
node_ai -.->|"investigates clusters"| node_k8sagent
node_ai -->|"requests fixes"| node_runner
node_runner -->|"opens fix PR"| node_repository
node_team -->|"manages projects"| node_project
node_team -.->|"uses CLI"| node_cli

click node_probes "https://github.com/oneuptime/oneuptime/tree/master/packages/Probe"
click node_synthetic "https://github.com/oneuptime/oneuptime/blob/master/packages/Probe/Utils/Monitors/SyntheticRuntime/WorkerController.ts"
click node_otel "https://github.com/oneuptime/oneuptime/blob/master/packages/App/FeatureSet/Telemetry/Services/OtelIngestBaseService.ts"
click node_metrics "https://github.com/oneuptime/oneuptime/blob/master/packages/App/FeatureSet/Telemetry/Services/OtelMetricsIngestService.ts"
click node_replay "https://github.com/oneuptime/oneuptime/blob/master/packages/App/FeatureSet/Telemetry/Services/SessionReplayIngestService.ts"
click node_logs "https://github.com/oneuptime/oneuptime/tree/master/packages/App/FeatureSet/Telemetry"
click node_dashboard "https://github.com/oneuptime/oneuptime/tree/master/packages/App/FeatureSet/Dashboard"
click node_incident "https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Server/Services/IncidentService.ts"
click node_alerts "https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Server/Services/AlertService.ts"
click node_status "https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Types/StatusPage/SearchEngineIndexing.ts"
click node_ai "https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Server/Utils/AI/SRE/AIInvestigationEngine.ts"
click node_resourceagent "https://github.com/oneuptime/oneuptime/blob/master/agents/ResourceAIAgent/Agent.ts"
click node_k8sagent "https://github.com/oneuptime/oneuptime/blob/master/agents/KubernetesAIAgent/Agent.ts"
click node_runner "https://github.com/oneuptime/oneuptime/blob/master/packages/Runner/TaskHandlers/GitHubPullRequestReviewTaskHandler.ts"
click node_mobile "https://github.com/oneuptime/oneuptime/blob/master/packages/MobileApp/src/App.tsx"
click node_project "https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Server/Services/ProjectService.ts"
click node_cli "https://github.com/oneuptime/oneuptime/blob/master/packages/CLI/Program.ts"

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_probes,node_synthetic,node_otel,node_metrics,node_replay,node_logs toneBlue
class node_incident,node_alerts,node_status toneAmber
class node_ai,node_resourceagent,node_k8sagent,node_runner toneMint
class node_dashboard,node_mobile,node_project,node_cli toneRose
class node_team,node_customers,node_repository toneIndigo
```

## Components

### Monitoring and telemetry

- [Uptime probes](https://github.com/oneuptime/oneuptime/tree/master/packages/Probe): `packages/Probe`
- [Synthetic checks](https://github.com/oneuptime/oneuptime/blob/master/packages/Probe/Utils/Monitors/SyntheticRuntime/WorkerController.ts): `packages/Probe/Utils/Monitors/SyntheticRuntime/WorkerController.ts`
- [OTel ingest](https://github.com/oneuptime/oneuptime/blob/master/packages/App/FeatureSet/Telemetry/Services/OtelIngestBaseService.ts): `packages/App/FeatureSet/Telemetry/Services/OtelIngestBaseService.ts`
- [Metrics ingest](https://github.com/oneuptime/oneuptime/blob/master/packages/App/FeatureSet/Telemetry/Services/OtelMetricsIngestService.ts): `packages/App/FeatureSet/Telemetry/Services/OtelMetricsIngestService.ts`
- [Session replay ingest](https://github.com/oneuptime/oneuptime/blob/master/packages/App/FeatureSet/Telemetry/Services/SessionReplayIngestService.ts): `packages/App/FeatureSet/Telemetry/Services/SessionReplayIngestService.ts`
- [Log management](https://github.com/oneuptime/oneuptime/tree/master/packages/App/FeatureSet/Telemetry): `packages/App/FeatureSet/Telemetry`

### Incident response

- [Incident management](https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Server/Services/IncidentService.ts): `packages/Common/Server/Services/IncidentService.ts`
- [Alerting and on-call](https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Server/Services/AlertService.ts): `packages/Common/Server/Services/AlertService.ts`
- [Status pages](https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Types/StatusPage/SearchEngineIndexing.ts): `packages/Common/Types/StatusPage/SearchEngineIndexing.ts`

### Diagnosis and remediation

- [AI investigation](https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Server/Utils/AI/SRE/AIInvestigationEngine.ts): `packages/Common/Server/Utils/AI/SRE/AIInvestigationEngine.ts`
- [Resource AI agent](https://github.com/oneuptime/oneuptime/blob/master/agents/ResourceAIAgent/Agent.ts): `agents/ResourceAIAgent/Agent.ts`
- [Kubernetes AI agent](https://github.com/oneuptime/oneuptime/blob/master/agents/KubernetesAIAgent/Agent.ts): `agents/KubernetesAIAgent/Agent.ts`
- [Fix and review runner](https://github.com/oneuptime/oneuptime/blob/master/packages/Runner/TaskHandlers/GitHubPullRequestReviewTaskHandler.ts): `packages/Runner/TaskHandlers/GitHubPullRequestReviewTaskHandler.ts`

### Product surfaces and core services

- [Dashboards and APM](https://github.com/oneuptime/oneuptime/tree/master/packages/App/FeatureSet/Dashboard): `packages/App/FeatureSet/Dashboard`
- [Responder mobile app](https://github.com/oneuptime/oneuptime/blob/master/packages/MobileApp/src/App.tsx): `packages/MobileApp/src/App.tsx`
- [Projects and configuration](https://github.com/oneuptime/oneuptime/blob/master/packages/Common/Server/Services/ProjectService.ts): `packages/Common/Server/Services/ProjectService.ts`
- [CLI](https://github.com/oneuptime/oneuptime/blob/master/packages/CLI/Program.ts): `packages/CLI/Program.ts`

### Other components

- **Engineering team**
- **Customers and subscribers**
- **Source repository**

## Connections

- Engineering team → Uptime probes: configures monitors (evidence: `README.md`)
- Uptime probes → Incident management: detects incidents (evidence: `README.md`)
- Synthetic checks → Incident management: reports failures
- OTel ingest → Metrics ingest: handles metrics (evidence: `packages/App/FeatureSet/Telemetry/Services/OtelMetricsIngestService.ts`)
- OTel ingest → Session replay ingest: ingests telemetry
- OTel ingest → Log management: ingests logs (evidence: `README.md`)
- OTel ingest → Dashboards and APM: feeds observability (evidence: `README.md`)
- Metrics ingest → Dashboards and APM: feeds dashboards (evidence: `README.md`)
- Incident management → Alerting and on-call: routes response (evidence: `README.md`)
- Alerting and on-call → Responder mobile app: pages responders (evidence: `README.md`)
- Incident management → Status pages: communicates updates (evidence: `README.md`)
- Status pages → Customers and subscribers: notifies subscribers (evidence: `README.md`)
- Dashboards and APM → AI investigation: supports diagnosis (evidence: `README.md`)
- AI investigation → Resource AI agent: investigates resources
- AI investigation → Kubernetes AI agent: investigates clusters
- AI investigation → Fix and review runner: requests fixes (evidence: `README.md`)
- Fix and review runner → Source repository: opens fix PR (evidence: `README.md`)
- Engineering team → Projects and configuration: manages projects (evidence: `README.md`)
- Engineering team → CLI: uses CLI
