博客

python 日志 logging模块详细解析

  • Post category:Python

Python日志logging模块详细解析

Python日志logging模块是Python标准库中的一个模块，它提供了一个灵活的日志记录系统，可以用于记录应用程序的运行状态、错误信息等。本文将详细介绍Python日志logging模块的使用方法和示例说明。

logging模块的基本使用

logging模块提供了一个Logger类，用于创建一个日志记录器。我们可以通过Logger类的方法来记录日志信息。下面是一个简单的示例：

import logging

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

# 设置日志级别
logger.setLevel(logging.DEBUG)

# 创建一个文件处理器
fh = logging.FileHandler('mylog.log')

# 创建一个控制台处理器
ch = logging.StreamHandler()

# 设置日志格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
fh.setFormatter(formatter)
ch.setFormatter(formatter)

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

# 记录日志信息
logger.debug('debug message')
logger.info('info message')
logger.warning('warning message')
logger.error('error message')
logger.critical('critical message')

在以上示例中，我们首先创建了一个日志记录器logger，然后设置了日志级别为DEBUG。接着，我们创建了一个文件处理器fh和一个控制台处理器ch，并设置了日志格式。最后，我们将处理器添加到日志记录器中，并记录了一些日志信息。

日志级别

logging模块提供了5个日志级别，分别是DEBUG、INFO、WARNING、ERROR和CRITICAL。这些日志级别按照严重程度递增，DEBUG级别最低，CRITICAL级别最高。我们可以通过设置日志级别来控制记录哪些级别的日志信息。

日志处理器

logging模块提供了多种日志处理器，用于将日志信息输出到不同的地方。常用的日志处理器有：

  • StreamHandler：将日志信息输出到控制台。
  • FileHandler：将日志信息输出到文件。
  • RotatingFileHandler：将日志信息输出到文件，并支持日志文件的自动轮换。
  • SMTPHandler：将日志信息通过邮件发送。

我们可以根据需要选择不同的日志处理器。

日志格式

logging模块提供了多种日志格式，用于控制日志信息的输出格式。常用的日志格式有：

  • %(asctime)s：日志记录时间。
  • %(name)s：日志记录器名称。
  • %(levelname)s：日志级别名称。
  • %(message)s：日志信息。

我们可以根据需要选择不同的日志格式。

示例说明

以下是两个使用logging模块的示例：

示例一：将日志信息输出到文件

import logging

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

# 设置日志级别
logger.setLevel(logging.DEBUG)

# 创建一个文件处理器
fh = logging.FileHandler('mylog.log')

# 设置日志格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
fh.setFormatter(formatter)

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

# 记录日志信息
logger.debug('debug message')
logger.info('info message')
logger.warning('warning message')
logger.error('error message')
logger.critical('critical message')

在以上示例中，我们创建了一个日志记录器logger，并设置了日志级别为DEBUG。然后，我们创建了一个文件处理器fh，并设置了日志格式。最后，我们将处理器添加到日志记录器中，并记录了一些日志信息。这些日志信息将被输出到文件mylog.log中。

示例二：将日志信息输出到控制台和文件

import logging

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

# 设置日志级别
logger.setLevel(logging.DEBUG)

# 创建一个文件处理器
fh = logging.FileHandler('mylog.log')

# 创建一个控制台处理器
ch = logging.StreamHandler()

# 设置日志格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
fh.setFormatter(formatter)
ch.setFormatter(formatter)

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

# 记录日志信息
logger.debug('debug message')
logger.info('info message')
logger.warning('warning message')
logger.error('error message')
logger.critical('critical message')

在以上示例中，我们创建了一个日志记录器logger，并设置了日志级别为DEBUG。然后，我们创建了一个文件处理器fh和一个控制台处理器ch，并设置了日志格式。最后，我们将处理器添加到日志记录器中，并记录了一些日志信息。这些日志信息将被同时输出到控制台和文件mylog.log中。

总结

本文介绍了Python日志logging模块的使用方法和示例说明。logging模块提供了一个灵活的日志记录系统，可以用于记录应用程序的运行状态、错误信息等。我们可以通过设置日志级别、选择不同的日志处理器和日志格式来控制日志信息的输出。使用logging模块可以帮助我们更好地了解应用程序的运行状态，从而更好地进行调试和优化。

Tags: