Python日志处理模块logging用法解析

在Python中，logging模块是一个非常有用的工具，可以帮助我们记录程序运行时的信息，以便于调试和排错。本文将详细讲解Python日志处理模块logging的用法和解析。

logging模块的基本用法

logging模块提供了多种日志级别，包括DEBUG、INFO、WARNING、ERROR、CRITICAL等。以下是一个使用logging模块记录日志的示例：

import logging

logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')
logging.debug('This is a debug message')
logging.info('This is an info message')
logging.warning('This is a warning message')
logging.error('This is an error message')
logging.critical('This is a critical message')

在上面的代码中，我们使用logging模块记录了5个不同级别的日志。使用basicConfig()函数来配置日志级别和日志格式，使用debug()、info()、warning()、error()、critical()函数来记录不同级别的日志。

logging模块的高级用法

logging模块提供了多种高级用法，包括日志过滤、日志处理器、日志格式化器等。以下是一些常用的高级用法：

1. 日志过滤

使用日志过滤可以控制哪些日志记录下来，哪些日志忽略。以下是一个使用日志过滤记录日志的示例：

import logging

class MyFilter(logging.Filter):
    def filter(self, record):
        return record.levelno == logging.DEBUG

logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')
logger = logging.getLogger(__name__)
logger.addFilter(MyFilter())
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')

在上面的代码中，我们使用日志过滤控制只记录DEBUG级别的日志。使用Filter类来定义一个自定义的日志过滤器，使用addFilter()函数将过滤器添加到logger对象中。

2. 日志处理器

使用日志处理器可以将日志记录到不同的位置，比如文件、数据库、邮件等。以下是一个使用日志处理器记录日志的示例：

import logging

logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')
logger = logging.getLogger(__name__)

# 创建一个文件处理器
handler = logging.FileHandler('example.log')
handler.setLevel(logging.DEBUG)

# 创建一个格式化器
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)

# 将处理器添加到logger对象中
logger.addHandler(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')

在上面的代码中，我们使用日志处理器将日志记录到文件中。使用FileHandler类创建一个文件处理器，使用setLevel()函数设置处理器的日志级别，使用Formatter类创建一个格式化器，使用setFormatter()函数将格式化器添加到处理器中，使用addHandler()函数将处理器添加到logger对象中。

3. 日志格式化器

使用日志格式化器可以控制日志的输出格式。以下是一个使用日志格式化器记录日志的示例：

import logging

logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')
logger = logging.getLogger(__name__)

# 创建一个格式化器
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')

# 创建一个控制台处理器
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.DEBUG)
console_handler.setFormatter(formatter)

# 创建一个文件处理器
file_handler = logging.FileHandler('example.log')
file_handler.setLevel(logging.DEBUG)
file_handler.setFormatter(formatter)

# 将处理器添加到logger对象中
logger.addHandler(console_handler)
logger.addHandler(file_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')

在上面的代码中，我们使用日志格式化器控制日志的输出格式。使用Formatter类创建一个格式化器，使用setFormatter()函数将格式化器添加到处理器中。

示例1：使用日志过滤记录DEBUG级别的日志

以下是一个使用日志过滤记录DEBUG级别的日志的示例：

import logging

class MyFilter(logging.Filter):
    def filter(self, record):
        return record.levelno == logging.DEBUG

logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')
logger = logging.getLogger(__name__)
logger.addFilter(MyFilter())
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')

在上面的代码中，我们使用日志过滤控制只记录DEBUG级别的日志。使用Filter类来定义一个自定义的日志过滤器，使用addFilter()函数将过滤器添加到logger对象中。

示例2：使用日志处理器将日志记录到文件中

以下是一个使用日志处理器将日志记录到文件中的示例：

import logging

logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')
logger = logging.getLogger(__name__)

# 创建一个文件处理器
handler = logging.FileHandler('example.log')
handler.setLevel(logging.DEBUG)

# 创建一个格式化器
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)

# 将处理器添加到logger对象中
logger.addHandler(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')

在上面的代码中，我们使用日志处理器将日志记录到文件中。使用FileHandler类创建一个文件处理器，使用setLevel()函数设置处理器的日志级别，使用Formatter类创建一个格式化器，使用setFormatter()函数将格式化器添加到处理器中，使用addHandler()函数将处理器添加到logger对象中。