Pino日志库中如何正确配置日志级别输出

问题背景

在使用Pino日志库时，开发者经常会遇到日志级别配置不生效的问题。特别是当需要输出trace和debug级别的日志时，即使设置了level为trace，仍然无法看到这些低级别的日志输出。

常见错误配置

很多开发者会像下面这样配置Pino日志：

const transport = pino.transport({
    targets: [
        {
            target: 'pino/file',
            options: {
                destination: 'logs.txt',
                mkdir: true,
                colorize: false,
                level: 'trace', // 错误的位置
            }
        },
        {
            target: 'pino-pretty',
            options: {
                translateTime: "SYS:dd-mm-yyyy HH:MM:ss",
                destination: process.stdout.fd,
                colorize: true,
                level: 'trace', // 错误的位置
            }
        }
    ]
});

export const logger = pino({
    browser: {
        disabled: false
    },
    level: 'trace', // 主配置
}, transport);

这种配置方式会导致trace和debug级别的日志仍然无法输出，因为日志级别配置被放在了错误的options对象中。

正确配置方法

Pino日志库的传输器(transport)配置中，日志级别应该直接放在target对象中，而不是options对象内。正确的配置方式如下：

const transport = pino.transport({
    targets: [
        {
            target: 'pino/file',
            level: 'trace', // 正确的位置
            options: {
                destination: 'logs.txt',
                mkdir: true,
                colorize: false,
            }
        },
        {
            target: 'pino-pretty',
            level: 'trace', // 正确的位置
            options: {
                translateTime: "SYS:dd-mm-yyyy HH:MM:ss",
                destination: process.stdout.fd,
                colorize: true,
            }
        }
    ]
});

配置层级解析

Pino日志库的日志级别配置实际上有三个层级：

1. 主日志配置：通过pino()函数的第一个参数设置，影响所有传输器
2. 传输器级别配置：在transport.targets数组中每个target对象上设置，只影响该传输器
3. 传输器选项配置：在options对象中设置，通常不包含level配置

日志级别继承规则

Pino日志库的日志级别遵循以下继承规则：

1. 如果没有在传输器中明确设置level，则继承主配置的level
2. 如果在传输器中设置了level，则覆盖主配置的level
3. 传输器options中的level配置通常会被忽略

最佳实践建议

1. 对于生产环境，建议将主配置设为info级别，只在需要调试的传输器中单独设置trace/debug级别
2. 开发环境可以全局设置为trace级别以便调试
3. 对于文件日志和终端日志，可以设置不同的级别，例如文件记录所有日志而终端只显示重要日志

总结

正确理解Pino日志库的配置层级对于实现预期的日志输出至关重要。记住日志级别应该直接配置在transport.targets数组中的每个target对象上，而不是放在options对象内。通过这种配置方式，开发者可以灵活控制不同输出目标的日志级别，满足各种开发和运维场景的需求。