python logger_牛逼！python中的logging模块居然这么好用！

一、为什么我们需要引用logging模块？

我们把python代码放入到生产环境中的时候，我们只能看到代码运行的结果，我们不知道的是代码每一步过程的最终运行状态。

如果代码中间过程出现了问题的话，logging库的引用得出的日志记录可以帮助我们排查程序运行错误步骤的。方便我们修复代码，快速排查问题。

logging模块是Python内置的标准模块，主要用于输出运行日志，可以设置输出日志的等级、日志保存路径、日志文件回滚等；相比print，具备如下优点：

可以通过设置不同的日志等级，在release版本中只输出重要信息，而不必显示大量的调试信息；
print将所有信息都输出到标准输出中，严重影响开发者从标准输出中查看其它数据；logging则可以由开发者决定将信息输出到什么地方，以及怎么输出

二、logging模块使用

2.1、logging模块控制台输出

#引入了 logging 模块import logginglogging.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 的全局配置：

basicConfig 配置了 level 信息和 format 信息

level 配置为 INFO 信息，即只输出 INFO 级别的信息，

format=：指定了 format 格式的字符串，包括 asctime运行时间 name模块名称、levelname(日志级别)message (日志内容)

为什么DEBUG 的信息没有输出？

因为我们在全局配置的时候设置了输出为 INFO 级别，所以 DEBUG 级别的信息就被过滤掉了

logging中可以选择很多消息级别，如debug、info、warning、error以及critical。通过赋予logger或者handler不同的级别，开发者就可以只输出错误信息到特定的记录文件，或者在调试时只记录调试信息。

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)

logger.info('welcome to alibaba info')logger.debug('Debugging')logger.warning('Warning exists')logger.info('Finish')

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)

# Loglogger.debug('Debugging')logger.critical('Critical Something')logger.error('Error Occurred')logger.warning('Warning exists')logger.info('Finished')

输出结果

三、捕获 Traceback

error() 方法中添加了一个参数，将 exc_info 设置为了 True，这样我们就可以输出执行过程中的信息了，即完整的 Traceback 信息。

import logging

logger = logging.getLogger(__name__)logger.setLevel(level=logging.DEBUG)

# Formatterformatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

# FileHandlerfile_handler = logging.FileHandler('result.log')file_handler.setFormatter(formatter)logger.addHandler(file_handler)

# StreamHandlerstream_handler = logging.StreamHandler()stream_handler.setFormatter(formatter)logger.addHandler(stream_handler)

# Loglogger.info('Start')logger.warning('Something maybe fail.')try:    result = 10 / 0except Exception:    logger.error('Faild to get result', exc_info=True)logger.info('Finished')