logging

一： 基本定义

logging模块日志流处理流程

日志器 Logger 提供了应用程序可一直使用的接口
处理器 Handler 将logger创建的日志记录发送到合适的目的输出
过滤器 Filter 提供了更细粒度的控制工具来决定输出哪条日志记录，丢弃哪条日志记录
格式器 Formatter 决定日志记录的最终输出格式

日志器（logger）需要通过处理器（handler）将日志信息输出到目标位置，如：文件、sys.stdout、网络等；
不同的处理器（handler）可以将日志输出到不同的位置；
日志器（logger）可以设置多个处理器（handler）将同一条日志记录输出到不同的位置；
每个处理器（handler）都可以设置自己的过滤器（filter）实现日志过滤，从而只保留感兴趣的日志；
每个处理器（handler）都可以设置自己的格式器（formatter）实现同一条日志以不同的格式输出到不同的地方。
简单点说就是：日志器（logger）是入口，真正干活儿的是处理器（handler），处理器（handler）还可以通过过滤器（filter）和格式器（formatter）对要输出的日志内容做过滤和格式化等处理操作。

 

Logger.setLevel() 设置日志器将会处理的日志消息的最低严重级别
Logger.addHandler() 和 Logger.removeHandler() 为该logger对象添加 和 移除一个handler对象
关于Logger.setLevel()方法的说明：
内建等级中，级别最低的是DEBUG，级别最高的是CRITICAL。例如setLevel(logging.INFO)，此时函数参数为INFO，那么该logger将只会处理INFO、WARNING、ERROR和CRITICAL级别的日志，而DEBUG级别的消息将会被忽略/丢弃。
Logger.debug(), Logger.info(), Logger.warning(), Logger.error(), Logger.critical()

 

怎样得到一个Logger对象呢？
一种方式是通过Logger类的实例化方法创建一个Logger类的实例，但是我们通常都是用第二种方式--logging.getLogger()方法。
logging.getLogger()方法有一个可选参数name，该参数表示将要返回的日志器的名称标识，如果不提供该参数，则其值为'root'。若以相同的name参数值多次调用getLogger()方法，将会返回指向同一个logger对象的引用。

Handler类
Handler对象的作用是（基于日志消息的level）将消息分发到handler指定的位置（文件、网络、邮件等）。Logger对象可以通过addHandler()方法为自己添加0个或者更多个handler对象。比如，一个应用程序可能想要实现以下几个日志需求：
1）把所有日志都发送到一个日志文件中；
2）把所有严重级别大于等于error的日志发送到stdout（标准输出）；
3）把所有严重级别为critical的日志发送到一个email邮件地址。
这种场景就需要3个不同的handlers，每个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.hanlders.TimedRotatingFileHandler 将日志消息发送到磁盘文件，并支持日志文件按时间切割
logging.handlers.HTTPHandler 将日志消息以GET或POST的方式发送给一个HTTP服务器
logging.handlers.SMTPHandler 将日志消息发送给一个指定的email地址

Formater类
Formater对象用于配置日志信息的最终顺序、结构和内容。与logging.Handler基类不同的是，应用代码可以直接实例化Formatter类。另外，如果你的应用程序需要一些特殊的处理行为，也可以实现一个Formatter的子类来完成。

Filter类
Filter可以被Handler和Logger用来做比level更细粒度的、更复杂的过滤功能。Filter是一个过滤器基类，它只允许某个logger层级下的日志事件通过过滤。

 

 

二： 重复日志的问题

class LogTest:

    def __init__(self):

        self.logger = self.log_test()

 

    def log_test(self):

        logger = logging.getLogger("logger")  # 指定日志名称

        logger.setLevel(logging.INFO)  # 指定日志错误急别

 

        # 创建处理器handler

 

        sh_handler = logging.StreamHandler()

        sh_handler.setFormatter(logging.Formatter("%(asctime)s - %(levelname)s - %(message)s"))

 

 

        # 创建一个文件handler

        file_handler = logging.FileHandler(os.path.join(os.path.dirname(os.path.abspath(__file__)), 'all.log'))

        # 指定格式器 formatter

        file_handler.setFormatter(logging.Formatter("%(asctime)s - %(levelname)s - %(message)s"))

 

        if not logger.handlers:  #解决办法1

            logger.addHandler(sh_handler)

            logger.addHandler(file_handler)

        # logger.addHandler(sh_handler)

        # logger.addHandler(file_handler)

        # print(logger.handlers,type(logger.handlers))

        # logger.info(msg)

        return logger

 

    def log_info(self, msg):  # 解决办法2

        return self.logger.info(msg)

 

 

aa = LogTest()

aa.log_info("警告001")

aa.log_info("警告002")

aa.log_info("警告004")  # 不会重复输出日志

aa.log_test().info("警告003")

aa.log_test().info("警告005")  

 

重复日志的原因原因：第二次调用log的时候，根据getLogger(name)里的name获取同一个logger，而这个logger里已经有了第一次你添加的handler，第二次调用又添加了一个handler，所以，这个logger里有了两个同样的handler，以此类推，调用几次就会有几个handler

所以这里有以下几个解决办法：

1. 每次创建不同name的logger，每次都是新logger，不会有添加多个handler的问题。

2. 每次记录完日志之后，调用removeHandler()把这个logger里的handler移除掉。

3. 在方法里做判断，如果这个logger已有handler，则不再添加handler。

4. 把logger的handler列表中的handler移除