Monolog的buffer_size等配置项说明及请求超时日志缺失排查咨询

核心配置项含义 #

• buffer_size：你的理解完全正确，它定义了日志缓冲队列的最大容量。日志消息不会实时写入目标Handler，而是先暂存到缓冲区，直到以下任一条件触发才批量发送：缓冲区消息数量达到buffer_size设定值，或者请求/脚本正常执行完成。
• stop_buffering：当产生指定级别及以上的日志时，立即终止缓冲机制——将缓冲区中所有暂存的日志连同这条触发日志一次性输出，且后续所有日志都不再走缓冲，直接实时写入。例如设置为ERROR级别后，只要有ERROR级日志生成，所有缓冲日志会立刻刷出，后续日志均实时处理。
• passthru_level：指定一个日志级别阈值，所有等于或高于该级别的日志会绕过缓冲区，直接实时写入目标Handler，不受缓冲规则约束。比如设为CRITICAL，那么CRITICAL及更高级别的日志会直接输出，其他级别仍按缓冲逻辑处理。

504请求日志丢失的原因及解决办法 #

当PHP-FPM触发request_terminate_timeout强制终止请求进程时，进程没有机会执行正常的收尾流程——Monolog在请求结束时批量刷写缓冲区的操作根本无法执行，导致缓冲区中暂存的日志全部丢失。

针对这个问题，可采用以下方案：

1. 调整passthru_level：将passthru_level设置为你需要确保不丢失的最低日志级别（如ERROR），这样关键日志会绕过缓冲直接写入，即便进程被强制终止也不会丢失。
2. 降低buffer_size：减小缓冲队列的容量，让日志更频繁地批量写入，减少单次丢失的日志数量，但无法完全避免极端场景下的丢失。
3. 禁用缓冲（谨慎使用）：如果业务对日志实时性要求极高，可以直接关闭缓冲，但会带来一定的性能损耗。
4. 使用持久化缓冲Handler：选择支持持久化的Handler（如RedisHandler）作为缓冲层，即使进程被终止，缓冲的日志也会被持久化存储，后续可通过脚本批量同步到目标日志存储。

内容的提问来源于stack exchange，提问作者Bogdan Dubyk