Monolog的Handler选型直接决定日志可靠性：RotatingFileHandler用于归档，SocketHandler需配SSL与超时防阻塞，禁用多Handler写同一文件，上下文应结构化注入request_id等字段，生产环境禁用debug，统一使用JsonFormatter确保Loki/ELK可解析。
Monolog 的 Handler 选型直接影响日志是否可靠落地
日志写不进文件、远程服务丢数据、高并发下日志错乱——这些问题八成出在 Handler 配置上，而不是日志内容本身。Monolog 默认的 StreamHandler 在单机小流量下没问题，但企业级场景必须区分用途：RotatingFileHandler 用于本地归档（自动按天/大小切分），SyslogHandler 或 SocketHandler 用于对接 Fluentd / Loki；若用 NullHandler 测试时忘了删，线上就真“静音”了。
关键细节：
-
RotatingFileHandler的$maxFiles参数别设太小，否则旧日志被清太快，排查问题时发现“上周的日志没了” - 用
SocketHandler发送到 rsyslog 或 Loki 时，务必启用useSSL和设置超时（timeout），否则网络抖动会导致日志阻塞主线程 - 避免多个
Handler写同一文件（比如同时配了StreamHandler和RotatingFileHandler），会触发文件锁冲突，部分日志丢失
上下文（context）不是 dump 数组的快捷键
很多人把 Logger::error('DB query failed', $e->getTrace()) 当成“注入上下文”，结果日志里塞进几万字符的 trace 字符串，既难读又拖慢写入。Monolog 的 context 是结构化载体，不是调试输出口。真正该放进去的是稳定、可筛选的字段：用户 ID、请求 ID、订单号、HTTP 状态码。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 统一在中间件或 Base Controller 中生成
request_id，通过Logger::pushProcessor()注入到每条日志的 context，避免每个info()都手动传 - 敏感字段如
password、token必须在写入前过滤，Monolog 不做脱敏，processors里加一层array_walk_recursive清洗 - 不要把整个
$_SERVER或$e对象扔进 context —— JSON 编码会失败，且占用磁盘空间翻倍
日志级别不是靠 guess，得和错误类型、SLA 绑定
企业系统里，“Warning” 和 “Error” 不是语义差别，而是告警响应等级和 SLO 计算依据。比如支付回调超时应记 error（触发 PagerDuty），而缓存未命中记 notice（仅聚合看趋势）。Monolog 的 Level 常量（Logger::ERROR、Logger::WARNING）背后要对应明确的运维规则。
容易踩的坑：
- 第三方 SDK 抛出的
Exception默认记error，但有些只是临时限流，应捕获后降级为warning，否则告警风暴 -
Logger::debug()在生产环境必须关闭（通过Logger::setLevel(Logger::INFO)），否则 I/O 暴涨，尤其在 Laravel 的APP_DEBUG=true未关时 - 自定义 level 如
audit或security需配合CustomLevelHandler，不能只改字符串，否则日志聚合工具（如 Grafana Loki）无法识别
日志聚合前，格式必须对齐且可解析
Loki、ELK 或 Datadog 要靠日志行结构提取 labels 和 fields。Monolog 默认输出是纯文本，LineFormatter 只能解决换行和时间格式，真正的结构化得靠 JsonFormatter + 统一字段命名。否则你会在 Grafana 里看到一堆 message="user login failed"，却没法按 user_id 过滤。
必须做的三件事：
- 所有
Handler统一用JsonFormatter，并设置$formatter->includeStacktraces(false)，堆栈单独走 error handler - 固定顶层字段名：例如强制用
level（非severity）、time（ISO8601）、service（服务名）、trace_id（非request_id），避免不同服务日志字段不一致 - 日志路径按服务隔离：
/var/log/myapp/api.log、/var/log/myapp/worker.log，Loki 的joblabel 才能准确打标
最常被忽略的一点：PHP-FPM 的 slowlog 和 Monolog 日志是两套体系，别指望用 Monolog 格式去解析 slowlog；它们得各自接入、再关联分析。
