Python_logging模块

日志：方便用户了解系统、软件或应用的运行情况，及时发现问题并快速定位、解决问题。

一个日志信息对应的是一个事件的发生，而一个事件需要包括的几个内容：

• 事件发生时间
• 事件发生位置
• 事件发生严重程度（日志级别）
• 事件内容

还可以包括其他信息如：ID，进程名称，线程ID，线程名称等

logging模块日志等级（日志等级依次升高，日志信息量依次减少）：

1. DEBUG： 最详细的日志信息，典型应用场景为：问题诊断（开发应用程序或部署开发环境时）
2. INFO：信息详细程度仅次于DEBUG，通常只记录关键节点信息，用于确认一切都是按照我们预期那样的进行工作（开发应用程序或部署开发环境时）
3. WARNING：当某些不期望的事情发生时记录的信息（如，磁盘可用空间较低）此时应用程序在正常运行（应用上线或部署生产环境时）
4. ERROR：由于发生一个更严重的问题导致某些功能不能正常运行时记录的信息（应用上线或部署生产环境时）
5. CRITICAL：当发生严重错误，导致应用程序不能继续运行时记录的信息（应用上线或部署生产环境时）

注：logging模块中，程序指定一个日志级别后，应用程序只会记录并输出大于或者等于该指定日志级别的日志信息，小于该等级的日志记录将会被丢弃

 1.logging模块定义的模块级别的常用函数

logging.debug(msg,*args,**kwargs)	创建一条严重级别为DEBUG的日志记录
logging.info(msg,*args,**kwargs)	创建一条严重级别为INFO的日志记录
logging.warning(msg,*args,**kwargs)	创建一条严重级别为WARNING的日志记录
logging.error(msg,*args,**kwargs)	创建一条严重级别为ERROR的日志记录
logging.critical(msg,*args,**kwargs)	创建一条严重级别为CRITICAL的日志记录
logging.log(level,*args,**kwargs)	创建一条严重级别为level的日志记录
logging.basicConfig(**kwargs)	对“要记录的日志级别”、“日志格式”、“日志输出位置”、“日志文件打开模式”等信息进行一次性配置

注：日志记录函数只打印级别比日志器设置的级别高的日志记录，而比日志器设置的级别低的日志记录将会被丢弃

其中，logging.debug(),logging.info()等方法的定义中，**kwargs参数支持3个关键字参数

exc_info:  布尔值，若为True，则会将异常信息添加到日志消息中，如果没有异常信息则添加None到日志信息中

stack_info:  布尔值， 默认为False，若为True，栈信息将会被添加到日志信息中

extra:  字典（dict）参数，用于自定义消息格式中所包含的字段，但它的key不能和logging模块定义的字段冲突

 logging.basicConfig()函数

 可接收的关键字参数：

filename	指定日志输出目标文件的文件名，指定该设置项后日志信息不会被输出到控制台
filemode	指定日志文件的打开模式，默认为“a”,注：只有filename指定时该选项才有效
format	指定日志输出时所包含的字段信息以及它们的顺序，即指定日志格式字符串
datefmt	指定日期/时间格式，注：只有format中包含时间字段%（asctime）时该选项才有效
level	指定日志器的日志级别
stream	指定日志输出目标流，如sys.stdout等，注：stream和filename不能同时提供，否则会报错
style	指定format格式字符串的风格，可取值为‘%’、‘{’和‘$’，默认为‘%’
dandlers	指定该选项，则创建多个Headler的可迭代对象，都将会被添加到根日志下，注:filename、stream和handlers只能存在一个

注：logging.basecConfig()只有第一次调用该函数才会起作用，

实例：

logging.basicConfig(filename='example.log', level=logging.INFO, format='%(asctime)s %(message)s', datefmt='%Y-%m-%d %H:%M:%S')  # basicConfig()对打印的日志信息进行一次性配置
logging.debug("debug ")
logging.info("info ")
logging.warning("waring ")

2018-10-13 17:22:52 info 
2018-10-13 17:22:52 waring 

 2.logging模块相关类

1>.logger类：日志器，提供了应用程序可一直使用的接口

常用的配置方法：

Logger.setLevel()	设置日志器将会处理的日志消息的最低严重级别，小于设置的最低严重级别的级别消息将会被丢弃
Logger.addHandler() 和 Logger.removeHandler()	为该Logger对象添加 和 移除一个Handler对象
Logger.addFilter() 和 Logger.removeFilter()	为该Logger对象添加 和 移除一个Filter对象

配置完成后，创建日志记录的方法：

Logger.debug(), Logger.info(), Logger.warning(), Logger.error(), Logger.critical()	创建一个与它们的方法名对应级别的日志记录
Logger.exception()	创建一个类似与Logger.error()的日志消息，但它将会多输出堆栈追踪信息，通常只是在exception handler中调用该方法
Logger.log()	需要获取一个明确的日志level参数来创建一个日志记录

其中，logging.getLogger()方法有一个可选参数name，该参数表示将要返回的日志器的名称标识，如果不提供该参数，则其值默认为root，若以相同的name参数多次调用getLogger方法，将会返回指向同一个logger对象的引用

2>.Handler类：处理器，将logger创建的日志记录发送到合适的目的输出

相关配置方法：（内建handler对象）

Handler.setLevel()	设置handler将会处理的日志消息的最低严重级别
Handler.setFormatter()	为handler设置一个格式器对象
Handler.addFilter() 和 Handler.removeFilter()	为handler添加 和 删除一个过滤器对象

常用的Handler接口：

logging.StreamHandler	将日志消息发送到输出到Stream（流），如std.out,std.err或任何file-like对象
logging.FileHandler	将日志消息发送到磁盘文件，默认情况下文件大小会无限增长
logging.handlers.RotatingFileHandler	将日志消息发送到磁盘文件，并支持日志文件按大小切割
logging.handlers.HTTPHandler	将日志消息以GET或POST的方式发送给一个HTTP服务器
logging.handlers.SMTPHandler	将日志消息发送给一个指定的email地址
logging.NullHandler	该Handler实例会忽略error messages通常被想使用logging的library开发者使用来避免“No handlers could be found for logger XXX”信息出现

3>.Filter类：过滤器，提供了更细粒度的控制工具来决定输出那一条日志记录，丢弃那一条日志记录

logging.Filter(name=‘ ’)：若name的值为空字符串，则允许所有的日志事件通过过滤

filter（record）：用于具体控制传递的record记录是否能通过过滤，返回值为0表示不能通过过滤，返回值非零表示可以通过过滤

 注：在filter()方法内部改变record可以添加、删除或修改一些属性

 4>.Formatter 类：格式器，决定日志记录的最终输出格式

Formatter类的构造方法：

 logging.Formatter.__init__(fmt=None,datefmt=None,style="%")

• fmt: 指定消息格式化字符串，如果不指定该参数则默认使用message的原始值
• datefmt：指定日期格式字符串，如果不指定该参数则默认使用“%Y-%m-%d %H: %M: %S”　　
•  style：可取值为‘%’，‘{’和‘$’,如果不指定默认使用‘%’

实例：把日志同时打印到屏幕和文件里

import logging

logger = logging.getLogger('Test_log')  # 生成logger对象
logger.setLevel(logging.DEBUG)       # 这里的debug为全局的控制级别，优先级最高

ch = logging.StreamHandler()      # 屏幕输出
ch.setLevel(logging.DEBUG)       # 级别为debug，注释了也打印debug级别，因为全局的为debug

fh = logging.FileHandler('text.log')  # 把日志写在文件里
fh.setLevel(logging.WARNING)          # 级别为warning

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

ch.setFormatter(formatter)    # 把格式赋给屏幕
fh.setFormatter(formatter)    # 把格式赋给文件

logger.addHandler(ch)
logger.addHandler(fh)

logger.debug('debug message')
logger.info('info message')
logger.warn('warn message')
logger.error('error message')
logger.critical('critical message')

2018-10-13 17:41:14,159-Test_log-DEBUG-debug message
2018-10-13 17:41:14,159-Test_log-INFO-info message
2018-10-13 17:41:14,159-Test_log-WARNING-warn message
2018-10-13 17:41:14,159-Test_log-ERROR-error message
2018-10-13 17:41:14,159-Test_log-CRITICAL-critical message

2018-10-13 17:41:40,072-Test_log-WARNING-warn message
2018-10-13 17:41:40,072-Test_log-ERROR-error message
2018-10-13 17:41:40,072-Test_log-CRITICAL-critical message

3.logging模块定义的字符串字段（在format格式字符串中的字段）

属性名	使用格式
asctime	%(asctime)s	日志事件发生的时间，如：2018-10-13 17:46:45
create	%(created)f	日志事件发生的时间--时间戳
relativeCreated	%(relativeCreated)d	日志事件发生的时间相对与logging模块加载时间的相对毫秒数
msecs	%(msecs)d	日志事件发生时间的毫秒部分
levelname	%(levelname)s	该日志记录的文字形式的日子级别
levelno	%(levelno)s	该日志记录的数字形式
name	%(name)s	所使用的日志器名称，默认为root，因为默认使用的是rootLogger
message	%(message)s	日志记录的文本内容(用户输出的消息)，通过 msg%args 计算得到
pathname	%(pathname)s	调用日志输出函数（记录函数）的模块的完整路径名，可能没有
filename	%(filename)s	调用日志输出函数（记录函数）的模块的文件名，包含文件后缀
module	%(module)s	调用日志输出函数（记录函数）的模块名
funcName	%(funcName)s	调用日志输出函数（记录函数）的函数名
lineno	%(lineno)s	调用日志输出函数（记录函数）的语句所在的代码行号
process	%(process)d	进程ID
processName	%(processName)s	进程名称，Python3.1新增
thread	%(thread)d	线程ID
threadName	%(thread)s	线程名称

参考笔记：https://www.cnblogs.com/yyds/p/6901864.html