100天精通Python（基础篇）——第32天：日志标准库logging【文末送书两本】

import logging

1、logging库日志级别

---

问题思考：

• 开发人员在开发一个应用程序时需要什么日志信息？在程序正式上线后需要什么日志信息？

• 运维人员在部署开发环境时需要什么日志信息？在部署生产环境时需要什么日志信息？

根据需求选择不同的日志级别：

| 级别 | 级别数值 | 使用时机 |

| — | — | — |

| DEBUG | 10 （级别最低） | 详细信息，常用于调试。 |

| INFO | 20（重要） | 程序正常运行过程中产生的一些信息。 |

| WARNING | 30 （警告） | 警告用户，虽然程序还在正常工作，但有可能发生错误。 |

| ERROR | 40（错误） | 由于更严重的问题，程序已经不能执行一些功能了。 |

| CRITICAL | 50 （严重） | 严重错误，程序已经不能继续运行。 |

默认情况是日志级别是warning，日志级别从上到下依次升高，即 DEBUG < INFO < WARNING < ERROR < CRITICAL。而日志的信息量是依次减少的。

开发应用程序 或部署开发环境时：应该使用DEBUG 或INFO级别的日志获取尽可能详细的日志信息来进行开发或部署调试；

应用上线 或部署生产环境时：应该使用WARNING或CRITICAL级别的日志来降低机器的I/O压力和提高获取错误日志信息的效率

PS：当为某个应用程序指定一个日志级别后，应用程序会记录所有日志级别大于或等于指定日志级别的日志信息，而不是仅仅记录指定级别的日志信息，只要级别大于或等于该指定日志级别的日志记录才会被输出，小于该级别的日志记录将会被丢弃。

2、logging工作流程

---

Logger：日志，暴露函数给应用程序，基于日志记录器和过滤器级别决定哪些日志有效。

LogRecord ：日志记录器，将日志传到相应的处理器处理。

Handler ：处理器, 将(日志记录器产生的)日志记录发送至合适的目的地。

Filter ：过滤器, 提供了更好的粒度控制,它可以决定输出哪些日志记录。

Formatter：格式化器, 指明了最终输出中日志记录的布局。

流程描述：

• 1、判断日志的等级是否大于 Logger 对象的等级，如果大于，则往下执行，否则，流程结束。

• 2、产生日志：第一步，判断是否有异常，如果有，则添加异常信息。 第二步，处理日志记录方法(如 debug，info 等)中的占位符，即一般的字符串格式化处理。

• 3、使用注册到 Logger 对象中的 Filters 进行过滤。如果有多个过滤器，则依次过滤；只要有一个过滤器返回假，则过滤结束，且该日志信息将丢弃，不再处理，而处理流程也至此结束。否则，处理流程往下执行。

• 4、在当前 Logger 对象中查找 Handlers，如果找不到任何 Handler，则往上到该 Logger 对象的父 Logger 中查找；如果找到一个或多个 Handler，则依次用 Handler 来处理日志信息。但在每个 Handler 处理日志信息过程中，会首先判断日志信息的等级是否大于该 Handler 的等级，如果大于，则往下执行(由 Logger 对象进入 Handler 对象中)，否则，处理流程结束。

• 5、执行 Handler 对象中的 filter 方法，该方法会依次执行注册到该 Handler 对象中的 Filter。如果有一个 Filter 判断该日志信息为假，则此后的所有 Filter 都不再执行，而直接将该日志信息丢弃，处理流程结束。

• 6、使用 Formatter 类格式化最终的输出结果。 注：Formatter 同上述第 2 步的字符串格式化不同，它会添加额外的信息，比如日志产生的时间，产生日志的源代码所在的源文件的路径等等。

• 7、真正地输出日志信息(到网络，文件，终端，邮件等)。至于输出到哪个目的地，由 Handler 的种类来决定。

3、日志输出格式

---

日志的输出格式可以认为设置，默认格式为下图所示：

4、基本使用

---

logging 使用非常简单，使用 basicConfig() 方法就能满足基本的使用需要，如果方法没有传入参数，会根据默认的配置创建Logger 对象，默认的日志级别被设置为 WARNING，默认的日志输出格式如上图，该函数可选的参数如下表所示。

| 参数名称 | 参数描述 |

| — | — |

| filename | 日志输出到文件的文件名 |

| filemode | 文件模式，r[+]、w[+]、a[+] |

| format | 日志输出的格式 |

| datefat | 日志附带日期时间的格式 |

| style | 格式占位符，默认为 “%” 和 “{}” |

| level | 设置日志输出级别 |

| stream | 定义输出流，用来初始化 StreamHandler 对象，不能 filename 参数一起使用，否则会ValueError 异常 |

| handles | 定义处理器，用来创建 Handler 对象，不能和 filename 、stream 参数一起使用，否则也会抛出 ValueError 异常 |