Python日志库Loguru教程

发布时间 2023-09-10 09:47:07作者: 守护式等待

1.为什么选用loguru

python自带的logging模块,需要完成复杂的配置才能很好的使用,基本生产环境都需要进行二次包装。

loguru专门梳理了这方面的问题,可以通过简单直接的配置完成你的需求。

简单的例子:

from loguru import logger
logger.info("hello from loguru")

输出到标准输出:

2023-09-10 09:38:52.275 | INFO     | __main__:<module>:2 - hello from loguru

输出到日志文件:

from loguru import logger

logger.remove(0)
logger.add("out.log")
logger.success("Written message to log file")

2.如何使用loguru

2.1 安装

pip install loguru

最简单的使用:

from loguru import logger

# 在标准输出里面输出一行debug日志
logger.debug("That's it, beautiful and simple logging!")

2.2 日志类型(Level)介绍

loguru提供了七层日志层级,或者说七种日志类型。

生产环境中,常常在不同场景下使用不用的日志类型,用于处理各种问题。

每种类型的日志有一个整数值,表示日志层级,我们成为log level no。

  • TRACE (5): 用于记录程序执行路径的细节信息,以进行诊断。
  • DEBUG (10): 开发人员使用该工具记录调试信息。
  • INFO (20): 用于记录描述程序正常操作的信息消息。
  • SUCCESS (25): 类似于INFO,用于指示操作成功的情况。
  • WARNING (30): 警告类型,用于指示可能需要进一步调查的不寻常事件。
  • ERROR (40): 错误类型,用于记录影响特定操作的错误条件。
  • CRITICAL (50): 严重类型,用于记录阻止核心功能正常工作的错误条件。
logger.trace("A trace message.")
logger.debug("A debug message.")
logger.info("An info message.")
logger.success("A success message.")
logger.warning("A warning message.")
logger.error("An error message.")
logger.critical("A critical message.")

输出如下:

2022-08-10 11:58:33.224 | DEBUG | __main__:<module>:12 - A debug message.
2022-08-10 11:58:33.224 | INFO | __main__:<module>:13 - An info message.
2022-08-10 11:58:33.225 | SUCCESS | __main__:<module>:14 - A success message.
2022-08-10 11:58:33.226 | WARNING | __main__:<module>:15 - A warning message.
2022-08-10 11:58:33.226 | ERROR | __main__:<module>:16 - An error message.
2022-08-10 11:58:33.227 | CRITICAL | __main__:<module>:17 - A critical message.

如果你在linux的终端上,可以看到不同类型的日志,已经有不同的颜色加以区分,默认的配置已经很方便的让我们识别和使用了。

请注意,上述输出不包括TRACE级别的日志信息。这是因为Loguru默认使用DEBUG作为其最低日志级别,导致任何严重性低于DEBUG的日志信息都会被忽略。

如果您想更改默认级别,可以使用下面所示的add()方法的级别参数:

import sys
from loguru import logger

logger.remove(0)
logger.add(sys.stderr, level="INFO")

remove()方法被首先调用,以删除默认处理程序的配置(其ID为0)。然后,add()方法向记录器添加一个新处理程序。该处理程序将记录到标准错误,只记录INFO或更高级别的日志。

2.3 设置日志输出的格式

在日常使用中,如果默认的输出内容不够,我们还可以自定义日志的输出内容和格式。

可以通过add()方法中的格式选项对Loguru生成的日志记录进行重新格式化。

Loguru 中的每条日志记录都是一个 Python 字典,其中包含其时间戳、日志级别等数据。

可以使用loguru提供的格式化指令,包括或重新排列每条信息,如下所示:

import sys
from loguru import logger

logger.remove(0)
logger.add(sys.stderr, format="{time} | {level} | {message}")

logger.debug("Happy logging with Loguru!")

格式参数定义了自定义格式,在这个例子中有三个指令:

{time}:时间戳

{level}:日志级别

{message}:日志消息

输出如下:

2022-08-10T15:01:32.154035-0400 | DEBUG | Happy logging with Loguru!