Skip to content

Commit f8ba2a8

Browse files
committed
docs: remove request log evidence guidance
1 parent d1d5d5e commit f8ba2a8

1 file changed

Lines changed: 0 additions & 36 deletions

File tree

docs-site/src/content/docs/operators/monitoring.mdx

Lines changed: 0 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,6 @@ Build your Grafana or Prometheus dashboard around the signals needed to correlat
3535
6. gateway admission accepted, queued, rejected, timed-out, and queue-time p95 signals
3636
7. stream-buffer oversized and truncated events
3737
8. Ecto query rate, queries per request, hot query sources by safe source and SQL command, unknown query rate, and DB queue p95
38-
9. admin request-log reload rate and p95 duration by bounded stage/scope tags: `initial_load`, `filter_patch`, `event_refresh`, `selected_pool`, and `all_pools`
3938

4039
Read the dashboard as a correlation view. If cgroup memory climbs while BEAM total stays flat, look outside normal BEAM heap attribution. If `vm_memory_binary_bytes` climbs with cgroup memory, inspect streaming response retention, file bodies, and upstream transport buffering. If process count, ports, or run queue climb, inspect stuck request processes, websocket ownership, and overloaded route classes.
4140

@@ -163,41 +162,6 @@ histogram_quantile(0.95,
163162
)
164163
```
165164

166-
```text
167-
sum by (stage, scope) (
168-
rate(codex_pooler_admin_request_logs_reload_count{
169-
namespace="codex-pooler",
170-
job="codex-pooler-app"
171-
}[5m])
172-
)
173-
```
174-
175-
```text
176-
histogram_quantile(0.95,
177-
sum by (le, stage, scope) (
178-
rate(codex_pooler_admin_request_logs_reload_duration_seconds_bucket{
179-
namespace="codex-pooler",
180-
job="codex-pooler-app"
181-
}[5m])
182-
)
183-
)
184-
```
185-
186-
## Request-log performance evidence
187-
188-
For request-log read-path remediation, collect metadata-only before/after evidence from a restored staging or local clone before deploying the change. Use an authenticated admin session to refresh the request-log page with the same filters operators will use, then compare the baseline and verification outputs from the same evidence window.
189-
190-
The evidence should answer four questions before production rollout:
191-
192-
1. Did the verification window stop using the legacy expensive request-log read path?
193-
2. Did projection coverage match the restored dataset after migration?
194-
3. Did `pg_stat_statements` and database temp-byte deltas stay flat enough to rule out new temp-file pressure?
195-
4. Did application logs stay free of DB ownership timeout, queue pressure, or request-log reload timeout warnings during authenticated admin refreshes?
196-
197-
Keep the captured files to aggregate counters, plan shape, projection coverage counts, HTTP status, timing, and byte-size summaries only. Never collect cookies, headers, request bodies, response bodies, prompts, bearer tokens, Pool API keys, upstream tokens, websocket frames, raw SQL params, raw `pg_stat_statements.query`, raw idempotency keys, or private admin credentials as evidence.
198-
199-
Use the Grafana request-log reload panels with the generic repo query panels: reload count and duration isolate operator page pressure, while repo query rate, hot safe query sources, DB queue p95, `pg_stat_statements` deltas, `pg_stat_database` temp-byte deltas, and projection coverage prove whether the request-log projection removed the legacy expensive read path without introducing temp-file pressure.
200-
201165
## Memory sampler logs
202166

203167
The in-process memory sampler is enabled by default in every release role. When BEAM total memory or cgroup usage crosses the configured threshold, it logs a sanitized snapshot with role metadata, memory categories, cgroup memory stats, process and port counts, top processes by memory, top processes by message queue length, and top ETS tables by memory. It never logs ETS table contents, messages, request bodies, prompts, bearer tokens, websocket frames, or upstream payloads.

0 commit comments

Comments
 (0)