Observability

The API emits traces, metrics, and operational logs for health, puzzle generation, cache behavior, runtime loading, rebuilds, player attempts, and frontend events.

The operational correlation loop is:

1. Find the affected route or time window in metrics.
2. Filter logs by event, request ID, or trace ID.
3. Open the trace and inspect child spans such as daily-puzzle-generation, runtime-load, or runtime-rebuild.
4. Compare runtime fingerprint, cache source, and generation diagnostics.

Use the Telemetry catalogue for the complete signal inventory.