2022最新Python日志库logging总结

当我们需要了解程序的执行情况时，日志是非常重要的。日志不仅可以帮助我们发现问题，还可以提供很多有用的信息。Python的logging模块是一个非常强大的日志工具，支持多种日志级别和日志格式。本文将介绍Python日志库logging的使用方法，包括日志级别、日志输出格式、日志记录器和处理器等相关内容。

日志级别

Python的logging模块提供5种不同的日志级别，从低到高分别是：DEBUG、INFO、WARNING、ERROR和CRITICAL。默认情况下，日志记录器的日志级别为WARNING，即只有大于等于WARNING级别的日志才会被记录。可以通过设置日志记录器的日志级别来控制记录的日志级别。下面是一个简单的例子。

import logging

logging.warning('This is a warning message.')
logging.info('This is an info message.')

输出结果为：

WARNING:root:This is a warning message.

可以看到，只有WARNING级别的消息被记录了。如果需要记录INFO级别的消息，可以将日志记录器的级别调整为INFO。

import logging

logging.basicConfig(level=logging.INFO)

logging.warning('This is a warning message.')
logging.info('This is an info message.')

输出结果为：

WARNING:root:This is a warning message.
INFO:root:This is an info message.

日志输出格式

logging模块提供了多种日志输出格式，可以根据需要进行自定义。其中，最常用的两种格式是：

• %(asctime)s：日志记录时间
• %(message)s：日志记录消息

下面是一个输出格式包含上述两种信息的例子。

import logging

logging.basicConfig(format='%(asctime)s %(message)s', level=logging.INFO)

logging.info('This is an info message.')

输出结果为：

2022-01-01 00:00:00,000 This is an info message.

可以看到，输出结果中包含了日志记录时间和日志记录消息。

日志记录器

日志记录器是logging模块中最重要的组件之一，它负责决定日志消息的最终去处。一个应用程序通常需要多个日志记录器，每个日志记录器都有自己的名称和日志级别。默认情况下，所有的日志记录器都会被附加到根日志记录器(root logger)上。可以使用logging.getLogger()方法来获取一个日志记录器，如果该名称已经存在，则会返回相同的对象。

下面是一个简单的例子。

import logging

logger = logging.getLogger('my_logger')
logger.setLevel(logging.DEBUG)

logger.debug('This is a debug message.')
logger.info('This is an info message.')
logger.warning('This is a warning message.')

输出结果为：

WARNING:my_logger:This is a warning message.

可以看到，只有WARNING级别的消息被记录了。这是因为日志记录器的级别被设置为DEBUG，而默认情况下，根日志记录器的级别为WARNING。

日志处理器

日志处理器用于将日志消息发送到指定的目标，例如控制台、文件、Syslog等。Python的logging模块提供了多种内置的日志处理器，可以根据需要选择不同的处理器并进行配置。下面是一个将日志信息输出到文件中的例子。

import logging

logging.basicConfig(filename='example.log', format='%(asctime)s %(message)s', level=logging.INFO)

logging.info('This is an info message.')

在运行以上代码之后，一个example.log文件将会被创建，并记录相关的日志信息。

总结

本文介绍了Python日志库logging的基本使用方法，包括日志级别、日志输出格式、日志记录器和处理器等相关内容。使用日志可以帮助我们更好地了解程序的执行情况，进而发现和解决问题。