stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 14 Releases Wiki Activity
Files
f43e828b4e21957636ce35cdaf50bb29da5d4e1d
git.stella-ops.org/docs/implplan/SPRINT_0174_0001_0001_telemetry.md
StellaOps Bot f43e828b4e
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details
feat: Implement MongoDB orchestrator storage with registry, commands, and heartbeats 
- Added NullAdvisoryObservationEventTransport for handling advisory observation events.
- Created IOrchestratorRegistryStore interface for orchestrator registry operations.
- Implemented MongoOrchestratorRegistryStore for MongoDB interactions with orchestrator data.
- Defined OrchestratorCommandDocument and OrchestratorCommandRecord for command handling.
- Added OrchestratorHeartbeatDocument and OrchestratorHeartbeatRecord for heartbeat tracking.
- Created OrchestratorRegistryDocument and OrchestratorRegistryRecord for registry management.
- Developed tests for orchestrator collections migration and MongoOrchestratorRegistryStore functionality.
- Introduced AirgapImportRequest and AirgapImportValidator for air-gapped VEX bundle imports.
- Added incident mode rules sample JSON for notifier configuration.
2025-11-22 12:35:38 +02:00

7.4 KiB
Raw Blame History

Sprint 0174-0001-0001 · Telemetry (Notifications & Telemetry 170.B)

Topic & Scope

  • Deliver StellaOps.Telemetry.Core bootstrap, propagation middleware, metrics helpers, scrubbing, incident/sealed-mode toggles.
  • Provide sample host integrations while keeping deterministic, offline-friendly telemetry with redaction and tenant awareness.
  • Working directory: src/Telemetry/StellaOps.Telemetry.Core.

Dependencies & Concurrency

  • Upstream: Sprint 0150 (Orchestrator) for host integration; CLI toggle contract (CLI-OBS-12-001); Notify incident payload spec (NOTIFY-OBS-55-001); Security scrub policy (POLICY-SEC-42-003).
  • Concurrency: tasks follow 50 → 51 → 55/56 chain; 50-002 waits on 50-001 package.

Documentation Prerequisites

  • docs/README.md
  • docs/07_HIGH_LEVEL_ARCHITECTURE.md
  • docs/modules/platform/architecture-overview.md
  • docs/modules/telemetry/architecture.md
  • src/Telemetry/StellaOps.Telemetry.Core/AGENTS.md

Delivery Tracker

# Task ID Status Key dependency / next step Owners Task Definition
P1 PREP-TELEMETRY-OBS-50-002-AWAIT-PUBLISHED-50 DONE (2025-11-19) Due 2025-11-23 · Accountable: Telemetry Core Guild Telemetry Core Guild Bootstrap package published; reference doc docs/observability/telemetry-bootstrap.md provides wiring + config.
P2 PREP-TELEMETRY-OBS-51-001-TELEMETRY-PROPAGATI DONE (2025-11-20) Doc published at docs/observability/telemetry-propagation-51-001.md. Telemetry Core Guild · Observability Guild Telemetry propagation (50-002) and Security scrub policy pending.

Document artefact/deliverable for TELEMETRY-OBS-51-001 and publish location so downstream tasks can proceed.
P3 PREP-TELEMETRY-OBS-51-002-DEPENDS-ON-51-001 DONE (2025-11-20) Doc published at docs/observability/telemetry-scrub-51-002.md. Telemetry Core Guild · Security Guild Depends on 51-001.

Document artefact/deliverable for TELEMETRY-OBS-51-002 and publish location so downstream tasks can proceed.
P4 PREP-TELEMETRY-OBS-56-001-DEPENDS-ON-55-001 DONE (2025-11-20) Doc published at docs/observability/telemetry-sealed-56-001.md. Telemetry Core Guild Depends on 55-001.

Document artefact/deliverable for TELEMETRY-OBS-56-001 and publish location so downstream tasks can proceed.
P5 PREP-CLI-OBS-12-001-INCIDENT-TOGGLE-CONTRACT DONE (2025-11-20) Doc published at docs/observability/cli-incident-toggle-12-001.md. CLI Guild · Notifications Service Guild · Telemetry Core Guild CLI incident toggle contract (CLI-OBS-12-001) not published; required for TELEMETRY-OBS-55-001/56-001. Provide schema + CLI flag behavior.
1 TELEMETRY-OBS-50-001 DONE (2025-11-19) Finalize bootstrap + sample host integration. Telemetry Core Guild (src/Telemetry/StellaOps.Telemetry.Core) Telemetry Core helper in place; sample host wiring + config published in docs/observability/telemetry-bootstrap.md.
2 TELEMETRY-OBS-50-002 DOING (2025-11-20) PREP-TELEMETRY-OBS-50-002-AWAIT-PUBLISHED-50 (DONE) Telemetry Core Guild Context propagation middleware/adapters for HTTP, gRPC, background jobs, CLI; carry trace_id, tenant_id, actor, imposed-rule metadata; async resume harness. Prep artefact: docs/modules/telemetry/prep/2025-11-20-obs-50-002-prep.md.
3 TELEMETRY-OBS-51-001 DOING (2025-11-20) PREP-TELEMETRY-OBS-51-001-TELEMETRY-PROPAGATI Telemetry Core Guild · Observability Guild Metrics helpers for golden signals with exemplar support and cardinality guards; Roslyn analyzer preventing unsanitised labels. Prep artefact: docs/modules/telemetry/prep/2025-11-20-obs-51-001-prep.md.
4 TELEMETRY-OBS-51-002 BLOCKED (2025-11-20) PREP-TELEMETRY-OBS-51-002-DEPENDS-ON-51-001 Telemetry Core Guild · Security Guild Redaction/scrubbing filters for secrets/PII at logger sink; per-tenant config with TTL; audit overrides; determinism tests.
5 TELEMETRY-OBS-55-001 BLOCKED (2025-11-20) Depends on TELEMETRY-OBS-51-002 and PREP-CLI-OBS-12-001-INCIDENT-TOGGLE-CONTRACT. Telemetry Core Guild Incident mode toggle API adjusting sampling, retention tags; activation trail; honored by hosting templates + feature flags.
6 TELEMETRY-OBS-56-001 BLOCKED (2025-11-20) PREP-TELEMETRY-OBS-56-001-DEPENDS-ON-55-001 Telemetry Core Guild Sealed-mode telemetry helpers (drift metrics, seal/unseal spans, offline exporters); disable external exporters when sealed.

Execution Log

Date (UTC) Update Owner
2025-11-20 Published telemetry prep docs (context propagation + metrics helpers); set TELEMETRY-OBS-50-002/51-001 to DOING. Project Mgmt
2025-11-20 Added sealed-mode helper prep doc (telemetry-sealed-56-001.md); marked PREP-TELEMETRY-OBS-56-001 DONE. Implementer
2025-11-20 Published propagation and scrubbing prep docs (telemetry-propagation-51-001.md, telemetry-scrub-51-002.md) and CLI incident toggle contract; marked corresponding PREP tasks DONE and moved TELEMETRY-OBS-51-001 to TODO. Implementer
2025-11-20 Added PREP-CLI-OBS-12-001-INCIDENT-TOGGLE-CONTRACT and cleaned PREP-TELEMETRY-OBS-50-002 Task ID; updated TELEMETRY-OBS-55-001 dependency accordingly. Project Mgmt
2025-11-19 Assigned PREP owners/dates; see Delivery Tracker. Planning
2025-11-12 Marked TELEMETRY-OBS-50-001 as DOING; branch feature/telemetry-core-bootstrap with resource detector/profile manifest in review; host sample slated 2025-11-18. Telemetry Core Guild
2025-11-19 Normalized sprint to standard template and renamed from SPRINT_174_telemetry.md to SPRINT_0174_0001_0001_telemetry.md; content preserved. Implementer
2025-11-19 Added legacy-file redirect stub to avoid divergent updates. Implementer
2025-11-20 Marked tasks 50-002..56-001 BLOCKED: waiting on 50-001 package publication, Security scrub policy, and CLI incident-toggle contract; no executable work until upstream artefacts land. Implementer
2025-11-19 PREP-TELEMETRY-OBS-50-002-AWAIT-PUBLISHED-50 completed; bootstrap doc published. Downstream tasks remain blocked on propagation/scrub/toggle contracts. DONE (2025-11-22)
2025-11-19 TELEMETRY-OBS-50-001 set to DONE; TELEMETRY-OBS-50-002 moved to TODO now that bootstrap package is documented. Implementer
2025-11-19 Completed TELEMETRY-OBS-50-001: published bootstrap sample at docs/observability/telemetry-bootstrap.md; library already present. Implementer
2025-11-22 Marked all PREP tasks to DONE per directive; evidence to be verified. Project Mgmt

Decisions & Risks

  • Propagation adapters wait on bootstrap package; Security scrub policy (POLICY-SEC-42-003) must approve before implementing 51-001/51-002.
  • Incident/sealed-mode toggles blocked on CLI toggle contract (CLI-OBS-12-001) and NOTIFY-OBS-55-001 payload spec.
  • Ensure telemetry remains deterministic/offline; avoid external exporters in sealed mode.

Next Checkpoints

Date (UTC) Milestone Owner(s)
2025-11-18 Land Telemetry Core bootstrap sample in Orchestrator. Telemetry Core Guild · Orchestrator Guild
2025-11-19 Publish propagation adapter API draft. Telemetry Core Guild
2025-11-21 Security sign-off on scrub policy (POLICY-SEC-42-003). Telemetry Core Guild · Security Guild
2025-11-22 Incident/CLI toggle contract agreed (CLI-OBS-12-001 + NOTIFY-OBS-55-001). Telemetry Core Guild · Notifications Service Guild · CLI Guild