Python日志logger用法

在日常开发中，日志的使用是非常重要的。它可以帮助我们定位问题、调试代码，同时也可以提供程序的运行状态。Python中的logging模块提供了强大的日志功能，方便我们在程序中记录和处理日志信息。

在本文中，我们将详细介绍Python的日志模块logging的用法，包括创建日志记录器、设置日志级别、添加日志处理器以及使用格式化输出等。

1. 创建日志记录器

要使用日志功能，首先需要创建一个日志记录器。在logging模块中，通过调用logging.getLogger(name)方法创建一个日志记录器对象。

示例代码如下：

import logging

# 创建一个名为logger的日志记录器
logger = logging.getLogger('logger')

2. 设置日志级别

日志级别用于确定要记录的日志的严重性。logging模块定义了以下日志级别，按严重程度递增排列：

DEBUG：最详细的日志信息，用于调试程序。
INFO：用于确认程序按预期运行。
WARNING：指示发生了一些意外情况或警告，但程序仍然可以正常运行。
ERROR：由于更严重的问题，程序未能执行某些功能。
CRITICAL：最高级别的日志，指示致命的错误，可能导致程序中断。

可以通过调用logger.setLevel(level)方法设置日志记录器的日志级别。

示例代码如下：

logger.setLevel(logging.DEBUG)

3. 添加日志处理器

日志处理器用于指定日志输出的位置和格式。logging模块定义了多种日志处理器，包括：

StreamHandler：将日志输出到流，如控制台。
FileHandler：将日志输出到文件。
RotatingFileHandler：将日志输出到文件，并可以设置日志文件的大小，当日志文件大小达到一定限制时，会自动创建新的日志文件。
TimedRotatingFileHandler：将日志输出到文件，并可以根据时间轮换日志文件。

可以通过调用logger.addHandler(handler)方法为日志记录器添加日志处理器。

示例代码如下：

import logging
from logging.handlers import RotatingFileHandler

# 创建一个名为logger的日志记录器
logger = logging.getLogger('logger')

# 创建一个RotatingFileHandler类型的日志处理器，并将日志输出到文件logger.log
handler = RotatingFileHandler('logger.log', maxBytes=1024*1024, backupCount=5)

# 将日志处理器添加到日志记录器
logger.addHandler(handler)

4. 使用格式化输出

可以通过设置日志处理器的格式来定义日志输出的样式。logging模块定义了多个格式化选项，可以按需组合使用。

下面是一些常用的格式化选项：

%(asctime)s：日志的创建时间。
%(levelname)s：日志的级别名称。
%(name)s：日志记录器的名称。
%(message)s：日志的消息内容。

示例代码如下：

import logging
from logging.handlers import RotatingFileHandler

# 创建一个名为logger的日志记录器
logger = logging.getLogger('logger')

# 创建一个RotatingFileHandler类型的日志处理器，并将日志输出到文件logger.log
handler = RotatingFileHandler('logger.log', maxBytes=1024*1024, backupCount=5)

# 设置日志处理器的输出格式
handler.setFormatter(logging.Formatter('%(asctime)s - %(levelname)s - %(name)s - %(message)s'))

# 将日志处理器添加到日志记录器
logger.addHandler(handler)

5. 记录日志

使用logger对象记录日志非常简单，只需调用相应级别的方法即可。

示例代码如下：

import logging

# 创建一个名为logger的日志记录器
logger = logging.getLogger('logger')

# 输出日志
logger.debug('This is a debug log')
logger.info('This is an info log')
logger.warning('This is a warning log')
logger.error('This is an error log')
logger.critical('This is a critical log')