Python logging：如何定位日志消息的来源？

当然可以，Python的logging模块原生支持在日志输出中包含日志记录器名称（即日志来源的包/模块名），这是定位第三方包日志的核心方法。以下是具体实现方案：

1. 修改日志格式，添加记录器名称 #

调整全局日志的格式化字符串，加入%(name)s字段，就能在每条日志里显示对应的日志记录器名称（通常就是第三方包的模块名，比如requests、urllib3）。

示例代码：

import logging

# 配置全局日志格式
logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)

配置后输出的日志会类似：

2024-05-20 14:30:00,123 - requests.packages.urllib3.connectionpool - INFO - Starting new HTTP connection (1): example.com:80

从requests.packages.urllib3.connectionpool就能直接定位到这条日志来自urllib3模块，属于requests的依赖包。

2. 查看所有活跃的日志记录器 #

如果想提前排查当前应用中所有注册的日志记录器（包括第三方包的），可以遍历logging.Logger.manager.loggerDict，它包含了所有已创建的日志记录器：

import logging

# 打印所有已注册的日志记录器名称
for logger_name in logging.Logger.manager.loggerDict:
    print(logger_name)

运行后会输出类似内容：

requests
urllib3
flask
myapp.utils

这些就是当前应用中可能产生日志的潜在来源。

3. 针对性控制第三方包日志 #

识别出日志来源后，就可以单独调整某个包的日志级别，甚至直接禁用它的日志输出：

# 禁用urllib3的所有日志（设置为CRITICAL以上，等同于不输出任何日志）
logging.getLogger('urllib3').setLevel(logging.CRITICAL + 1)

# 仅让requests输出WARNING及以上级别的日志
logging.getLogger('requests').setLevel(logging.WARNING)

注意事项 #

• 多数规范的第三方包会用自身模块名作为日志记录器名称，但少数包可能直接使用根记录器，需要结合日志内容进一步判断。
• 若日志记录器名称存在层级（比如requests.packages.urllib3），调整父级记录器的级别会影响所有子级（比如设置requests的级别，会同步限制其下urllib3模块的日志）。

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