python logging 模块是一个强大的工具，可用于在 Python 应用程序中记录消息和事件。它的复杂性可能会让初学者望而却步，但掌握其功能对于有效管理日志记录至关重要。本文将深入探讨 logging 模块，揭开其谜团，帮助您充分利用其功能。

基础概念

• 日志记录器：一个可被应用程序使用的对象，用于生成日志记录事件。
• 处理器：一个对象，负责将日志记录事件写入目标（例如文件、数据库）。
• 过滤器：一个对象，用于根据特定条件过滤日志记录事件。
• 日志级别：一种用于指定日志记录事件严重程度的枚举类型（例如 DEBUG、INFO、ERROR）。

配置 Logging

配置 logging 模块的第一步是创建 logging 配置器。这是一个全局对象，允许您指定日志记录器、处理器和过滤器。下面是一个示例配置：

import logging

# 创建一个 logging 配置器
logging.basicConfig(
level=logging.INFO,# 设置日志记录级别为 INFO
fORMat="%(asctime)s - %(levelname)s - %(message)s",# 设置日志记录格式
filename="my_app.log"# 设置日志文件路径
)

创建日志记录器

要在应用程序中使用日志记录，您需要创建一个日志记录器：

import logging

# 获取名为 "my_logger" 的日志记录器
logger = logging.getLogger("my_logger")

记录日志事件

您可以使用日志记录器记录事件：

logger.debug("This is a debug message")
logger.info("This is an info message")
logger.error("This is an error message")

定制日志记录

Logging 模块允许您定制日志记录行为。您可以指定处理器、过滤器和日志级别：

• 处理器：您可以添加多个处理器来将日志记录事件写入不同的目标（例如文件、控制台）：

handler = logging.FileHandler("custom.log")
logger.addHandler(handler)

• 过滤器：您可以添加过滤器以根据特定条件过滤日志记录事件：

filter = logging.Filter()
filter.filter = lambda record: record.levelno == logging.INFO
logger.addFilter(filter)

• 日志级别：您可以设置日志记录级别以仅记录您感兴趣的事件：

logger.setLevel(logging.WARNING)

其他有用功能

• 命名空间：您可以创建具有不同名称空间的日志记录器，这对于组织大型应用程序中的日志记录非常有用。
• 处理程序类： Logging 模块提供了一些内置的处理程序类，例如 FileHandler 和 StreamHandler。
• 格式化器：您可以自定义日志记录事件的格式，例如添加时间戳或线程 ID。

结论

Python logging 模块是一个功能强大的工具，可用于管理应用程序中的日志记录。通过了解其基础概念、配置方法和定制选项，您可以掌握其复杂性并有效地使用它来记录和处理应用程序事件。