python——logging模块

简介： 

日志是一种可以追踪某些软件运行时所发生事件的方法。软件开发人员可以向他们的代码中调用日志记录相关的方法来表明发生了某些事情。不同的事件，被区分在不同的等级中，故通过log分析，可以很轻易地分析得到该应用的健康状况，及时发现问题并快速定位、解决问题，补救损失。python自带的模块logging可以实现日志的记录功能，其下的日志级别共分为五个级别，级别顺序为debug<info<warning<error<critical。logging模块指定日志记录器的日志级别，只有级别大于或等于该指定日志级别的日志记录才会被输出，小于该等级的日志记录将会被丢弃。

日志的模块使用

• 定义模块级别函数：用于指定触发这个级别所报出的信息，通用方法是logging.log(level,*args,**kwargs)，参数level是日志的等级。
• 对日志进行基本配置：logging.basicConfig(**kwargs)，可选参数如下：
• 日志的四大组件：loggers、handlers、filters、formatters。四大组件的应用在下面会介绍。

logging模块提供的模块级别的那些函数实际上也是通过这几个组件的相关实现类来记录日志的，只是在创建这些类的实例时设置了一些默认值。

• 格式字符化输出：formatters控制日志信息输出格式，在这个模块内已经封装好了自己的格式，如下图所示：

代码实例

经过简单配置，输出日志记录。

import logging
logging.basicConfig(level= logging.DEBUG,filename='basic.log',format= '时间:%(asctime)s,''日志级别:%(levelname)s,''日志信息:%(message)s,''日志名字:%(name)s')

logging.debug("This is a debug log.")
logging.info("This is a info log.")
logging.warning("This is a warning log.")
logging.error("This is a error log.")
logging.critical("This is a critical log.")

时间:2018-10-11 16:46:45,355,日志级别:DEBUG,日志信息:This is a debug log.,日志名字:root
时间:2018-10-11 16:46:45,355,日志级别:INFO,日志信息:This is a info log.,日志名字:root
时间:2018-10-11 16:46:45,355,日志级别:WARNING,日志信息:This is a warning log.,日志名字:root
时间:2018-10-11 16:46:45,356,日志级别:ERROR,日志信息:This is a error log.,日志名字:root
时间:2018-10-11 16:46:45,356,日志级别:CRITICAL,日志信息:This is a critical log.,日志名字:root

可以发现默认情况下，日志名字为root。

利用四大组件，认识日志处理流程。

1. 日志初始化
2. 设置日志级别
3. 定义handler：主要有StreamHandler和FileHandler。
4. 控制格式化输出
5. 启动日志文件

import logging
logger = logging.getLogger("test")#初始化

#设置级别
logger.setLevel(logging.DEBUG)

#定义handler
    #控制台输出
sh = logging.StreamHandler()
sh.setLevel(logging.ERROR)
    #文件输出
fh = logging.FileHandler('test.log')
fh.setLevel(logging.DEBUG)

#格式化输出
format = logging.Formatter(
    '时间:%(asctime)s,'
    '日志级别:%(levelname)s,'#逗号写在里面
    '日志信息:%(message)s,'
    '日志名字:%(name)s'
)
#将格式化传到控制台和文件
sh.setFormatter(format)
fh.setFormatter(format)

#启动日志文件
logger.addHandler(sh)
logger.addHandler(fh)

if __name__ == '__main__':
       def f(a):#日志记录函数
        try:
            res = 5.0/a
            logger.info("正常运行")
        except Exception as e:
            logger.error(e)
       f(0)

时间:2018-10-11 16:55:57,156,日志级别:ERROR,日志信息:float division by zero,日志名字:test

简单点说就是：日志器（logger）是入口，真正干活儿的是处理器（handler），处理器（handler）还可以通过过滤器（filter）和格式器（formatter）对要输出的日志内容做过滤和格式化等处理操作。