phthon 基础 7.3 logging 日志模块

一. logging 的使用

日志是我们排查问题的关键利器，写好日志记录，当我们发生问题时，可以快速定位代码范围进行修改。python有给我们开发者提供好的日志模块，下面我们就来介绍一下logging模块：

 

import logging

 

#从上往下，日志级别逐渐升高

logging.debug('this is debug message')

logging.info('this is info message')

logging.warning('this is warning message')

logging.error('this is error message')

logging.critical('this is critical message')

 

>>>

WARNING:root:this is warning message

ERROR:root:this is error message

CRITICAL:root:this is critical message

 

debug:详细的信息，通常只出现在诊断问题上。

info：确认一切按预期运行

warning：一个警告，可能会有一些意想不到的事情发生了，或表明一些问题在不久的将来（例如，磁盘空间低）。这个软件还能按预期工作。

error：一个更严重的问题，软件没能执行一些功能

critical：一个严重的错误，这表明程序本身可能无法继续运行

 

默认logging的日志级别为info，一般基本上所有程序都是这个级别，有助于我们排查问题，但是当发生问题，我们没法定位问题，很多情况下我们需要把日志级别提升到debug级别，那又怎么办呢？

 

二. 通过logging.basicConfig 函数对日志的输出格式及方式做相关配置。现实工作中，往往我们是要把日志写在日志文件中的，那怎么样做呢？看如下代码：

 

#通过logging.basicConfig 函数 把日志写在文件中

logging.basicConfig(level=logging.DEBUG,format='%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s'

                    ,datefmt=' %Y/%m/%d %H:%M:%S', filename='lzc.log', filemode='w+')

logging.debug('this is debug message')

logging.info('this is info message')

logging.warning('this is warning message')

logging.error('this is error message')

logging.critical('this is critical message')

 

打开生成的日志文件 lzc.log

2017/11/10 04:34:10 logging ��־.py[line:23] DEBUG this is debug message

2017/11/10 04:34:10 logging ��־.py[line:24] INFO this is info message

2017/11/10 04:34:10 logging ��־.py[line:25] WARNING this is warning message

2017/11/10 04:34:10 logging ��־.py[line:26] ERROR this is error message

2017/11/10 04:34:10 logging ��־.py[line:27] CRITICAL this is critical message

 

 

 

 

三。主要是通过logging.basicConfig 函数进行操作，现在我们来介绍该函数参数的用法：

level ：设置日志级别，默认为logging.WARNING

filename：指定日志文件名

filemode:和file函数意义相同，指定日志文件的打开模式，'w'或'a'

format:指定输出的格式和内容，format可以输出很多有用信息，如上例所示：

        %(levelname)s:打印日志级别名称

        %(filename)s:打印当前执行程序名

         %(funcName)s:打印日志的当前函数

         %(lineno)d:打印日志的当前行号

         %(asctime)s:打印日志的时间

         %(thread)d：打印线程ID

         %(message)s：打印日志信息

         datefmt：指定时间格式，同time.strftime()

         stream:指定将日志的输出流，可以指定输出到 sys.stderr,sys.stdout 或者文件，默认输出到sys.stderr,当stream和filename同时指定时，stream被忽略

          logging.getLogger([name]):创建一个日志对象：

 

返回一个logger实例，如果没有指定name，返回root logger。只要name相同，返回的logger 实例都是同一个而且只有一个，即name和logger 实例是一一对应的。这意味着，无需把logger实例在各个模块中传递。只要知道name，就能得到同一个logger实例。

logging.getLogger(__name__) 在上述实例中__name__就指的是__main__.