Python logging模块|极客教程

Python logging模块

在编写代码的过程中，我们经常需要记录程序的运行状态、错误信息以及一些关键信息，以便于调试和追踪问题。Python的logging模块提供了强大的日志记录功能，可以帮助我们实现这些需求。在本文中，我们将详细介绍Python logging模块的使用方法，包括日志级别、日志格式、输出位置等内容。

日志级别

Python logging模块定义了几种日志级别，用于指示日志的严重程度。从低到高，这些级别包括：

DEBUG：详细的调试信息，通常用于开发和调试阶段。
INFO：一般信息，用于记录程序正常运行的情况。
WARNING：警告信息，表示潜在的问题。
ERROR：错误信息，表示程序发生了可恢复的错误。
CRITICAL：严重错误信息，表示程序发生了不可恢复的错误。

我们可以根据需要设置日志级别，只有达到设置的级别或者更高级别的日志才会被记录。

日志格式

日志格式指的是日志记录的文本格式，包括时间、级别、内容等信息。Python logging模块可以通过设置日志格式来控制日志记录的输出形式。常用的日志格式变量包括：

%(asctime)：日志时间
%(levelname)：日志级别
%(message)：日志内容

我们可以自定义日志格式，根据需要显示更多或者更少的信息。

输出位置

Python logging模块支持将日志记录输出到不同的位置，包括控制台、文件、网络等。我们可以通过配置不同的处理器（Handler）实现不同的输出位置。常用的处理器包括：

StreamHandler：将日志输出到控制台
FileHandler：将日志输出到文件
SocketHandler：将日志发送到网络 socket

我们可以根据需要选择合适的处理器来实现日志输出。

示例代码

下面是一个简单的示例代码，演示了如何使用Python logging模块记录日志：

import logging

# 创建Logger对象
logger = logging.getLogger('my_logger')
logger.setLevel(logging.DEBUG)

# 创建控制台Handler并设置日志级别
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.DEBUG)

# 创建日志格式
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
console_handler.setFormatter(formatter)

# 添加Handler到Logger对象
logger.addHandler(console_handler)

# 记录日志
logger.debug('This is a debug message')
logger.info('This is an info message')
logger.warning('This is a warning message')
logger.error('This is an error message')
logger.critical('This is a critical message')

在上面的代码中，我们首先创建了一个Logger对象，并设置了日志级别为DEBUG。然后创建了一个控制台Handler，并设置了日志级别为DEBUG，以及自定义的日志格式。最后将Handler添加到Logger对象中，通过Logger对象记录了不同级别的日志信息。

运行结果

运行上述示例代码，我们可以得到如下输出：

2020-10-02 15:23:45,123 - DEBUG - This is a debug message
2020-10-02 15:23:45,123 - INFO - This is an info message
2020-10-02 15:23:45,123 - WARNING - This is a warning message
2020-10-02 15:23:45,123 - ERROR - This is an error message
2020-10-02 15:23:45,123 - CRITICAL - This is a critical message