How oneuptime/oneuptime works
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: OtelIngestBaseService.ts OTel ingest · AIInvestigationEngine.ts AI investigation · IncidentService.ts Incident management · Dashboard Dashboards and APM
Components 20
Monitoring and telemetry
- Uptime probes
packages/Probe - Synthetic checks
packages/Probe/Utils/Monitors/SyntheticRuntime/WorkerController.ts - OTel ingest
packages/App/FeatureSet/Telemetry/Services/OtelIngestBaseService.ts - Metrics ingest
packages/App/FeatureSet/Telemetry/Services/OtelMetricsIngestService.ts - Session replay ingest
packages/App/FeatureSet/Telemetry/Services/SessionReplayIngestService.ts - Log management
packages/App/FeatureSet/Telemetry
Incident response
- Incident management
packages/Common/Server/Services/IncidentService.ts - Alerting and on-call
packages/Common/Server/Services/AlertService.ts - Status pages
packages/Common/Types/StatusPage/SearchEngineIndexing.ts
Diagnosis and remediation
- AI investigation
packages/Common/Server/Utils/AI/SRE/AIInvestigationEngine.ts - Resource AI agent
agents/ResourceAIAgent/Agent.ts - Kubernetes AI agent
agents/KubernetesAIAgent/Agent.ts - Fix and review runner
packages/Runner/TaskHandlers/GitHubPullRequestReviewTaskHandler.ts
Product surfaces and core services
- Dashboards and APM
packages/App/FeatureSet/Dashboard - Responder mobile app
packages/MobileApp/src/App.tsx - Projects and configuration
packages/Common/Server/Services/ProjectService.ts - CLI
packages/CLI/Program.ts
Other components
- Engineering team
- Customers and subscribers
- Source repository
Connections 19
- Engineering team → Uptime probes: configures monitors
README.md - Uptime probes → Incident management: detects incidents
README.md - Synthetic checks → Incident management: reports failures
- OTel ingest → Metrics ingest: handles metrics
packages/App/FeatureSet/Telemetry/Services/OtelMetricsIngestService.ts - OTel ingest → Session replay ingest: ingests telemetry
- OTel ingest → Log management: ingests logs
README.md - OTel ingest → Dashboards and APM: feeds observability
README.md - Metrics ingest → Dashboards and APM: feeds dashboards
README.md - Incident management → Alerting and on-call: routes response
README.md - Alerting and on-call → Responder mobile app: pages responders
README.md - Incident management → Status pages: communicates updates
README.md - Status pages → Customers and subscribers: notifies subscribers
README.md - Dashboards and APM → AI investigation: supports diagnosis
README.md - AI investigation → Resource AI agent: investigates resources
- AI investigation → Kubernetes AI agent: investigates clusters
- AI investigation → Fix and review runner: requests fixes
README.md - Fix and review runner → Source repository: opens fix PR
README.md - Engineering team → Projects and configuration: manages projects
README.md - Engineering team → CLI: uses CLI