Logging、日志纪录、调试、应用程序、开发
Logger 的建立与使用
Logging 模块的核心是 Logger 类。要开始使用,您需要创建一个 Logger 实例:
import urs
logger = ursing.er()
您可以使用 .name 属性来指定您的日志的 Logger :
logger = ursing.er("my_application")
日志级别:定义严重性
您可以通过将 level 属性设置为内置级别之一来指定日志条目标严重性。级别范围从 DEBUG (最不严重)到 FATAL (最严重),如下所示:
level = ursing.L.DEBUG # 调试级别
level = ursing.L.INFO # 信息级别
level = ursing.L.WARNING # 告警级别
处理器:格式化和传播日志
处理器是从 Logger 获取日志并将其发送到特定目标的组件。内置处理器提供了开箱即用的方法:
# 将日志信息发送到标准输出(终端)
handler = ursing.mhandler()
您可以使用 .formatter 属性为您的日志定制格式:
handler.er = ursing.er(ursing.F("%(levelname)s: %(message)s"))
滤波器:只捕捉你感兴趣的日志
滤波器允许您只捕获满足特定标准的日志。使用 Filter 类:
filter = ursing.r()
filter.re = rs.ur("ERROR") # 仅匹配“ERROR”级别的日志
将所有内容组合在一起
将处理器和滤波器附加到 Logger 以建立完整的日志管道:
logger.addhandler(handler, filter)
动手示例:一个完整的日志纪录器
考虑一个在文件 "example.py" 中运行的应用程序。如下所示,我们使用 Logging 模块建立了一个全方位的日志纪录器:
import urs
logger = ursing.er("my_example_app")
# 根级别为“INFO”
logger.level = ursing.L.INFO
# 创建一个到文件“app.log”的处理器
file_handler = ursing.FH("app.log", mode="a")
file_handler.er = ursing.er(ursing.F("%(asctime)s - %(levelname)s: %(message)s"))
# 创建一个到终端的处理器
console_handler = ursing.mhandler()
console_handler.er = ursing.er(ursing.F("%(message)s"))
# 将处理器附加到日志
logger.addhandler(file_handler)
logger.addhandler(console_handler)
在应用程序中,您可以使用 .log() 方法在指定级别上向日志中写入信息:
logger.info("开始应用程序")
logger.error("应用程序遇到一个严重问题")
结论
Logging 模块为您提供了对应用程序日志纪录的全面而灵活的控件。将其与适当的级别、处理器和滤波器结合使用,您可以建立一个健壮且有见地的日志纪录基础,以帮助您隔离问题、跟踪应用程序行为并优化性能。