Python 使用 logging模块打印日志

仅供学习,转载请注明出处

logging日志模块

开发过程中出现bug是必不可免的,你会怎样debug?从第1行代码开始看么?还是有个文件里面记录着哪里错了更方便呢!!!log日志

Python中有个logging模块可以完成相关信息的记录,在debug时用它往往事半功倍。

日志级别

日志一共分成5个等级,从低到高分别是:

1.DEBUG 2.INFO 3.WARNING 4.ERROR 5.CRITICAL

说明:

  • DEBUG:详细的信息,通常只出现在诊断问题上
  • INFO:确认一切按预期运行
  • WARNING:一个迹象表明,一些意想不到的事情发生了,或表明一些问题在不久的将来(例如。磁盘空间低”)。这个软件还能按预期工作。
  • ERROR:更严重的问题,软件没能执行一些功能
  • CRITICAL:一个严重的错误,这表明程序本身可能无法继续运行

这5个等级,也分别对应5种打日志的方法: debug 、info 、warning 、error 、critical。默认的是WARNING,当在WARNING或之上时才被跟踪。

日志输出

有两种方式记录跟踪,一种输出控制台,另一种是记录到文件中,如日志文件。

将日志输出到控制台

#!coding=utf-8
import logging

# 开始使用log功能
logging.info('这是 loggging info message')
logging.debug('这是 loggging debug message')
logging.warning('这是 loggging a warning message')
logging.error('这是 an loggging error message')
logging.critical('这是 loggging critical message')

因为日志打印等级默认是 WARNING 的级别,所以debug和info是不会打印出来的。 运行测试如下:

[root@server01 testlog]# python test1.py 
WARNING:root:这是 loggging a warning message
ERROR:root:这是 an loggging error message
CRITICAL:root:这是 loggging critical message
[root@server01 testlog]# 

那么最低的等级是DEBUG,是否设置了DEBUG就可以打印所有等级的日志呢?

测试代码如下:

#!coding=utf-8
import logging

# 设置logging的等级以及打印格式
logging.basicConfig(level=logging.DEBUG,
                    format='%(asctime)s - %(filename)s[line:%(lineno)d] - %(levelname)s: %(message)s')

# 开始使用log功能
logging.debug('这是 loggging debug message')
logging.info('这是 loggging info message')
logging.warning('这是 loggging a warning message')
logging.error('这是 an loggging error message')
logging.critical('这是 loggging critical message')

运行测试如下:

[root@server01 testlog]# python test1.py 
2019-01-06 21:59:02,895 - test1.py[line:8] - DEBUG: 这是 loggging debug message
2019-01-06 21:59:02,895 - test1.py[line:9] - INFO: 这是 loggging info message
2019-01-06 21:59:02,895 - test1.py[line:10] - WARNING: 这是 loggging a warning message
2019-01-06 21:59:02,895 - test1.py[line:11] - ERROR: 这是 an loggging error message
2019-01-06 21:59:02,895 - test1.py[line:12] - CRITICAL: 这是 loggging critical message
[root@server01 testlog]# 

说明: 通过logging.basicConfig函数对日志的输出格式及方式做相关配置,上面代码设置日志的输出等级是WARNING级别,意思是WARNING级别以上的日志才会输出。另外还制定了日志输出的格式。

注意,只要用过一次log功能再次设置格式时将失效,实际开发中格式肯定不会经常变化,所以刚开始时需要设定好格式

将日志输出到文件

我们还可以将日志输出到文件,只需要在logging.basicConfig函数中设置好输出文件的文件名和写文件的模式。

#!coding=utf-8
import logging

# 设置写入日志的文件是 log-20190116.log , 其中使用覆盖写入的 w 模式写日志文件
logging.basicConfig(level=logging.DEBUG,
                    filename='./log-20190116.log',
                    filemode='w',
                    format='%(asctime)s - %(filename)s[line:%(lineno)d] - %(levelname)s: %(message)s')

# 开始使用log功能
logging.debug('这是 loggging debug message')
logging.info('这是 loggging info message')
logging.warning('这是 loggging a warning message')
logging.error('这是 an loggging error message')
logging.critical('这是 loggging critical message')

运行测试如下:

[root@server01 testlog]# python3 test1.py 
[root@server01 testlog]# 
[root@server01 testlog]# ls
log-20190116.log  test1.py
[root@server01 testlog]# cat log-20190116.log 
2019-01-06 22:57:01,144 - test1.py[line:10] - DEBUG: 这是 loggging debug message
2019-01-06 22:57:01,145 - test1.py[line:11] - INFO: 这是 loggging info message
2019-01-06 22:57:01,145 - test1.py[line:12] - WARNING: 这是 loggging a warning message
2019-01-06 22:57:01,145 - test1.py[line:13] - ERROR: 这是 an loggging error message
2019-01-06 22:57:01,145 - test1.py[line:14] - CRITICAL: 这是 loggging critical message

既要把日志输出到控制台, 还要写入日志文件

这就需要一个叫作Logger 的对象来帮忙,下面将对他进行详细介绍,现在这里先学习怎么实现把日志既要输出到控制台又要输出到文件的功能。

#!coding=utf-8
import logging

# 第一步,创建一个logger  
logger = logging.getLogger()
logger.setLevel(logging.INFO)  # Log等级总开关  

# 第二步,创建一个handler,用于写入日志文件  
logfile = './log-20190106.txt'
fh = logging.FileHandler(logfile, mode='a')  # open的打开模式这里可以进行参考
fh.setLevel(logging.DEBUG)  # 输出到file的log等级的开关  

# 第三步,再创建一个handler,用于输出到控制台  
ch = logging.StreamHandler()
ch.setLevel(logging.WARNING)   # 输出到console的log等级的开关  

# 第四步,定义handler的输出格式  
formatter = logging.Formatter("%(asctime)s - %(filename)s[line:%(lineno)d] - %(levelname)s: %(message)s")
fh.setFormatter(formatter)
ch.setFormatter(formatter)

# 第五步,将logger添加到handler里面  
logger.addHandler(fh)
logger.addHandler(ch)

# 日志  
logger.debug('这是 logger debug message')
logger.info('这是 logger info message')
logger.warning('这是 logger warning message')
logger.error('这是 logger error message')
logger.critical('这是 logger critical message')

运行如下:

## 执行一次日志打印,可以看出控制台输出了WARNING级别以上的日志
[root@server01 testlog]# python3 test1.py 
2019-01-06 23:01:47,729 - test1.py[line:29] - WARNING: 这是 logger warning message
2019-01-06 23:01:47,729 - test1.py[line:30] - ERROR: 这是 logger error message
2019-01-06 23:01:47,729 - test1.py[line:31] - CRITICAL: 这是 logger critical message
[root@server01 testlog]# 
## 执行第二次日志打印
[root@server01 testlog]# python3 test1.py 
2019-01-06 23:01:49,152 - test1.py[line:29] - WARNING: 这是 logger warning message
2019-01-06 23:01:49,152 - test1.py[line:30] - ERROR: 这是 logger error message
2019-01-06 23:01:49,152 - test1.py[line:31] - CRITICAL: 这是 logger critical message
[root@server01 testlog]# 
[root@server01 testlog]# ls
log-20190106.txt  log-20190116.log  test1.py
[root@server01 testlog]# 
## 查看最后生成的日志文件
[root@server01 testlog]# cat log-20190106.txt 
2019-01-06 23:01:38,525 - test1.py[line:28] - INFO: 这是 logger info message
2019-01-06 23:01:38,525 - test1.py[line:29] - WARNING: 这是 logger warning message
2019-01-06 23:01:38,525 - test1.py[line:30] - ERROR: 这是 logger error message
2019-01-06 23:01:38,525 - test1.py[line:31] - CRITICAL: 这是 logger critical message
2019-01-06 23:01:47,728 - test1.py[line:28] - INFO: 这是 logger info message
2019-01-06 23:01:47,729 - test1.py[line:29] - WARNING: 这是 logger warning message
2019-01-06 23:01:47,729 - test1.py[line:30] - ERROR: 这是 logger error message
2019-01-06 23:01:47,729 - test1.py[line:31] - CRITICAL: 这是 logger critical message
2019-01-06 23:01:49,152 - test1.py[line:28] - INFO: 这是 logger info message
2019-01-06 23:01:49,152 - test1.py[line:29] - WARNING: 这是 logger warning message
2019-01-06 23:01:49,152 - test1.py[line:30] - ERROR: 这是 logger error message
2019-01-06 23:01:49,152 - test1.py[line:31] - CRITICAL: 这是 logger critical message
[root@server01 testlog]# ls

日志格式说明

logging.basicConfig函数中,可以指定日志的输出格式format,这个参数可以输出很多有用的信息,如下:

  • %(levelno)s: 打印日志级别的数值
  • %(levelname)s: 打印日志级别名称
  • %(pathname)s: 打印当前执行程序的路径,其实就是sys.argv[0]
  • %(filename)s: 打印当前执行程序名
  • %(funcName)s: 打印日志的当前函数
  • %(lineno)d: 打印日志的当前行号
  • %(asctime)s: 打印日志的时间
  • %(thread)d: 打印线程ID
  • %(threadName)s: 打印线程名称
  • %(process)d: 打印进程ID
  • %(message)s: 打印日志信息

在工作中给的常用格式如下: format='%(asctime)s - %(filename)s[line:%(lineno)d] - %(levelname)s: %(message)s' 这个格式可以输出日志的打印时间,是哪个模块输出的,输出的日志级别是什么,以及输入的日志内容。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

扫码关注云+社区

领取腾讯云代金券