Monolog ^2.0日志拆分咨询：单日志被拆分为多条独立记录

该现象是否为预期行为？ #

这不是Monolog 2.x的预期行为。出现单条日志被拆分为多条独立条目的情况，通常是配置错误导致：要么未使用正确的JSON格式化器，日志未被序列化为完整的单行JSON对象；要么是下游日志收集工具错误地将日志按换行符或字段拆分处理。

如何配置以整体记录日志？ #

要确保日志作为整体记录，需从Monolog配置和下游工具两方面入手：

1. 为Monolog配置JsonFormatter #

必须为日志处理器绑定JsonFormatter，它会将日志的消息、上下文、级别等信息统一序列化为单行完整JSON，避免字段零散输出。示例代码：

use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Formatter\JsonFormatter;

// 初始化日志实例
$logger = new Logger('application');

// 创建文件处理器
$streamHandler = new StreamHandler(__DIR__ . '/app.log', Logger::INFO);

// 绑定JSON格式化器
$jsonFormatter = new JsonFormatter();
$streamHandler->setFormatter($jsonFormatter);

// 将处理器添加到日志实例
$logger->pushHandler($streamHandler);

// 记录日志
$logger->info('http://docker.for.mac.localhost:1000', [
    '$a' => 'val_a',
    '$b' => 'val_b',
    '$c' => 'val_c',
    '$d' => 'val_d',
]);

2. 检查下游日志收集工具的配置 #

如果使用了日志收集工具（如Filebeat、Fluentd），需确保工具配置为识别单行JSON为单条日志：

• 例如Filebeat中，保持json.keys_under_root默认值为false，避免将JSON字段拆分为独立日志条目；
• 确保工具不会按换行符或单个字段分割日志内容。

3. 排查自定义格式化器问题 #

如果使用了自定义格式化器，需验证其逻辑是否将所有日志数据（消息、上下文、级别等）合并为一个完整的JSON对象输出，而非单独输出每个字段。

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