Winston-Loki无法输出Debug日志问题排查求助

核心问题定位 #

winston-loki的level参数仅支持单个字符串级别，不接受数组格式，你之前传入['info', 'debug']的写法是错误的，这会导致级别配置失效。同时winston全局日志级别优先级高于transport级别，必须先确保全局级别允许捕获目标日志。

分步解决方案 #

1. 确保winston全局日志级别配置正确

winston的日志级别优先级从低到高为：debug < info < warn < error。要捕获debug日志，必须将logger的全局级别设置为debug（或更低级别），否则即使transport配置正确，全局会先过滤掉debug日志。

示例代码：

const winston = require('winston');
const LokiTransport = require('winston-loki');

const logger = winston.createLogger({
  level: 'debug', // 全局级别设为debug，确保所有>=debug的日志能被处理
  format: winston.format.json(),
  transports: [
    // 这里添加LokiTransport
  ]
});

2. 正确配置winston-loki的级别，并按需过滤特定级别

winston-loki的level参数设置该transport接收的最低日志级别，如果需要仅保留特定级别（比如info+debug、info+error），需要配合winston的format.filter来实现。

示例1：仅捕获debug和info日志

const logger = winston.createLogger({
  level: 'debug',
  format: winston.format.combine(
    // 过滤仅保留指定级别
    winston.format.filter(info => ['debug', 'info'].includes(info.level)),
    winston.format.json()
  ),
  transports: [
    new LokiTransport({
      host: '你的Loki主机地址',
      level: 'debug', // 这里设为debug，确保transport接收所有>=debug的日志，再通过format过滤
      labels: { app: '你的应用名称' }
    })
  ]
});

示例2：仅捕获info和error日志

const logger = winston.createLogger({
  level: 'info', // 全局级别设为info即可，因为error级别高于info
  format: winston.format.combine(
    winston.format.filter(info => ['info', 'error'].includes(info.level)),
    winston.format.json()
  ),
  transports: [
    new LokiTransport({
      host: '你的Loki主机地址',
      level: 'info',
      labels: { app: '你的应用名称' }
    })
  ]
});

3. 验证Loki查询配置

日志成功发送到Loki后，需确保在Loki界面查询时：

• 选择了正确的日志标签（比如你设置的app标签）
• 查询语句包含目标级别，比如查询debug日志需添加{level="debug"}，或用|~ "debug|info"匹配多个级别

4. 排查版本兼容性

如果以上配置仍不生效，建议升级winston和winston-loki到最新稳定版本，旧版本可能存在级别处理的bug：

npm update winston winston-loki

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