hyperf 通过自定义进程与独立监控进程实现后台任务可观测性,重点监控“做什么、做得好不好”。自定义进程自带自动拉起、多副本、动态启停;监控进程每5秒采集指标并上报prometheus,/metrics接口暴露数据,支持cli快速调试。

Hyperf 的核心进程管理本身不提供内置的“进程级”实时状态面板,但通过组合自定义进程、独立监控进程和指标采集机制,可以实现对关键后台任务的可观测性。重点不在“看进程是否活着”,而在于“它在做什么、做得好不好”。
自定义进程自带高可用保障
Hyperf 的自定义进程(AbstractProcess)默认具备自动拉起能力:只要进程意外退出,主 Server 会立即重启它。这意味着你不需要手动写心跳检测或进程保活脚本。
- 进程启动即注册,随服务启动而运行,生命周期与主服务一致
- 支持
nums配置,可一键启动多个副本(如数据清理双实例防单点失败) - 可通过
isEnable($server)方法按环境或配置动态启用/禁用,适合灰度发布
用独立监控进程采集业务状态
推荐新建一个专用的监控类进程,不处理业务,只负责采集和上报——比如每 5 秒检查一次队列积压数、缓存命中率、磁盘使用率等。
- 继承
AbstractProcess,在handle()中调用业务服务或系统命令获取指标 - 配合
hyperf/metric上报到 Prometheus(如$gauge->set($queueLength)) - 日志建议用
StdoutLoggerInterface,便于统一收集(如对接 ELK 或 Loki)
指标暴露与外部观测
Hyperf 默认启用 use_standalone_process => true,监控数据由独立进程采集并暴露 HTTP 接口,完全隔离于业务请求链路。
- 默认路径
/metrics,端口9502(可在config/autoload/metric.php修改) - Prometheus 可直接抓取,Grafana 配置对应仪表盘即可看到进程相关指标趋势
- 自定义指标支持 Counter(累计值)、Gauge(瞬时值)、Histogram(分布耗时),覆盖多数监控场景
辅助调试与现场排查
除长期监控外,还可结合 CLI 工具快速验证进程行为:
- 执行
php bin/hyperf.php process:list查看已注册的自定义进程名与状态 - 用
ps aux | grep monitor_process确认 OS 层进程是否存在(适用于注解注册的进程) - 在
handle()中加入简单日志(如$logger->info("tick @ ".date('H:i:s'))),确认循环是否持续执行










