python日志处理模块
- 2020 年 1 月 3 日
- 筆記
一 日志处理模块概述
1 日志级别
日志级别level |
数值 |
---|---|
CRITICAL |
50 |
ERROR |
40 |
WARNING |
30 ,默认日志级别 |
INFO |
20 |
DEBUG |
10 |
NOTSET |
0,表示不设置 |
日志级别是指产生日志的严重程度 设置一个级别后,严重程度低于次级别的日志消息将会被忽略 数字越高,优先级别越高
#!/usr/bin/python3.6 #conding:utf-8 import threading import time import logging logging.basicConfig(level=logging.INFO) #设置日志级别为info def add(x,y): logging.warning(x+y) # 此处定义的日志级别是warning,因此能够被打印出来,默认的日志打印格式是 级别:用户:信息 t=threading.Timer(1,add,args=(3,4)) # 此处表示6秒后出结果 t.start()
结果如下

默认的日志打印格式是级别:用户:信息
2 格式字符串
1 常见格式
属性名 |
格式 |
描述 |
---|---|---|
日志消息内容 |
%(message)s |
当调用formatter.format() 时设置 |
asctime |
%(asctime)s |
创建logrecord时的可读时间,默认格式是Y-m-d H:M:S, (逗号后面的数字是毫秒部分的时间) |
函数名 |
%(funcName)s |
日志调用所在的函数名 |
日志级别名称 |
%(levelname)s |
消息级别名称,DEBUG,INFO,WARNING,ERROR,CRITICAL |
日志级别数值 |
%(levelno)s |
消息的级别数字DEBUG,INFO,WARNING,ERROR,CRITICAL |
行号 |
%(lineno)d |
日志调用所在源码行号 |
模块 |
%(module)s |
模块(filename的名字部分) |
进程ID |
%(process)d |
进程ID |
线程ID |
%(thread)d |
线程ID |
进程名称 |
%(processName)s |
进程名 |
线程名称 |
%(threadName)s |
线程名字 |
d 格式化成数字,s格式化成字符串
#!/usr/bin/python3.6 #conding:utf-8 import threading import time FORMAT="%(asctime)-15stThread Name: %(threadName)st%(message)s" # 此处定义日志格式 import logging logging.basicConfig(level=logging.INFO,format=FORMAT) #设置日志级别为info,此处format为引用日志格式 def add(x,y): logging.warning(x+y) # 此处定义的日志级别是warning,因此能够被打印出来 t=threading.Thread(target=add,args=(3,4),name='a1') t.start()
结果如下

2 格式化时间字串
#!/usr/bin/python3.6 #conding:utf-8 import threading import time FORMAT="%(asctime)-15stThread Name: %(threadName)st%(message)s" # 此处定义日志格式 import logging logging.basicConfig(level=logging.INFO,format=FORMAT,datefmt='%y-%m-%d %H:%M:%S %z') #设置日志级别为info,此处format为引用日志格式,此处通过定义日志格式来 # 确定打印的日志为正常格式,其和%(asctime)互相作用 def add(x,y): logging.warning(x+y) # 此处定义的日志级别是warning,因此能够被打印出来 t=threading.Thread(target=add,args=(3,4),name='a1') t.start()
结果如下

不同打印风格
#!/usr/bin/python3.6 #conding:utf-8 import threading import time FORMAT="%(asctime)-15stThread Name: %(threadName)st%(message)s" # 此处定义日志格式 import logging logging.basicConfig(level=logging.INFO,format=FORMAT,datefmt='%y-%m-%d %H:%M:%S %z') #设置日志级别为info,此处format为引用日志格式,此处通过定义日志格式来 # 确定打印的日志为正常格式,其和%(asctime)互相作用 def add(x,y): logging.warning("%d",x+y) # 此处定义的日志级别是warning,因此能够被打印出来,此处是c风格处理日志 logging.info("{} 值为 {}".format(threading.enumerate(),x+y)) # 此处是format方式处理 t=threading.Thread(target=add,args=(3,4),name='a1') t.start()
打印结果如下

3 新变量处理
定义一个新的变量来进行存储
#!/usr/bin/python3.6 #conding:utf-8 import threading import time FORMAT="%(asctime)s t threadName: %(threadName)s t %(message)s t %(myname1)s" # 此处定义日志格式,此处定义变量名为myname import logging logging.basicConfig(level=logging.INFO,format=FORMAT,datefmt='%y-%m-%d %H:%M:%S %z') #设置日志级别为info,此处format为引用日志格式,此处通过定义日志格式来 # 确定打印的日志为正常格式,其和%(asctime)互相作用 d={"myname1":"zhangsan"} #此处定义变量值为zhangsan,是字典格式 def add(x,y): logging.warning("%d",x+y,extra=d) # 此处定义的日志级别是warning,因此能够被打印出来,此处是c风格处理日志,通过此处引用extra 字典得到结果 t=threading.Thread(target=add,args=(3,4),name='a1') t.start()
结果如下

4 输出到文件
#!/usr/bin/python3.6 #conding:utf-8 import threading import time FORMAT="%(asctime)s t threadName: %(threadName)s t %(message)s t %(myname1)s" # 此处定义日志格式,此处定义变量名为myname import logging logging.basicConfig(level=logging.INFO,format=FORMAT,datefmt='%y-%m-%d %H:%M:%S %z',filename='/root/test.log') #设置日志级别为info,此处format为引用日志格式,此处通过定义日志格式来 # 确定打印的日志为正常格式,其和%(asctime)互相作用,此处指定打印的路径,若不存在,则创建并追加,如此下面便不会再次打印 d={"myname1":"zhangsan"} #此处定义变量值为zhangsan,是字典格式 def add(x,y): logging.warning("%d",x+y,extra=d) # 此处定义的日志级别是warning,因此能够被打印出来,此处是c风格处理日志,通过此处引用extra 字典得到结果 t=threading.Thread(target=add,args=(3,4),name='a1') t.start()
结果如下

其相当于输出重定向到文件
二 logger 类
1 概述
使用工厂方法返回一个logger实例。 logger.getLogger([name=None)] 指定name,返回一个名称为name的Logger实例,如果再次使用相同的名字,是实例化一个对象。 未指定name,则返回logger实例,名称是root。及根Logger Logger 是层次结构的,使用. 点号分割。如'a',或'a.b'或'a.b.c.d',a是a.b的父parent,a.b是a的子child,对于foo来说,名字为foo.bar,foo.bar.baz,foo.bam都是foo的后代。
2 基本实验
1 打印空name的logger
#!/usr/bin/python3.6 #conding:utf-8 import logging log=logging.getLogger() print (log.name) #打印当前实例的名称,其默认名称为root print (type(log))# 打印当前实例的类型
结果如下

2 打印非空name的logger
#!/usr/bin/python3.6 #conding:utf-8 import logging log=logging.getLogger('a') # 此处定义其名称, print (log.name) #打印当前实例的名称 print (log,type(log))# 打印当前实例的类型和实例情况
结果如下

3 打印层次化logger
#!/usr/bin/python3.6 #conding:utf-8 import logging #!/usr/bin/poython3.6 #conding:utf-8 import logging root=logging.getLogger() print (root,id(root)) # 此处返回跟和跟地址 log=logging.getLogger('a') # 此处定义其名称, print (log.name) #打印当前实例的名称 print (log,type(log),log.parent,id(log),id(log.parent))# 打印当前实例的类型和实例情况及其父类情况,此处打印当前给情况和父根情况 # log1=logging.getLogger('a.b') print (log1.name) print (log1,type(log1),log1.parent,id(log1.parent))# 此处打印当前根父跟情况
结果如下

上述表明,其a.b的父类是a,a的父类是root ,其直接存在父子级别
4 继承和重用
#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s %(thread)d %(message)s" logging.basicConfig(level=logging.INFO,datefmt='%Y-%m-%d %H:%M:%S',format=FORMAT) root=logging.getLogger() root.warning('my root') log=logging.getLogger('a') # 此处定义其名称, log.warning('my log') log1=logging.getLogger('a.b') log1.warning('my log1')

5 规范化定义name
#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s %(thread)d %(message)s" logging.basicConfig(level=logging.INFO,datefmt='%Y-%m-%d %H:%M:%S',format=FORMAT) root=logging.getLogger() print (root,id(root)) root.warning('my root') loga=logging.getLogger(__name__) # 此处使用模块名称进行定义名字 print (loga,id(loga),loga.name) loga.warning('my loga')# loga.name 也不能在此中打印出来 logb=logging.getLogger("{}.{}".format(__name__,'abcd')) # 此处使用模块名称下的具体方法定义名称,通过format进行字符串的拼接 print (logb,id(logb),logb.name) logb.warning('my logb') # logb.name不能打印出来
结果如下

6 获取和修改日志级别
获取和设置相关级别
#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s %(thread)d %(message)s" logging.basicConfig(level=logging.INFO,datefmt='%Y-%m-%d %H:%M:%S',format=FORMAT) root=logging.getLogger() print (root,id(root)) print (root.getEffectiveLevel())#此处打印日志级别 loga=logging.getLogger(__name__) # 此处使用模块名称进行定义名字 loga.warning('my loga')# loga.name 也不能在此中打印出来 print (loga.getEffectiveLevel())#此处打印日志级别 logb=logging.getLogger("{}.{}".format(__name__,'abcd')) # 此处使用模块名称下的具体方法定义名称,通过format进行字符串的拼接 logb.warning('my logb') # logb.name不能打印出来 logb.debug('my debug') # 此处的debug日志将不能被打印出来 print (logb.getEffectiveLevel()) #此处打印日志级别
结果如下

修改日志级别并进行配置和获取
#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s %(thread)d %(message)s" logging.basicConfig(level=logging.INFO,datefmt='%Y-%m-%d %H:%M:%S',format=FORMAT) root=logging.getLogger() print (root,id(root)) print (root.getEffectiveLevel())#此处打印日志级别 loga=logging.getLogger(__name__) # 此处使用模块名称进行定义名字 loga.info('my loga')# loga.name 也不能在此中打印出来 print (root.getEffectiveLevel())#此处打印日志级别 print (loga.getEffectiveLevel())#此处打印日志级别 loga.setLevel(28)# 此时日志级别位于INFO 和 WARNING之间, print (loga.getEffectiveLevel()) # 获取修改后的日志级别 print ('+'*20,'logb') logb=logging.getLogger("{}.{}".format(__name__,'abcd')) # 此处使用模块名称下的具体方法定义名称,通过format进行字符串的拼接 logb.info('my logb') # 此处因为自身没有配置日志级别,因此继承了上面的日志级别,因此,其不能打印 logb.setLevel(10) logb.info('my logb') # 此处因为自身设置了日志级别,因此其可以打印 logb.warning('my debug') print (logb.getEffectiveLevel()) #此处打印日志级别
结果如下

7 总结:
全局可以设定,但自己模块可以根据自己的情况进行调整和修改 上述用于设置模块和模块对应函数或类的日志级别,通过上述的定义可以确定打印日志的级别和相关的配置情况 向在模块级别的进行配置和修改日志的级别设置 想做个性化比较难 重要的主要是level和format 的情况
2 handler
1 概述
handler 控制日志信息的输出目的地,可以是控制台,文件 可以单独设置level 可以单独设置格式 可以设置过滤器
handler分为 1 StreamHandler # 不指定使用sys.stderr A FileHandler # 文件输出 B _StderrHandler # 标准输出 2 NullHandler # 什么都不做 Handler父类 ,FileHandle和_StderrHandler和NullHandler是子类,子类可以继承父类的相关属性
2 handler 和 logger的关系
#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s Threadinfo: %(threadName)s %(message)s" logging.basicConfig(level=logging.INFO,format=FORMAT) log1=logging.getLogger('s') #此处实例化出来一个对象 log1.setLevel(logging.WARNING) #设置此对象的相关属性 h1=logging.StreamHandler() # 实例化一个标准输出的handler h1.setLevel(logging.INFO) # 设置handler的级别 log1.addFilter(h1) # 将h1加入到log1 log1.info('info log1') # 打印INFO日志。 log1.warning('warning log1') # 打印WARING ,此处只能打印WAENING
结果如下

此处表明,虽然handler设置了info级别,但其没不能影响log1的设置,仍然不能打印info级别
#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s Threadinfo: %(threadName)s %(message)s" logging.basicConfig(level=logging.INFO,format=FORMAT) log1=logging.getLogger('s') #此处实例化出来一个对象 log1.setLevel(logging.INFO) #设置此对象的相关属性 h1=logging.StreamHandler() # 实例化一个标准输出的handler h1.setLevel(logging.ERROR) # 设置handler的级别 log1.addFilter(h1) # 将h1加入到log1 log1.warning('warning log1') # 打印WARING ,此处只能打印WAENING log1.info('info log1') log2=logging.getLogger('s.s1') #此处继承了s1的属性 print (log2.getEffectiveLevel()) log2.warning('wangring log2') #此处设置的warning 和handler中设置的ERROR不冲突,因为ERROR 不针对当前设置
结果如下

此处虽然handler设置了ERROR 级别,但info级别还是能够打印出来,其不会影响当前级别的日志,而继承的日志也没受到handler的影响直接打印 日志输出到文件
#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s Threadinfo: %(threadName)s %(message)s" logging.basicConfig(level=logging.INFO,format=FORMAT) log1=logging.getLogger('s') #此处实例化出来一个对象 log1.setLevel(logging.INFO) #设置此对象的相关属性 h1=logging.FileHandler('/root/test1.log') # 实例化一个文件输出的handler h1.setLevel(logging.ERROR) # 设置handler的级别 log1.addHandler(h1) # 将h1加入到log1 log1.warning('warning log1') # 打印WARING ,此处只能打印WAENING log1.info('info log1') log1.error('error log1') #打印error级别
结果如下

文件中结果如下

#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s Threadinfo: %(threadName)s %(message)s" logging.basicConfig(level=logging.INFO,format=FORMAT) log1=logging.getLogger('s') #此处实例化出来一个对象 log1.setLevel(logging.WARNING) #设置此对象的相关属性 h1=logging.FileHandler('/root/test1.log') # 实例化一个文件输出的handler h1.setLevel(logging.INFO) # 设置handler的级别 log1.addHandler(h1) # 将h1加入到log1 log1.warning('warning log1') # 打印WARING ,此处只能打印WAENING log1.info('info log1')
结果如下

文件结果

#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s Threadinfo: %(threadName)s %(message)s" logging.basicConfig(level=logging.INFO,format=FORMAT) log1=logging.getLogger('s') #此处实例化出来一个对象 log1.setLevel(logging.WARNING) #设置此对象的相关属性 h1=logging.FileHandler('/root/test1.log') # 实例化一个文件输出的handler h1.setLevel(logging.INFO) # 设置handler的级别 log1.addHandler(h1) # 将h1加入到log1 log1.warning('warning log1') # 打印WARING ,此处只能打印WAENING log1.info('info log1') log2=logging.getLogger('s.s1') print (log2.getEffectiveLevel()) log2.info('log2 info')

文件结果

#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s Threadinfo: %(threadName)s %(message)s" logging.basicConfig(level=logging.INFO,format=FORMAT) log1=logging.getLogger('s') #此处实例化出来一个对象 log1.setLevel(logging.INFO) #设置此对象的相关属性 h1=logging.FileHandler('/root/test1.log') # 实例化一个文件输出的handler h1.setLevel(logging.INFO) # 设置handler的级别 log1.addHandler(h1) # 将h1加入到log1 log1.warning('warning log1') # 打印WARING ,此处只能打印WAENING log1.info('info log1') log2=logging.getLogger('s.s1') print (log2.getEffectiveLevel()) log2.info('log2 info')
结果

文件结果

3 添加格式化处理
#!/usr/bin/python3.6 #conding:utf-8 import logging FORMAT="%(asctime)s Threadinfo: %(threadName)s %(message)s" logging.basicConfig(level=logging.INFO,format=FORMAT) log1=logging.getLogger('s') #此处实例化出来一个对象 log1.setLevel(logging.INFO) #设置此对象的相关属性 h1=logging.FileHandler('/root/test1.log') # 实例化一个文件输出的handler h1.setLevel(logging.INFO) # 设置handler的级别 fmtr=logging.Formatter("%(asctime)s Threadinfo: %(threadName)s %(message)s %(thread)s") h1.setFormatter(fmtr) log1.addHandler(h1) # 将h1加入到log1 log1.warning('warning log1') # 打印WARING ,此处只能打印WAENING log1.info('info log1') log2=logging.getLogger('s.s1') print (log2.getEffectiveLevel()) log2.info('log2 info')
结果如下

文件结果如下

4 handlers 和 formatter
import logging root=logging.getLogger() root.setLevel(logging.ERROR) print ('root',root.handlers) #打印handler列表 h0=logging.StreamHandler() h0.setLevel(logging.WARNING) root.addHandler(h0) print ('root',root.handlers) # 打印列表 for h in root.handlers: print ("root handler = {} ,formatter= {}".format(h,h.formatter)) # 打印默认的formatter
结果如下

import logging root=logging.getLogger() root.setLevel(logging.ERROR) print ('root',root.handlers) #打印handler列表 h0=logging.StreamHandler() h0.setLevel(logging.WARNING) root.addHandler(h0) print ('root',root.handlers) # 打印列表 for h in root.handlers: print ("root handler = {} ,formatter= {}".format(h,h.formatter)) # 打印默认的formatter log1=logging.getLogger('s') log1.setLevel(logging.ERROR) h1=logging.FileHandler('/root/test2.log') log1.addHandler(h1) print ('log1',log1.handlers) log2=logging.getLogger('s.s1') log2.setLevel(logging.CRITICAL) h2=logging.FileHandler('/root/test2.log') h2.setLevel(logging.WARNING) print ('log2 formatter',h2.formatter) # handler 默认无Formatter f2=logging.Formatter("log2 %(name)s %(asctime)s %(message)s") h2.setFormatter(f2) print ('log2.formatter',h2.formatter) log2.addHandler(h2) print ('log2',log2.handlers)
结果为

文件结果为

5 总结:
1 每一个logger实例的level如同入水口,让水流进来,如果这个门槛太高,水流就不能进来,其相关低级别的信息一定不能被打印出来
2 如果level没有设置,则使用父类logger的,如果父类没有,则继续寻找父类的,最终找到root,而root的默认设置是WARNING
3 消息传递流程 在某个logger上产生某种级别的消息,首先和logger的level检查,如果消息level低于logger的EffectiveLevel有效级别,则丢弃消息,如果通过(大于等于)检查后,消息交给所有的handler处理,每一个handler需要和自己的level比较来决定是否处理,如果没有一个handler,或者消息已经被处handler处理过了,则需要通过本logger的propagate属性是否是True,True则会把这个消息继续传递给父logger,父logger成为新的logger。新的logger直接把消息交给新的logger的所有handler,handler都处理完了,如果paragate属性是True,新的logger的父成为新的logger,它的所有handler处理消息。
4 logger 实例初始化的paragate属性为True,及允许向父传递logger消息
5 logging.basicConfig
如果root没有handler,就默认创建一个StreamHandler ,如果设置了filename,则就创建了一个FileHandler,如果设置了format参数,它就会生成一个formatter对象,并把这个formatter加入到刚才创建的handler上,然后把这些handler加入到root.handlers列表上,level是设置给root logger的。如果root.handlers列表不是空,则logging.basicConfig的调用什么都不做。
6 filter过滤器
可以为handler增加过滤器,所以过滤器只影响某一个handler,不会影响整个处理流程
import logging FORMAT="%(asctime)s %(thread)d %(message)s" logging.basicConfig(level=logging.ERROR,format=FORMAT,datefmt="%y-%m-%d %H:%M%S %z") #重新格式化传值,定义日志输出到文件 root=logging.getLogger() print (root,id(root)) loga=logging.getLogger('s') # 模块和模块下的某个函数或类 print (loga,id(loga),id(loga.parent)) loga.setLevel(logging.INFO) print (loga.getEffectiveLevel()) #默认对应的是常量20 hadr=logging.FileHandler('/root/loga.txt') # 定义,不指定则是标准错误输出 hadr.setLevel(logging.INFO) fmtr=logging.Formatter("%(asctime)s %(thread)d %(threadName)s %(message)s") #此处是一个实例。此处可以自己定义 hadr.setFormatter(fmtr) fltr=logging.Filter('s') # 此处设置过滤器为s,则为s,s.s1均可通过 hadr.addFilter(fltr) loga.addHandler(hadr) logb=logging.getLogger('s.s1') logb.getEffectiveLevel() logb.info('logb info')
结果如下

文件结果如下

import logging FORMAT="%(asctime)s %(thread)d %(message)s" logging.basicConfig(level=logging.ERROR,format=FORMAT,datefmt="%y-%m-%d %H:%M%S %z") #重新格式化传值,定义日志输出到文件 root=logging.getLogger() print (root,id(root)) loga=logging.getLogger('s') # 模块和模块下的某个函数或类 print (loga,id(loga),id(loga.parent)) loga.setLevel(logging.INFO) print (loga.getEffectiveLevel()) #默认对应的是常量20 hadr=logging.FileHandler('/root/loga.txt') # 定义,不指定则是标准错误输出 hadr.setLevel(logging.INFO) fmtr=logging.Formatter("%(asctime)s %(thread)d %(threadName)s %(message)s") #此处是一个实例。此处可以自己定义 hadr.setFormatter(fmtr) fltr=logging.Filter('s') # 此处设置过滤器为s,则为s,s.s1均可通过 hadr.addFilter(fltr) loga.addHandler(hadr) loga.info('loga info') logb=logging.getLogger('s.s1') logb.getEffectiveLevel() logb.info('logb info') logc=logging.getLogger('s.s1') logc.getEffectiveLevel() logc.info('logc info')
结果如下

文件如下

import logging FORMAT="%(asctime)s %(thread)d %(message)s" logging.basicConfig(level=logging.ERROR,format=FORMAT,datefmt="%y-%m-%d %H:%M%S %z") #重新格式化传值,定义日志输出到文件 root=logging.getLogger() print (root,id(root)) loga=logging.getLogger('s') # 模块和模块下的某个函数或类 print (loga,id(loga),id(loga.parent)) loga.setLevel(logging.INFO) print (loga.getEffectiveLevel()) #默认对应的是常量20 hadr=logging.FileHandler('/root/loga.txt') # 定义,不指定则是标准错误输出 hadr.setLevel(logging.INFO) fmtr=logging.Formatter("%(asctime)s %(thread)d %(threadName)s %(message)s") #此处是一个实例。此处可以自己定义 hadr.setFormatter(fmtr) fltr=logging.Filter('a') # 此处设置过滤器为s,则为s,s.s1均可通过 hadr.addFilter(fltr) loga.addHandler(hadr) loga.info('loga info') logb=logging.getLogger('s.s1') logb.getEffectiveLevel() logb.info('logb info') logc=logging.getLogger('s.s1') logc.getEffectiveLevel() logc.info('logc info')
文件如下

消息loga,它的名字是's',因此过滤器名字设置为s,则s.s1,s.x和s都能通过,但其他的则不能通过,不设置过滤器名字,所有消息都能通过,设置为a,则和s,s.s1和s.s2无任何关系,因此其不能使用,实例对象只有一个,一旦同名,也是只有一个,线程的不安全不会影响logging,只会影响print。