Skip to content

Observability

Governed by STD01-11 (Observability, audit and evidence): the right record for the right purpose — application telemetry, payment history, and analytical reporting are separate concerns, not one system doing all three.

Record type Purpose
Structured logs Technical diagnostics; searchable, short/medium retention, no unnecessary sensitive payloads.
Metrics Rates, latency, capacity, health, errors, circuit state, backlog, SLO measurement.
Distributed trace Request/task path and timing across process boundaries.
PH-09 Journal Immutable material payment/business timeline — not a replacement for logs.
Warehouse / reporting Historical analytics and trends — not authoritative for live payment execution decisions.
Secure evidence store Raw or restricted external payload/file evidence referenced by domain/journal records.

This is the technical telemetry layer underneath both PH-09 (the immutable payment record) and PH-13 (Payment Operations and Reporting, the product-facing search/dashboard surface) — neither of those replaces it, and it doesn't replace either of them.

Observability platform

Decision required — current lean: Datadog (open, ENG-01 §4 / Decision Register), per Build vs. Buy. Not yet built.

Minimum external-dependency metrics (STD01-11)

Request/operation volume, success/rejection/error/timeout counts, latency distribution, circuit-state transitions and time spent open/degraded, admission rejects and queue/backlog depth, technical retry volume and exhaustion, OUTCOME_UNKNOWN count and time to resolution, and last successful interaction / health freshness for operationally important Connections. Not yet built.