python基础_标准库-logging

郎林發表於 2021-11-11 19:00:00

<h3>一、简介 </h3>
1、概要：logging 是python  用于记录日志的标准模块
2、logging 日志库定义的日志级别：
<table style="height: 236px; float: left; border: 0 solid rgba(0, 0, 0, 1); background-color: rgba(240, 248, 255, 1); width: 736px" border="0" align="center">
<tbody>
<tr>
<td>级别</td>
<td>级别数值（int）</td>
<td>使用时机</td>
</tr>
<tr>
<td>DEBUG</td>
<td>10</td>
<td>详细信息</td>
</tr>
<tr>
<td>INFO</td>
<td>20</td>
<td>正常运行过程中产生的一些信息</td>
</tr>
<tr>
<td>WARNING</td>
<td>30</td>
<td>警告信息，虽然程序正常运行，但有可能发生错误</td>
</tr>
<tr>
<td>ERROR</td>
<td>40</td>
<td>运行出错，程序已经不能执行一些功能了</td>
</tr>
<tr>
<td>CRITICAL</td>
<td>50</td>
<td>严重错误，程序已经不能正常运行</td>
</tr>
</tbody>
</table>
 
3、logging 日志库的四类组件（四个类）
Logger :记录器   提供了应用程序代码直接使用的接口（是用记录器去记录日志，简单理解就是记录日志的工具，类似笔）（备注：一个记录器可以对接多个处理器）
Handlers : 处理器将记录器产生的日志发送至指定的目的地（就是日志输出的位置，比如输出到本地文件，控制台，或者发送至Email 等网络上的任意位置，）
Filters: 过滤器提供了更细粒度的功能，用于确定要输出的日志记录 (过滤日志用的)
Fomatters: 格式器：指定最终输出中日志记录的样式。（日志信息格式化用的）
<h3>二、logging 模块的工作流程</h3>
<img src="https://img2020.cnblogs.com/blog/2560969/202111/2560969-20211111154425398-2101835.png">
<h4> Logger 记录器：</h4>
1、创建记录器对象：
logger=logging.getLogger(name=None)      name  如果不传则返回一个 root  logger， 
2、设置日志记录器的级别
loger.setLevel()
3、讲日志内容传递到关联的handler 
loger.addHandler()  关联一个处理器
loger.removeHandler()  取消关联
 
<h4>Handler 处理器</h4>
StreamHandler类型：标准的输出stdout (比如显示器输出，控制台输出）分发器
创建方法：logging.StreamHandler(stream=None)
 
FileHandler类型：将日志保存到磁盘文件的处理器
创建方法：file_handler = logging.FileHandler(filename='xx.log',mode='a',encoding='utf-8')
 
设置当前处理器对象使用的日志格式：
file_handler.setFormatter(ojb)   #ojb 为一个格式器对象
 
其他常用的处理器类型：
BaseRotatingHandler
Rotating Filehandler     滚动的多日志输出，按照时间or其他方式去生成多个日志
TimedRotatingfilehandler
 
<h4>Formatter 格式器</h4>
Formatter 格式器用来最终设置日志信息的顺序，结构和内容
创建方法 
formatter = logging.Formatter("%(asctime)s|%(levelname)8s|%(filename)10s%lineno)s|%(message)s")
　　　　 Formatter对象的格式：
<div class="table-wrapper" style="text-align: left; margin-left: 30px">
<table style="height: 582px; margin-left: 30px; width: 654px">
<thead>
<tr><th>属性</th><th>格式</th><th>描述</th></tr>
</thead>
<tbody>
<tr>
<td>asctime</td>
<td>%(asctime)s</td>
<td>日志产生的时间，默认格式为msecs2003-07-0816:49:45,896</td>
</tr>
<tr>
<td>msecs</td>
<td>%(msecs)d</td>
<td>日志生成时间的亳秒部分</td>
</tr>
<tr>
<td>created</td>
<td>%(created)f</td>
<td>time.tme)生成的日志创建时间戳</td>
</tr>
<tr>
<td>message</td>
<td>%(message)s</td>
<td>具体的日志信息</td>
</tr>
<tr>
<td>filename</td>
<td>%(filename)s</td>
<td>生成日志的程序名</td>
</tr>
<tr>
<td>name</td>
<td>%(name)s</td>
<td>日志调用者（日志记录器的名称）</td>
</tr>
<tr>
<td>funcname</td>
<td>%(funcName)s</td>
<td>调用日志的函数名</td>
</tr>
<tr>
<td>levelname</td>
<td>%(levelname)s</td>
<td>日志级別( DEBUG,INFO, WARNING, 'ERRORCRITICAL)</td>
</tr>
<tr>
<td>levene</td>
<td>%( leveling)s</td>
<td>日志级别对应的数值</td>
</tr>
<tr>
<td>lineno</td>
<td>%(lineno)d</td>
<td>日志所针对的代码行号（如果可用的话）</td>
</tr>
<tr>
<td>module</td>
<td>%( module)s</td>
<td>生成日志的模块名</td>
</tr>
<tr>
<td>pathname</td>
<td>%( pathname)s</td>
<td>生成日志的文件的完整路径</td>
</tr>
<tr>
<td>process</td>
<td>%( (process)d</td>
<td>生成日志的进程D（如果可用）</td>
</tr>
<tr>
<td>processname</td>
<td>(processname)s</td>
<td>进程名（如果可用）</td>
</tr>
<tr>
<td>thread</td>
<td>%(thread)d</td>
<td>生成日志的线程D（如果可用）</td>
</tr>
<tr>
<td>threadname</td>
<td>%( threadname)s</td>
<td>线程名（如果可用)</td>
</tr>
</tbody>
</table>
</div>
 
<h3>Filter 过滤器</h3>
可以被 Handler 和 Logger 调用  用来实现比按层级提供更复杂的过滤操作。
创建过滤器：
flt = logging.Filter("cn.cccb")
在处理器和记录器中进行过滤
logger.addFilter(flt)    
file_handler.addFilter(flt)
 
<h3>三、一个简单的例子</h3>
以下例子实现了一个日志记录器同时往控制台和本地文件输入不同级别的日志
<div class="cnblogs_code">
<pre>import logging

# 创建一个日志记录器
loger = logging.getLogger('applog')

# 设置日志记录器的等级 INFO
loger.setLevel(logging.INFO)

# 创建一个将流式的日志处理器
steram_handler = logging.StreamHandler()

# loger.removeHandler()#接触绑定

#创建一个输出到磁盘文件的日志处理器
file_handler=logging.FileHandler(filename='file.log',mode='w',encoding='utf-8')

# file_handler 设置日志等级为 ERROR ,没有给handler 设置日志级别,该handler 将使用logger设置或者默认的级别
file_handler.setLevel(logging.ERROR)

# 创建一个日志格式器
formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s -%(module)s:%(message)s")

# 设置处理器输出的日志格式
file_handler.setFormatter(formatter)
steram_handler.setFormatter(formatter)

# 设置一个过滤器
fl1 = logging.Filter('app2log')

# 给日志记录器设置一个过滤器 ,(从根部开始过滤)
# loger.addFilter(fl1)

#还可以给 handler 设置过滤器 (在输出的时候过滤)
steram_handler.addFilter(fl1)

# 记录器设置一个处理器
loger.addHandler(steram_handler)
loger.addHandler(file_handler)

# 写入日志
loger.debug('debug log')
loger.info('info log')
loger.warning('warning log')
loger.error('error log')
loger.critical('critical log')</pre>
</div>
 
 注意：Handler 可设置的日志级别是Logger 的设置的日志级别的子集（如果Logger没设置，默认是WARNING）
 假设Logger 设置INFO 级别的日志，Handler 设置的DEBUG级别的日志，那Handler 还是只能输出INFO 及以上级别的日志
 
<h3>四、写在最后：</h3>
logging本质是实现了一个日志记录器按指定的等级获取日志，在处理器上设置日志格式以及等级后，通过处理器输出日志到指定位置
同时还可以通过filter 过滤器从logger 或者handler 处过滤不同记录器产生的日志
 
  
来源：https://www.cnblogs.com/byhh/p/15539676.html

頁: [1]

琼殿技术论坛's Archiver

python基础_标准库-logging