test: capture backlog resource samples

2026-09-20 15:03:19 +08:00
parent 465349cd6d
commit b057af21b1
3 changed files with 53 additions and 5 deletions
--- a/docs/api/schedule-load.md
+++ b/docs/api/schedule-load.md
@@ -22,6 +22,8 @@ go run ./cmd/orbit-schedule-load \

 要观察持久化积压，可在一次性数据库使用 `-schedules 32 -requests 8 -workers 1 -capacity 1 -start-delay 5s -run-timeout 180s`。该配置会让256个触发点集中进入队列，报告预期非零并保留未核验分母；独立连接应每2秒读取 `pulse_tasks` 的 `WAITING/LEASED/RUNNING/SUCCEEDED` 计数，示例结果见[长期积压报告](../reports/phase-6-backlog.md)。仓库还提供[`scripts/test-schedule-backlog.sh`](../../scripts/test-schedule-backlog.sh)自动创建/清理一次性 MySQL、采样状态和执行最终外键核验。

+积压脚本同时启用临时指标监听，每2秒把服务进程 CPU/RSS、MySQL 容器 CPU/内存、DB 连接池使用量、连接池等待累计值、等待/运行任务和业务快照耗时计数写入 `metrics.jsonl`。设置 `ORBIT_TEST_KEEP_ARTIFACTS=1`（可配合 `ORBIT_TEST_KEEP_ARTIFACTS_PATH`）会保留该文件；它是单节点采样原始证据，不是跨节点聚合或生产容量报告。
+
 ## 参数边界

 | 参数 | 默认值 | 限制/语义 |