logging模块浅记

logging模块的使用方式

1.使用logging提供的模块级别函数(对日志系统相关类的封装)

logging.debug(msg,*args,**kwargs)
# debug可以替换成其他四种日志级别
## 有个例外的(Don"t know) ==>对root logger进行一次性配置
logging.basicConfig(**kwargs)

2.使用Logging日志系统的四大组件

loggers 提供应用程序代码直接使用的接口
handlers 用于将日志记录发生到指定的目的位置
filters 提供更细粒度的日志过滤功能
formatters 控制日志信息的最终输出格式

3.重要的自定义基础配置（不会配置）

logging.basicConfig(**kwargs)

fielname :指定日志输出文件名
filemode:指定日志文件的打开模式
format:指定日志格式字符串
datefm：只当日期/格式
level：日志器的日志级别
stream:指定日志输出目标stream(不理解)

4.logging模块定义的格式字符串字段

5.补充说明

logging.basicConfig()函数是一个一次性的简单配置工具，只在第一次调用该函数时会起作用，后续再次调用就不起作用
日志器(Logger)是有层级关系的，上面调用的logging模块级别函数是RootLogger类的实例，其名称为'root'，是处于日志器层级关系最顶级的日志器，且该实例是以单例模式存在的
使用指定字符串/变量格式化输出，将这些数据作为第二个参数*args的值传递

logging.warning('%s is %d years old.', 'Tom', 10)

第三个参数(可选)

logging.debug(), logging.info()等方法的定义中，除了msg和args参数外，还有一个**kwargs参数。它们支持3个关键字参数: exc_info, stack_info, extra，下面对这几个关键字参数作个说明。
关于exc_info, stack_info, extra关键词参数的说明:
exc_info： 其值为布尔值，如果该参数的值设置为True，则会将异常异常信息添加到日志消息中。如果没有异常信息则添加None到日志信息中。
stack_info： 其值也为布尔值，默认值为False。如果该参数的值设置为True，栈信息将会被添加到日志信息中。
extra： 这是一个字典（dict）参数，它可以用来自定义消息格式中所包含的字段，但是它的key不能与logging模块定义的字段冲突。

logging日志模块四大组件

日志器 Logger 提供了应用程序可一直使用的接口
处理器 Handler 将logger创建的日志记录发送到合适的目的地输出
Filter 过滤器
Formatter 决定日志记录的最终输出格式

组件之间的关系

日志器(logger)是入口，真正干活的是处理器(handler),处理器可以通过过滤器和格式器对要输出的日志内容做过滤和格式化操作

四大组件相关类

Logger

配置方法

.setLevel() 设置日志器将会处理的日志消息的最低严重级别
.addHandler()和Logger.removeHandler()为该logger对象添加和移出一个handler对象。
addFilter()和removeFilter() 为该logger对象添加和移出一个filter对象

创建日志记录

首先5大等级，创建与他们方法名对应等级的日志记录
logger.execption() 创建一个类似于Logger.error()的日志消息。
Logger.log() 需要获取一个明确的日志level参数来创建一个一个日志记录

创建logger对象

# 生成日志对象/或者可以通过logging类的实例化
logger = logging.getLogger()

filter类

并不知如何实现一个Filter类。
基本概念:它只允许某个logger层级下的日志事件通过过滤。

class logging.Filter(name='')
     filter(record)

参考文档