![0053410707cf15410cbb1f2adbaad9f8.png](https://i-blog.csdnimg.cn/blog_migrate/606254463f7402e91fb602f4d67488a3.jpeg)
一、为什么我们需要引用logging模块?
我们把python代码放入到生产环境中的时候,我们只能看到代码运行的结果,我们不知道的是代码每一步过程的最终运行状态。
如果代码中间过程出现了问题的话,logging库的引用得出的日志记录可以帮助我们排查程序运行错误步骤的。方便我们修复代码,快速排查问题。
logging模块是Python内置的标准模块,主要用于输出运行日志,可以设置输出日志的等级、日志保存路径、日志文件回滚等;相比print,具备如下优点:
- 可以通过设置不同的日志等级,在release版本中只输出重要信息,而不必显示大量的调试信息;
- print将所有信息都输出到标准输出中,严重影响开发者从标准输出中查看其它数据;logging则可以由开发者决定将信息输出到什么地方,以及怎么输出
二、logging模块使用
2.1、logging模块控制台输出
#引入了 logging 模块
import logging
logging.basicConfig(level = logging.INFO,format = '%(asctime)s - %(name)s - %(levelname)s - %(message)s')
#声明了一个 Logger 对象
logger = logging.getLogger(__name__)
logger.info("Start print log")
logger.debug("Do something")
logger.warning("Something maybe fail.")
logger.info("Finish")
logging 的全局配置:
![8faaa77df4cb2da56ffd245eda7ca5e6.png](https://i-blog.csdnimg.cn/blog_migrate/a263f5bc004a0c1d82e5cf3ef21c5a72.png)
basicConfig 配置了 level 信息和 format 信息
level 配置为 INFO 信息,即只输出 INFO 级别的信息,
format=:指定了 format 格式的字符串,包括 asctime运行时间 name模块名称、levelname(日志级别)message (日志内容)
![56f68eacc8ff926c42098306ed8681fd.png](https://i-blog.csdnimg.cn/blog_migrate/71e2773641470dcac2d9054c4c9a9df3.jpeg)
为什么DEBUG 的信息没有输出?
因为我们在全局配置的时候设置了输出为 INFO 级别,所以 DEBUG 级别的信息就被过滤掉了
logging中可以选择很多消息级别,如debug、info、warning、error以及critical。通过赋予logger或者handler不同的级别,开发者就可以只输出错误信息到特定的记录文件,或者在调试时只记录调试信息。
![ba0afb4f7c19c8648f18b3564376d447.png](https://i-blog.csdnimg.cn/blog_migrate/fbe5a7362618b6b1cb55e56313118851.jpeg)
2.2、basicConfig 的参数
- filename:即日志输出的文件名,如果指定了这个信息之后,实际上会启用 FileHandler,而不再是 StreamHandler,这样日志信息便会输出到文件中了。
- filemode:这个是指定日志文件的写入方式,有两种形式,一种是 w,一种是 a,分别代表清除后写入和追加写入。
- format:指定日志信息的输出格式(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。
%(processName)s:打印线程名称。
%(module)s:打印模块名称。
%(message)s:打印日志信息。
- datefmt:指定时间的输出格式。
- style:如果 format 参数指定了,这个参数就可以指定格式化时的占位符风格,如 %、{、$ 等。
- level:指定日志输出的类别,程序会输出大于等于此级别的信息。
- stream:在没有指定 filename 的时候会默认使用 StreamHandler,这时 stream 可以指定初始化的文件流。指定将日志的输出流,可以指定输出到sys.stderr,sys.stdout或者文件,默认输出到sys.stderr,当stream和filename同时指定时,stream被忽略;
- handlers:可以指定日志处理时所使用的 Handlers,必须是可迭代的。
2.3、Handler的用法
将日志写入到文件,这里我们没有再使用 basicConfig 全局配置,而是,Logger 对象添加对应的 Handler 即可,最后可以发现日志就会被输出到 Alibaba.log 中,内容如下:
import logging
#先声明一个 Logger 对象
logger = logging.getLogger(__name__)
logger.setLevel(level=logging.INFO)
#然后指定其对应的 Handler 为 FileHandler 对象
handler = logging.FileHandler('Alibaba.log')
#然后 Handler 对象单独指定了 Formatter 对象单独配置输出格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)
logger.addHandler(handler)
![50a571c0f9441bcc2c0de82a65f1fe25.png](https://i-blog.csdnimg.cn/blog_migrate/679d2de510dc41c92debc736197c5941.png)
logger.info('welcome to alibaba info')
logger.debug('Debugging')
logger.warning('Warning exists')
logger.info('Finish')
![5d0df535d7083a192b70d5ff9ad967e3.png](https://i-blog.csdnimg.cn/blog_migrate/a8ab94ee493a84ce57f54d9c8d2019e6.jpeg)
- stream:在没有指定 filename 的时候会默认使用 StreamHandler,这时 stream 可以指定初始化的文件流。指定将日志的输出流,可以指定输出到sys.stderr,sys.stdout或者文件,默认输出到sys.stderr,当stream和filename同时指定时,stream被忽略;
- handlers:可以指定日志处理时所使用的 Handlers,必须是可迭代的。
当然还有其他的Handler 进行日志的输出,logging 模块提供的 Handler 有:
- StreamHandler:logging.StreamHandler;日志输出到流,可以是 sys.stderr,sys.stdout 或者文件。
- FileHandler:logging.FileHandler;日志输出到文件。
- BaseRotatingHandler:logging.handlers.BaseRotatingHandler;基本的日志回滚方式。
- RotatingHandler:logging.handlers.RotatingHandler;日志回滚方式,支持日志文件最大数量和日志文件回滚。
- TimeRotatingHandler:logging.handlers.TimeRotatingHandler;日志回滚方式,在一定时间区域内回滚日志文件。
- SocketHandler:logging.handlers.SocketHandler;远程输出日志到TCP/IP sockets。
- DatagramHandler:logging.handlers.DatagramHandler;远程输出日志到UDP sockets。
- SMTPHandler:logging.handlers.SMTPHandler;远程输出日志到邮件地址。
- SysLogHandler:logging.handlers.SysLogHandler;日志输出到syslog。
- NTEventLogHandler:logging.handlers.NTEventLogHandler;远程输出日志到Windows NT/2000/XP的事件日志。
- MemoryHandler:logging.handlers.MemoryHandler;日志输出到内存中的指定buffer。
- HTTPHandler:logging.handlers.HTTPHandler;通过”GET”或者”POST”远程输出到HTTP服务器。
2.4、Formatter的用法
我们当然可以不借助于 basicConfig 来全局配置格式化输出内容, Formatter 可以帮我们完成,每个 Handler 单独配置输出的格式,非常灵活。
import logging
logger = logging.getLogger(__name__)
logger.setLevel(level=logging.WARN)
#指定了一个 Formatter,并传入了 fmt 和 datefmt 参数,这样就指定了日志结果的输出格式和时间格式
formatter = logging.Formatter(fmt='%(asctime)s - %(name)s - %(levelname)s - %(message)s', datefmt='%Y/%m/%d %H:%M:%S')
handler = logging.StreamHandler()
#handler 通过 setFormatter() 方法设置此 Formatter 对象即可
handler.setFormatter(formatter)
logger.addHandler(handler)
![298a4fc0685fae7e0f5289a77ca4ea6d.png](https://i-blog.csdnimg.cn/blog_migrate/ed5ae1f466ed5b56bb2bcba15fc36922.png)
# Log
logger.debug('Debugging')
logger.critical('Critical Something')
logger.error('Error Occurred')
logger.warning('Warning exists')
logger.info('Finished')
![63555ff40219ad176bb97b1702eac945.png](https://i-blog.csdnimg.cn/blog_migrate/3cebb3f0f2e736be35ac6182bae4c5b4.jpeg)
三、捕获 Traceback
error() 方法中添加了一个参数,将 exc_info 设置为了 True,这样我们就可以输出执行过程中的信息了,即完整的 Traceback 信息。
import logging
logger = logging.getLogger(__name__)
logger.setLevel(level=logging.DEBUG)
# Formatter
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
# FileHandler
file_handler = logging.FileHandler('result.log')
file_handler.setFormatter(formatter)
logger.addHandler(file_handler)
# StreamHandler
stream_handler = logging.StreamHandler()
stream_handler.setFormatter(formatter)
logger.addHandler(stream_handler)
# Log
logger.info('Start')
logger.warning('Something maybe fail.')
try:
result = 10 / 0
except Exception:
logger.error('Faild to get result', exc_info=True)
logger.info('Finished')
![829030e69dbccf48ce3dcd38c4eaff8a.png](https://i-blog.csdnimg.cn/blog_migrate/cffeaeccd894150934dffd2b609a77b3.jpeg)
往期精彩回顾
第一篇 | 深圳购房投资笔记(一)-楼市有泡沫吗?(上)第二篇 |深圳购房投资笔记(二)-楼市有泡沫吗?(中)第三篇|深圳购房笔记(三)-亲身经历货币棚改化(上)第四篇|深圳购房投资笔记(四)-亲身经历货币化棚改(下)第五篇|深圳购房投资笔记(五)-因为朋友,被杭州所迷惑第六篇|深圳购房投资笔记(六)-为何放弃在杭州定居购房第七篇|深圳购房投资笔记(七)-神奇的深圳人口?(下)第八篇|深圳购房投资笔记(八)-为何选择在深圳定居购房?第九篇|深圳购房投资笔记(九)-中国最大的炒房散户欧成效先生第十篇|深圳购房投资笔记(十)-深圳楼市拐点已来临第十一篇|深圳购房投资笔记(十一)-楼市谣言四处飞,我向人民说实话(上)第十二篇|深圳购房投资笔记(十二)-楼市谣言四处飞,我想人民说实话(下)第十三篇|深圳购房投资笔记(十三)-民间炒房高手财上团(上)第十四篇|深圳购房投资笔记(十四)-2019年的这一切都是必然的第十五篇|深圳购房投资笔记(十五)-2019年我们的处境深圳购房投资笔记(十六)从19年看李嘉诚为何资产
![261e83d778b514197852bd9d8a2188db.png](https://i-blog.csdnimg.cn/blog_migrate/b66a5df93814774ce5c947cf0b9a54bf.jpeg)
图片笔者摄于2018年6月30日17:21分,于广东省云门山爬山途中。山青云高天蓝,让人心沉静!