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/*.json and 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.