Production gap
Wardnet exposes health/KPI/support-bundle surfaces and has a local operations runbook, but production operations still lack a declared service-level model, correlated traces/logs/metrics, actionable alerting, tamper-evident audit retention, on-call and incident procedures, tested backup restoration, and measured recovery objectives. The existing runbook explicitly limits the baseline to local and controlled lab deployments.
Audited protected base: b53dc7a1b8904a16752abbdc04429df893a4e32e.
Required observability contract
- Adopt vendor-neutral OpenTelemetry context propagation for ingress, gateway/upstream calls, database transactions, outbox workers, identity checks, destination-policy decisions, and integration calls.
- Emit structured logs with timestamp, severity, service/version, tenant-safe correlation fields, trace/span IDs, route/policy IDs, decision/reason codes, and error class.
- Redact credentials, authorization headers, cookies, sensitive query/body values, personal data, and threat-feed payloads by default; add tests for every logging surface.
- Export low-cardinality metrics for request rate/errors/duration, block/monitor decisions, upstream saturation/failures, auth denials, destination-policy denials, database health/latency/pool, outbox backlog/age/retries/dead letters, limiter saturation, feed freshness, and deployment version.
- Split liveness, readiness, and startup semantics. Readiness must depend on required authorities and schema compatibility but not on optional analytics backends.
- Define trace sampling and security-event retention so incident evidence is sufficient without uncontrolled cost or sensitive-data accumulation.
- Make audit records append-only/tamper-evident with retention, legal/privacy review, export, and access-control policies.
SLO and alert requirements
Define initial objectives and revise from measured capacity:
- data-plane availability and latency by route/traffic class;
- management-plane availability and policy propagation latency;
- enforcement-decision correctness/false-positive guardrails;
- threat-feed freshness;
- identity revocation propagation;
- outbox delivery age and dead-letter rate;
- backup RPO and restore RTO.
Alerts must use burn-rate/sustained-impact logic where appropriate, have an owner, severity, runbook link, deduplication, and testable notification path. Avoid alerts on raw high-cardinality events.
Incident response and recovery
- Add severity classification, on-call ownership, triage, containment, evidence preservation, communications, regulatory/customer escalation inputs, recovery, and post-incident review.
- Add focused runbooks for credential compromise, unauthorized policy change, false-positive mass block, SSRF/egress abuse, feed poisoning, database corruption, outbox backlog, dependency outage, signing/provenance failure, and rollback failure.
- Declare backup cadence, retention, encryption, restore authority, RPO/RTO, and dependency-recovery order.
- Automate isolated restore drills and production-shaped game days; retain evidence and corrective actions.
- Link incident IDs to relevant traces, audit events, deployment digest, policy version, and external-effect receipts.
RED → GREEN verification
- End-to-end trace continuity across HTTP → policy → PostgreSQL → outbox → integration.
- Secret/PII canary values never appear in logs, traces, metrics, support bundles, or errors.
- Readiness fails for missing mandatory auth/database/schema dependencies and remains healthy for optional analytics outage as designed.
- Alert tests inject known SLO breaches and verify deduplicated notification plus runbook linkage.
- Restore drill reconstructs a production-shaped state and proves semantic invariants within RPO/RTO.
- Game-day scenarios exercise detection, containment, rollback, and evidence collection.
Acceptance criteria
Dependencies
References
Production gap
Wardnet exposes health/KPI/support-bundle surfaces and has a local operations runbook, but production operations still lack a declared service-level model, correlated traces/logs/metrics, actionable alerting, tamper-evident audit retention, on-call and incident procedures, tested backup restoration, and measured recovery objectives. The existing runbook explicitly limits the baseline to local and controlled lab deployments.
Audited protected base:
b53dc7a1b8904a16752abbdc04429df893a4e32e.Required observability contract
SLO and alert requirements
Define initial objectives and revise from measured capacity:
Alerts must use burn-rate/sustained-impact logic where appropriate, have an owner, severity, runbook link, deduplication, and testable notification path. Avoid alerts on raw high-cardinality events.
Incident response and recovery
RED → GREEN verification
Acceptance criteria
Dependencies
References