prisma-risk / tsoracle / 26299467786

95%

Build Type

push

github

Committed by web-flow

Commit Message

feat(client): instrument retry, driver, and connect signals (#116)

Adds observability to tsoracle-client so operators can detect leader
pivots, retries, connect failures, and queue saturation in production.
The crate already declared a `tracing` feature with no call sites and
had no metrics surface at all; this fills both gaps.

- New `metrics` feature (default off) emits eight `tsoracle.client.*`
  signals through the `metrics` crate facade, mirroring the server's
  feature gating and dot-segmented namespace.
- `tracing` is now in the default feature set (matching the server)
  with structured events on every retry decision: per-attempt debug,
  per-pivot debug, and per-failure warn lines.
- `decode_leader_hint` distinguishes Absent / Decoded / Malformed
  outcomes so the `decode_failures` counter and warning fire only on
  genuine wire-format failures, not on missing trailers.
- `tests/client_metrics.rs` drives three end-to-end scenarios
  (follower→leader pivot, closed-port retry, malformed-trailer fake
  service) and asserts each documented signal fires via
  `metrics_util::DebuggingRecorder`.
- `docs/operations.md` adds the client signal catalog symmetric to the
  existing server section.

Feature matrix verified: --no-default-features, +tracing, +metrics,
+tracing +metrics, and --all-features all compile cleanly.

Closes #86

Coverage Stats

62 of 92 new or added lines in 3 files covered. (67.39%)

1 existing line in 1 file now uncovered.

6916 of 7210 relevant lines covered (95.92%)

79191.21 hits per line