Python日志库logging

        此模块定义了功能和类，这些功能和类为应用程序和库实现了事件日志记录系统；

        使用标准库模块提供的日志API的主要好处是所有Python模块都可以参与日志记录，因此你的应用程序日志可以包含与第三方模块的消息集成的自己的消息。

1 为什么会使用logging

        首先，print功能简单，虽然其也可以向文件输出内容；

        但是python中有处理日志的标准库: logging；

                其功能相对于print强大很多： 它可以出去程序中多种等级的内容；

        （1）DEBUG： 详细的debug信息；

        （2）INFO： 程序正常运行产生的信息；

        （3）WARNING： 表明发生了一些意外，或者不久的将来会发生问题（如‘磁盘满了’）。软件还是在正常工作；

        （4）ERROR： 由于更严重的问题，软件已不能执行一些功能了。 一般错误消息；

        （5）CRITICAL： 严重错误，表明软件已不能继续运行了；

  2 输出不同级别日志的方法

如下代码所示，将logging内容输出到文件：

import logging

# 默认的日志输出级别为warning
# 使用baseConfig()来指定日志输出级别
print("this is print log")
# 输出到指定文件位置，输出模式为写入，默认为追加
logging.basicConfig(filename='demo.log', filemode='w', level=logging.DEBUG)
logging.debug("This is debug log1")
logging.info("This is info log")
logging.warning("This is warning log")
logging.error("This is error log")
logging.critical("This is critical log")

文件内容：

 3 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)	对root logger进行一次性配置

basicConfig() 函数使用方式：

        logging.basicConfig(level=logging.DEBUG)#将日志的输出级别调节为debug

        logging.basicConfig(filename='demo.log',level=logging.DEBUG)#将日志的输出到demo.log文件中

        logging.basicConfig(filename='demo.log',filemote='w',level=logging.DEBUG)#先清空再写入，也可以设置为继续写

4 logging 常用的格式化输出方式

import logging

# 向日志输出变量
logging.basicConfig(level=logging.DEBUG)
name = "张三"
age = 18

logging.debug("姓名 %s, 年龄%d",name,age)

logging.debug("姓名 %s, 年龄%d",% (name,age))

logging.debug("姓名 {}, 年龄{}".format(name,age))

logging.debug(f"姓名{name}, 年龄{age}")

 使用basicConfig设置格式化输出方式：

import logging

# 输出格式和添加一些公共信息
logging.basicConfig(format="%(asctime)s|%(levelname)s|%(filename)s:%(lineno)s|%(message)s",
                    datefmt="%Y-%m-%d %H:%M:%S", level=logging.DEBUG)
name = "张三"
age = 18
logging.debug("姓名 %s, 年龄 %d", name, age)
logging.warning("姓名 %s, 年龄 %d", name, age)

输出：
2022-10-08 08:26:19|DEBUG|6-1.py:14|姓名 张三, 年龄 18
2022-10-08 08:26:19|WARNING|6-1.py:15|姓名 张三, 年龄 18

5 logging的高级应用

        采用了模块（类）设计，主要包含4种组件：

Loggers	记录器，提供应用程序代码直接使用的接口
Handlers	处理器，将记录器产生的日志发送至目的地
Filters	过滤器，提供更好的粒度控制，决定哪些日志会被输出
Formatters	格式化器，设置日志内容的组成结构和消息字段

书写流程：

代码演示：

import logging

# 编程的方式来写一下高级的写法
# 记录器
logger = logging.getLogger('applog')
logger.setLevel(logging.DEBUG)

# 处理器handler
consoleHandler = logging.StreamHandler()
consoleHandler.setLevel(logging.DEBUG)

# 没有给handler指定日志级别，将使用logger的级别
fileHandler = logging.FileHandler(filename='addDemo.log')
fileHandler.setLevel(logging.INFO)

# formatter格式
formatter = logging.Formatter("%(asctime)s|%(levelname)-8s|%(filename)10s:%(lineno)4s|%(message)s")

# 给处理器设置格式 -- 渲染Handler
consoleHandler.setFormatter(formatter)
fileHandler.setFormatter(formatter)

# 记录器要设置处理器
logger.addHandler(consoleHandler)
logger.addHandler(fileHandler)

# 定义一个过滤器
flt = logging.Filter("cn.cccb")

# 关联过滤器
# logger.addFilter(flt)
fileHandler.addFilter(flt)

# 打印日志的代码
logger.debug("This is debug log1")
logger.info("This is info log")
logger.warning("This is warning log")
logger.error("This is error log")
logger.critical("This is critical log")

6 大型工程配置文件

配置文件格式

#./logging.conf

#记录器：提供应用程序代码直接使用的接口
#设置记录器名称，root必须存在！！！
[loggers]
keys=root,applog

#处理器，将记录器产生的日志发送至目的地
#设置处理器类型
[handlers]
keys=fileHandler,consoleHandler

#格式化器，设置日志内容的组成结构和消息字段
#设置格式化器的种类
[formatters]
keys=simpleFormatter

#设置记录器root的级别与种类
[logger_root]
level=DEBUG
handlers=consoleHandler

#设置记录器applog的级别与种类
[logger_applog]
level=DEBUG 
handlers=fileHandler,consoleHandler
#起个对外的名字
qualname=applog
#继承关系
propagate=0

#设置
[handler_consoleHandler]
class=StreamHandler
args=(sys.stdout,)
level=DEBUG
formatter=simpleFormatter


[handler_fileHandler]
class=handlers.TimedRotatingFileHandler
#在午夜1点（3600s）开启下一个log文件，第四个参数0表示保留历史文件
args=('applog.log','midnight',3600,0)
level=DEBUG
formatter=simpleFormatter

[formatter_simpleFormatter]
format=%(asctime)s|%(levelname)8s|%(filename)s[:%(lineno)d]|%(message)s
#设置时间输出格式
datefmt=%Y-%m-%d %H:%M:%S

参考：cnblogs.com/kangshuaibo/p/14700833.html

Python基础之标准库logging 你还在用print来调试程序吗，OUT啦_哔哩哔哩_bilibili