Logging HOWTO
接上一期介绍完logging的一些基本概念(日志等级的概念等),基础的使用方式,本期还会介绍更多的使用场景。
从多个模块记录日志
我们再开发程序的时候,肯定包含多个组件,以及功能,我们的日志也要设置再各个模块文件中,时刻追踪我们程序运行的情况。如果你的软件又多个模块组成,下面就有一个例子
# myapp.py import logging import mylib def main(): logging.basicConfig(filename='myapp.log', level=logging.INFO) logging.info('Started') mylib.do_something() logging.info('Finished') if __name__ == '__main__': main()
# mylib.py import logging def do_something(): logging.info('Doing something')
运行程序之后,我们可以在myapp.log中看到
INFO:root:Started INFO:root:Doing something INFO:root:Finished
我们可以仿照mylib.py中的办法,应用于其他文件,而其日志的配置也遵循了myapp.py中的设置,但我们发现对于这种简单的配置,除了日志打印出的信息之外,我们无法得知日志都是来自哪里。这十分重要,我们还需要有跟踪日志文件的功能。之后我会介绍的,敬请期待。
记录变量数据
如果要记录变量,使用格式化string
import logging logging.warning('%s before you %s', 'Look', 'leap!')
将变量数据合并到事件描述消息中使用旧的%样式的字符串格式。这是为了向后兼容:日志包早于更新的格式化选项,如str.format()和string.Template。这些新的格式化选项是受支持的。
改变显示消息的格式
如果想要将格式应用于想使用的消息,我们需要指定我们想要的格式
import logging logging.basicConfig(format='%(levelname)s:%(message)s', level=logging.DEBUG) logging.debug('This message should appear on the console') logging.info('So should this') logging.warning('And this, too')
输出:
DEBUG:This message should appear on the console INFO:So should this WARNING:And this, too
注意这里,之前的root已经消失不见了,对于可以出现在格式字符串中的全部内容,我们可以参考文档中的LogRecord属性,但是为了简单的使用,但为了简单,这个例子使用的格式比较少,比如日志等级和日志描述,下一节中我们将会加入时间。
在消息中显示日期/时间
如果在日志中需要加入时间显示,我们可以添加%(asctime)s,这里我没有看源码,盲才logging模块这种通过format参数来定制日志格式的实现方法用的re模块吧。不用应该也能做,等有时间了可以研究一下。
import logging logging.basicConfig(format='%(asctime)s %(message)s') logging.warning('is when this event was logged.')
输出:
2010-12-12 11:41:42,612 is when this event was logged.
日期/时间显示的默认格式(如上所示)类似于ISO8601或RFC 3339。如果你需要更多的日期/时间格式的控制,提供一个datefmt参数给basicConfig,就像这个例子:
import logging logging.basicConfig(format='%(asctime)s %(message)s', datefmt='%m/%d/%Y %I:%M:%S %p') logging.warning('is when this event was logged.')
输出:
12/12/2010 11:46:36 AM is when this event was logged.
下一步
logging模块基本的功能介绍就到此为止了,但本系列的内容还将继续,之前的内容已经足够我们启动logging模块实现基本需求了,日志还包含更多高级的使用功能,如果要充分的使用他们,后面会有进阶的内容。
最后的最后
新年的第一天也不能偷懒啊,也要学习啊。祝大家新年快乐,今年一切都会好起来的~