Observability, Notifications & Telemetry
Guides for capturing metrics, logs, traces, and delivering notifications.
Observability Stack
- …/observability/observability.md – AOC observability overview.
- …/observability/policy.md – policy-specific telemetry guidance.
- …/observability/ui-telemetry.md – UI instrumentation and SSE tracing.
- Telemetry module docs: …/…/modules/telemetry/architecture.md, …/…/modules/telemetry/implementation_plan.md, …/…/modules/telemetry/operations/collector.md, …/…/modules/telemetry/operations/storage.md.
- Authority / Scanner dashboards: see respective module
operations/*.jsonand Grafana runbooks.
Events & Streaming
- …/events/README.md – canonical event definitions.
- Payload schemas (JSON): …/events/scanner.scan.completed@1.json, …/events/scanner.report.ready@1.json, …/events/scheduler.rescan.delta@1.json, …/events/attestor.logged@1.json, etc.
- …/events/samples/ – sample payloads with validation workflow.
- …/…/modules/export-center/provenance-and-signing.md – provenance event integration.
Notifications Studio
- …/notifications/overview.md – architecture and channels.
- …/notifications/rules.md – rule authoring.
- …/notifications/templates.md – template management.
- …/notifications/digests.md – digest scheduling.
- …/…/modules/notify/architecture.md & …/…/modules/notify/implementation_plan.md – implementation detail.
Metrics & Dashboards
- Scanner analyzers dashboard: …/…/modules/scanner/operations/analyzers-grafana-dashboard.json.
- Scheduler worker dashboards & alert rules: …/…/modules/scheduler/operations/worker-grafana-dashboard.json, …/…/modules/scheduler/operations/worker-prometheus-rules.yaml.
- Authority monitoring: …/…/modules/authority/operations/monitoring.md.
- DevOps observability tasks: see …/…/modules/devops/architecture.md and runbooks.