ThinkPHP6.1分布式监控体系需围绕日志归集、状态透出、事件联动、异常收敛四环节构建，依托原生命令行+Redis事件总线+轻量日志采集器，实现多实例间可感知、可追溯、可干预的闭环。
ThinkPHP6.1分布式部署下，统一监控体系不是靠“加一个监控面板”就能实现的，而是要围绕日志归集、状态透出、事件联动、异常收敛四个核心环节设计。它不依赖中心化Agent，而是利用TP6.1原生命令行能力+Redis事件总线+轻量日志采集器，在多实例间建立可感知、可追溯、可干预的闭环。
日志标准化与跨节点归集
分布式环境下各节点日志分散，必须统一格式和传输路径：
- 在config/log.php中强制启用
single驱动并指定file_path为共享存储路径（如NFS挂载点或阿里云NAS），避免本地runtime/log写入隔离 - 每条日志开头注入实例标识：
[node-01][20261022-1819]，可通过重写think\log\driver\File类的write方法注入 - 用
tail -F+rsyslog或filebeat实时采集日志流，转发至ELK或Loki集群，不建议直接读取文件轮询
服务健康状态主动上报
不能等出问题才查，每个TP6.1实例需定时“自报家门”：
- 新建
command/HealthReport.php命令行任务，调用think\facade\Cache::get('server_info')获取内存占用、请求QPS、Redis连通性等指标 - 通过
Redis::setex('health:node-01', 60, json_encode([...]))将状态存入共享Redis，TTL设为略大于上报间隔（如60秒） - 用
php think health:report配合cron每30秒执行一次，避免使用sleep阻塞主进程
支付与订单事件统一追踪
针对免签收款类业务（如APP监听到账系统），事件必须穿透实例边界：
立即学习“PHP免费学习笔记（深入）”；
- 所有支付回调入口（如
/api/alipay/notify）在处理前先向Redis发布事件：publish event:payment:received {order_id:xxx, channel:alipay} - 另起一个ThinkPHP命令行守护进程（
php think event:listen），订阅该频道，完成幂等校验、库存扣减、消息推送等后续动作 - 关键操作记录到
event_trace表，字段含trace_id（UUIDv4）、node_id、event_type、status，便于全链路回溯
异常告警与自动熔断
监控最终要能触发动作，而非只看图表：
- 用
think\exception\Handle重写render方法，在500错误发生时向redis pub/sub推送告警事件，并记录到error_log表 - 配置Prometheus+Alertmanager：通过
/metrics接口暴露自定义指标（如tp6_http_request_total{status="500"}），当5分钟内500错误超10次，自动触发企业微信机器人告警 - 对高频失败接口（如微信回调验证），在
config/app.php中启用'app_middleware' => ['throttle']限流中间件，防雪崩
