Skip to content

feat(relay): record per-leg frame progress for stall triage - #197

Merged
abruption merged 1 commit into
mainfrom
feat/161-relay-frame-monitoring
Sep 24, 2026
Merged

abruption merged 1 commit into
mainfrom
feat/161-relay-frame-monitoring

Conversation

@abruption

@abruption abruption commented Sep 24, 2026 •

Copy link
Copy Markdown
Owner

Refs #161. Built on merged #196 for per-attempt correlation. This is monitoring-only; the underlying #161 root cause remains unknown.

Monitoring change

  • Add opt-in, per-leg opaque WebSocket ingress frame/byte counts and completed downstream socket-send counts plus first/last UTC frame times to Relay stream_close events.
  • Keep default diagnostic logging off and avoid per-frame wall-clock sampling when it is disabled.
  • Add success and stalled-forwarding fixtures; document four-locales interpretation and privacy limits.

This supports investigation if the public-path stall recurs. A completed socket send is not proof of peer delivery, and these counters cannot determine whether Cloudflare, OCI, or a transit hop is at fault. No production service, security setting, or existing unmerged #161 observability worktree was changed.

Verification

  • Full local suite: 517 run, 506 passed, 11 skipped (Python 3.14.7, websockets 17.1).
  • Paired-stream and forward-timeout metadata/privacy tests pass.
  • Documentation i18n checks pass after rebase.

Existing sqlite ResourceWarning in test_control_backup_snapshot.py remains unrelated.

@abruption
abruption force-pushed the feat/172-receiver-attempt-correlation branch from eda30be to 68eb689 Compare September 24, 2026 12:22
@abruption
abruption force-pushed the feat/161-relay-frame-monitoring branch from 896ca7b to 19315f8 Compare September 24, 2026 12:25
@abruption
abruption changed the base branch from feat/172-receiver-attempt-correlation to main September 24, 2026 12:25
@abruption
abruption force-pushed the feat/161-relay-frame-monitoring branch from 19315f8 to 053d07c Compare September 24, 2026 12:26
@abruption
abruption merged commit 68bb02d into main Sep 24, 2026
24 checks passed
@abruption
abruption deleted the feat/161-relay-frame-monitoring branch September 27, 2026 01:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant