Python如何做日志记录？调试与监控技巧-Python教程-PHP中文网

Python如何做日志记录？调试与监控技巧

星夢妙者

发布： 2025-08-02 14:29:01

原创

504人浏览过

使用python的logging模块可构建结构化日志系统，首先导入模块并配置logger，设置日志级别和格式，如logging.basicconfig()；其次可通过filehandler将日志输出到文件；还可使用logging.config通过配置文件灵活管理日志设置；此外支持高级功能如filters、自定义handlers；集成时应确保一致性、可配置性和性能优化；也可选用loguru或structlog等第三方库简化操作；最后结合elk、splunk等工具实现日志分析与监控。

Python如何做日志记录？调试与监控技巧

使用Python进行日志记录，是为了更好地追踪程序运行状态，排查问题，以及进行性能监控。它不仅仅是简单地打印信息，而是构建一个结构化的、可配置的、可扩展的系统。

解决方案

Python自带的

logging

登录后复制

模块提供了强大的日志记录功能。首先，你需要导入

logging

登录后复制

模块，然后配置一个logger。最简单的配置方式是使用

logging.basicConfig()

登录后复制

，它可以快速设置日志级别、输出格式等。

立即学习“Python免费学习笔记（深入）”；

import logging

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

logger = logging.getLogger(__name__)

logger.info('程序开始运行')

try:
    result = 10 / 0
except Exception as e:
    logger.error('发生异常', exc_info=True) # 记录完整的异常信息

logger.info('程序运行结束')

登录后复制

这段代码展示了如何设置一个基本的logger，并记录信息、错误和异常。

level

登录后复制

参数设置了日志级别，只有高于或等于该级别的日志才会被记录。

format

登录后复制

参数定义了日志的输出格式，可以根据需要自定义。

exc_info=True

登录后复制

会在错误日志中包含完整的异常堆栈信息，这对于调试至关重要。

如何选择合适的日志级别？

日志级别决定了哪些信息会被记录。

logging

登录后复制

模块提供了几个常用的日志级别：

```
DEBUG
```
登录后复制
: 详细的信息，通常只在调试时使用。
```
INFO
```
登录后复制
: 确认程序运行正常的信息。
```
WARNING
```
登录后复制
: 发生了意外情况，但程序仍然可以运行。
```
ERROR
```
登录后复制
: 发生了错误，程序可能无法正常运行。
```
CRITICAL
```
登录后复制
: 发生了严重错误，程序可能需要退出。

选择合适的日志级别取决于你的需求。在开发阶段，可以使用

DEBUG

登录后复制

级别记录所有信息。在生产环境中，通常使用

INFO

登录后复制

或

WARNING

登录后复制

级别，只记录重要的信息和警告。如果需要更详细的日志，可以考虑使用

DEBUG

登录后复制

级别，但要注意日志量可能会很大。

如何将日志输出到文件？

默认情况下，

logging

登录后复制

模块将日志输出到控制台。如果需要将日志输出到文件，可以使用

FileHandler

登录后复制

。

import logging

# 创建一个logger
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)

# 创建一个FileHandler，将日志写入文件
file_handler = logging.FileHandler('my_app.log')
file_handler.setLevel(logging.DEBUG)

# 创建一个Formatter，定义日志格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
file_handler.setFormatter(formatter)

# 将FileHandler添加到logger
logger.addHandler(file_handler)

logger.info('程序开始运行')

登录后复制

这段代码创建了一个

FileHandler

登录后复制

，将日志写入

my_app.log

登录后复制

文件。

setLevel()

登录后复制

方法设置了

FileHandler

登录后复制

的日志级别，只有高于或等于该级别的日志才会被写入文件。

setFormatter()

登录后复制

方法设置了日志的输出格式。

如何使用logging.config进行配置？

logging.config

登录后复制

模块允许使用配置文件来配置日志记录器，这使得配置更加灵活和可维护。你可以使用

fileConfig()

登录后复制

或

dictConfig()

登录后复制

函数来加载配置文件。

import logging.config

logging.config.fileConfig('logging.conf') # 从文件加载配置

logger = logging.getLogger('my_app') # 获取logger，名称与配置文件中的一致

logger.info('程序开始运行')

登录后复制

logging.conf

登录后复制

文件示例:

[loggers]
keys=root,my_app

[handlers]
keys=consoleHandler,fileHandler

[formatters]
keys=myFormatter

[logger_root]
level=WARNING
handlers=consoleHandler

[logger_my_app]
level=DEBUG
handlers=fileHandler
qualname=my_app
propagate=0

[handler_consoleHandler]
class=StreamHandler
level=INFO
formatter=myFormatter
args=(sys.stdout,)

[handler_fileHandler]
class=FileHandler
level=DEBUG
formatter=myFormatter
args=('my_app.log',)

[formatter_myFormatter]
format=%(asctime)s - %(name)s - %(levelname)s - %(message)s

登录后复制

使用配置文件可以更方便地管理日志记录器的配置，例如日志级别、输出格式、输出目标等。

如何进行高级日志记录？

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

查看详情

除了基本的日志记录功能，

logging

登录后复制

模块还提供了许多高级功能，例如：

Filters: 可以根据特定的条件过滤日志信息。
Log Adapters: 可以向日志信息中添加额外的上下文信息。
自定义Handlers: 可以将日志信息输出到不同的目标，例如数据库、网络等。

例如，可以使用

Filter

登录后复制

来只记录特定模块的日志信息：

import logging

class MyFilter(logging.Filter):
    def filter(self, record):
        return record.module == 'my_module' # 只记录my_module模块的日志

logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)

handler = logging.StreamHandler()
handler.addFilter(MyFilter())

logger.addHandler(handler)

logger.debug('This is a debug message') # 不会被记录，因为模块名不是my_module

logger = logging.getLogger('my_module') # 获取名为my_module的logger
logger.debug('This is a debug message from my_module') # 会被记录

登录后复制

如何集成日志记录到现有的项目中？

将日志记录集成到现有项目中需要考虑以下几点：

一致性: 在整个项目中使用统一的日志记录格式和级别。
可配置性: 允许用户通过配置文件或命令行参数来配置日志记录器。
性能: 避免过度记录日志，以免影响程序的性能。
上下文: 在日志信息中包含足够的上下文信息，以便于调试和排查问题。

一个好的实践是在每个模块中创建一个logger，并使用模块名作为logger的名称。这样可以方便地追踪日志信息的来源。

如何使用第三方库简化日志记录？

除了

logging

登录后复制

模块，还有一些第三方库可以简化日志记录，例如

loguru

登录后复制

和

structlog

登录后复制

。

loguru

登录后复制

提供了一个更简洁的API，可以更方便地配置日志记录器。

from loguru import logger

logger.add("file.log", rotation="500 MB") # 每天生成一个新的日志文件

logger.debug("That's it, beautiful and simple logging!")

登录后复制

structlog

登录后复制

则专注于结构化日志记录，可以将日志信息以JSON格式输出，方便进行分析和处理。

import structlog

log = structlog.get_logger()

log.info("User logged in", user="john.doe", id=123)

登录后复制

这些第三方库可以根据你的需求选择使用。

如何进行日志分析和监控？

日志分析和监控是日志记录的重要组成部分。通过分析日志信息，可以了解程序的运行状态、性能瓶颈和潜在问题。

常用的日志分析工具包括：

ELK Stack (Elasticsearch, Logstash, Kibana): 一个强大的日志管理和分析平台。
Splunk: 一个商业的日志管理和分析工具。
Graylog: 一个开源的日志管理和分析工具。

这些工具可以帮助你收集、存储、分析和可视化日志信息。

总而言之，Python的日志记录是一个强大而灵活的工具，可以帮助你更好地理解和管理你的程序。通过选择合适的日志级别、输出格式和工具，你可以构建一个高效的日志记录系统，提高程序的可靠性和可维护性。

以上就是Python如何做日志记录？调试与监控技巧的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

Python中复杂JSON结构内嵌对象数组按日期键排序的实现指南 Python跨目录导入模块与包管理深度解析 python loguru如何记录日志 Python3安装目录怎么选择_Python3安装路径选择建议与注意事项 Robot Framework中日期时间差的精确计算与格式化指南