监控frankenphp worker模式需盯住四维度:进程长期稳定存在(ps观察worker数不跳变)、线程池水位(busy/total>0.8且queue_depth>0即饱和)、内存rss小幅波动无持续上涨、99%延迟阶梯式上升配合大量s态线程表明隐性满负荷。

确认 worker 进程长期稳定存在
执行 ps aux | grep frankenphp-worker,应持续看到固定数量的 worker 进程(由 workers.count 或 num_threads 控制),且 10 秒内不频繁增减。
用 watch -n 1 'ps aux | grep frankenphp-worker | wc -l' 观察:若数值跳变(如 4→0→5→0),说明 worker 频繁启停,非常驻;稳定在预期值(如始终为 8)才是正常。
Docker 环境下,docker ps 显示容器 Up 时间持续增长、Restart 为 0,是基础佐证。
检查线程池实时负载水位
通过 Caddy 的 Prometheus metrics 端点获取关键指标(需已启用 { prometheus :2019 } 或类似配置):
- curl http://127.0.0.1:2019/metrics | grep frankenphp_busy_threads → 当前正在执行 PHP 字节码的线程数
- curl http://127.0.0.1:2019/metrics | grep frankenphp_total_threads → 线程池总容量
- curl http://127.0.0.1:2019/metrics | grep frankenphp_queue_depth → 请求队列长度
重点关注比值:frankenphp_busy_threads / frankenphp_total_threads > 0.8 且 queue_depth > 0,说明线程池饱和,请求开始排队。
注意:该指标只在启用 php_server 或 worker 模式、显式配置线程数、Caddyfile 中启用 prometheus 时才有效。
验证内存是否长期稳定
执行 watch -n 1 'ps -o pid,rss,comm -p $(pgrep -f "frankenphp-worker")',观察 RSS 值:
- 启动后 2–3 分钟内快速爬升,之后在某区间小幅波动(如 ±5MB),属健康
- 若每分钟持续上涨超 2–3MB 且无回落,提示内存泄漏或缓存未复用
在 PHP 代码中加打点:error_log('peak: ' . memory_get_peak_usage(true));,压测后检查日志峰值是否单调递增——阶梯式上升即异常信号。
观察请求延迟与线程状态分布
用 htop -p $(pgrep -f frankenphp),按 H 切换线程视图,关注 STATE 列:
- 大量线程显示 S(sleep)而非 R(running),说明卡在 I/O、数据库、锁或下游响应上
- 此时即使 CPU 使用率低,但
queue_depth > 0,就是隐性满负荷
用 wrk -t4 -c200 -d30s http://localhost/health 测 99% 延迟:若从 120ms 飙升至 800ms+,而 QPS 下降不明显,说明请求积压在队列中,线程池已无冗余能力。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











