Skip to content

Commit 10bacae

Browse files
committed
docs: add protobuf debugging tools note to Phase 2 design
1 parent f56969f commit 10bacae

1 file changed

Lines changed: 15 additions & 0 deletions

File tree

‎docs/phase2/design-notes.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,21 @@ Steady-state: 3 fds per partition (active segment only). Closed segments release
6464

6565
---
6666

67+
## Debugging Tools (Phase 2)
68+
69+
### Protobuf Visibility
70+
71+
2PC adds Prepare/Commit/Abort message flows. Need visibility during development.
72+
73+
Options:
74+
- Server flag `-log-protobuf` — dumps decoded requests/responses to stderr
75+
- Standalone TCP proxy (~100 lines Go) — sits between client and server, decodes frames, logs, forwards
76+
- `protoc --decode` — offline decoding of captured traffic
77+
78+
**Decision**: build server flag + proxy during Phase 2. Not now.
79+
80+
---
81+
6782
## Recovery Functions
6883

6984
| Function | Purpose |

0 commit comments

Comments
 (0)