Observability — microservices¶
Generated from the architecture model
This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.
Every logical service keeps its own design page and model entry; deployment granularity says how it is shipped at first (decision D23). Modules of a host are deployed inside that host until an extraction decision is recorded.
flowchart TB
subgraph ObservabilityHost["ObservabilityHost (host)"]
AgentTelemetryService["AgentTelemetryService"]
AlertRuleService["AlertRuleService"]
DashboardService["DashboardService"]
FeedbackService["FeedbackService"]
KnowledgeQualityService["KnowledgeQualityService"]
QualityScoreService["QualityScoreService"]
RuntimeHealthService["RuntimeHealthService"]
SloService["SloService"]
end
LogQueryService[("LogQueryService<br/>external")]
MetricAggregationService[("MetricAggregationService<br/>external")]
TelemetryCorrelationService[("TelemetryCorrelationService<br/>external")]
TraceService[("TraceService<br/>external")]
IncidentService["IncidentService (later)"]:::later
TemplateAnalyticsService["TemplateAnalyticsService (later)"]:::later
classDef later stroke-dasharray: 4 4;| Service | Context | Granularity | Host | Status | Page |
|---|---|---|---|---|---|
| AgentTelemetryService | BC-21 | module of host | ObservabilityHost | unmodelled | — |
| AlertRuleService | BC-21 | module of host | ObservabilityHost | target | design |
| DashboardService | BC-21 | module of host | ObservabilityHost | target | design |
| FeedbackService | BC-22 | module of host | ObservabilityHost | target | design |
| IncidentService | BC-21 | later stage | — | unmodelled | — |
| KnowledgeQualityService | BC-22 | module of host | ObservabilityHost | unmodelled | — |
| LogQueryService | BC-21 | external / canonical | — | unmodelled | — |
| MetricAggregationService | BC-21 | external / canonical | — | unmodelled | — |
| ObservabilityHost | BC-21 | standalone host | — | target | design |
| QualityScoreService | BC-22 | module of host | ObservabilityHost | target | design |
| RuntimeHealthService | BC-21 | module of host | ObservabilityHost | unmodelled | — |
| SloService | BC-21 | module of host | ObservabilityHost | target | design |
| TelemetryCorrelationService | BC-21 | external / canonical | — | unmodelled | — |
| TemplateAnalyticsService | BC-21 | later stage | — | unmodelled | — |
| TraceService | BC-21 | external / canonical | — | unmodelled | — |
AgentTelemetryService¶
Observability projection; merged into DashboardService.
| Bounded context | BC-21 Operations |
| Granularity | module of host · host ObservabilityHost |
| Former catalog group | Agent Mesh (merge) |
| Status | unmodelled |
| Design page | not written yet |
AlertRuleService¶
Alert rules over SLOs, health, uncertain effects, findings and metrics with deduplication and routed notifications (BC-21).
| Bounded context | BC-21 Operations |
| Granularity | module of host · host ObservabilityHost |
| Former catalog group | Observability & Feedback (module) |
| Status | target |
| Modelled | 2 aggregates · 5 REST + 0 gRPC · 3 events · 2 workers · 2 tables |
| Design page | planes/trust-operations/observability/services/alert-rule-service/index.md |
DashboardService¶
Operations projections: run timelines joining Run Control truth with runtime, model, tool, context and usage events; overview aggregates (BC-21).
| Bounded context | BC-21 Operations |
| Granularity | module of host · host ObservabilityHost |
| Former catalog group | Observability & Feedback (module) |
| Status | target |
| Modelled | 2 aggregates · 5 REST + 1 gRPC · 2 events · 2 workers · 4 tables |
| Design page | planes/trust-operations/observability/services/dashboard-service/index.md |
FeedbackService¶
Human feedback, evaluation datasets from historical tasks, learning proposals reviewed by maintainers (BC-22).
| Bounded context | BC-22 Evaluation & Learning |
| Granularity | module of host · host ObservabilityHost |
| Former catalog group | Observability & Feedback (module) |
| Status | target |
| Modelled | 3 aggregates · 6 REST + 1 gRPC · 4 events · 2 workers · 4 tables |
| Design page | planes/trust-operations/observability/services/feedback-service/index.md |
IncidentService¶
IncidentService (Observability & Feedback group of the June-2026 catalog).
| Bounded context | BC-21 Operations |
| Granularity | later stage |
| Former catalog group | Observability & Feedback (defer) |
| Status | unmodelled |
| Design page | not written yet |
KnowledgeQualityService¶
Knowledge quality evaluation; merged into QualityScoreService.
| Bounded context | BC-22 Evaluation & Learning |
| Granularity | module of host · host ObservabilityHost |
| Former catalog group | Knowledge Platform (merge) |
| Status | unmodelled |
| Design page | not written yet |
LogQueryService¶
OpenTelemetry backends; the Factory owns projections and attribution
| Bounded context | BC-21 Operations |
| Granularity | external / canonical · ref ext-otel-backend |
| Former catalog group | Observability & Feedback (external) |
| Status | unmodelled |
| Design page | not written yet |
MetricAggregationService¶
OpenTelemetry backends; the Factory owns projections and attribution
| Bounded context | BC-21 Operations |
| Granularity | external / canonical · ref ext-otel-backend |
| Former catalog group | Observability & Feedback (external) |
| Status | unmodelled |
| Design page | not written yet |
ObservabilityHost¶
Operations, evaluation and FinOps projection host.
| Bounded context | BC-21 Operations |
| Granularity | standalone host |
| Former catalog group | (host added 2026-10-09) (module) |
| Status | target |
| Modelled | 0 aggregates · 2 REST + 0 gRPC · 0 events · 0 workers · 0 tables |
| Design page | planes/trust-operations/observability/services/observability-host/index.md |
QualityScoreService¶
Evaluation suites, runs, verdicts with regression gates and waivers, drift monitoring; evidence read at publication (BC-22).
| Bounded context | BC-22 Evaluation & Learning |
| Granularity | module of host · host ObservabilityHost |
| Former catalog group | Observability & Feedback (module) |
| Status | target |
| Modelled | 2 aggregates · 5 REST + 2 gRPC · 5 events · 2 workers · 3 tables |
| Design page | planes/trust-operations/observability/services/quality-score-service/index.md |
RuntimeHealthService¶
Health rollup; merged into SloService.
| Bounded context | BC-21 Operations |
| Granularity | module of host · host ObservabilityHost |
| Former catalog group | Runtime Cloud (merge) |
| Status | unmodelled |
| Design page | not written yet |
SloService¶
SLO definitions, measurements and error budgets per subject; host health rollup (BC-21).
| Bounded context | BC-21 Operations |
| Granularity | module of host · host ObservabilityHost |
| Former catalog group | Observability & Feedback (module) |
| Status | target |
| Modelled | 2 aggregates · 3 REST + 0 gRPC · 4 events · 2 workers · 3 tables |
| Design page | planes/trust-operations/observability/services/slo-service/index.md |
TelemetryCorrelationService¶
OpenTelemetry backends; the Factory owns projections and attribution
| Bounded context | BC-21 Operations |
| Granularity | external / canonical · ref ext-otel-backend |
| Former catalog group | Observability & Feedback (external) |
| Status | unmodelled |
| Design page | not written yet |
TemplateAnalyticsService¶
TemplateAnalyticsService (Template & Library group of the June-2026 catalog).
| Bounded context | BC-21 Operations |
| Granularity | later stage |
| Former catalog group | Template & Library (defer) |
| Status | unmodelled |
| Design page | not written yet |
TraceService¶
OpenTelemetry backends; the Factory owns projections and attribution
| Bounded context | BC-21 Operations |
| Granularity | external / canonical · ref ext-otel-backend |
| Former catalog group | Observability & Feedback (external) |
| Status | unmodelled |
| Design page | not written yet |