目录
LOG
- logging 模块提供模块级别的函数记录日志
- 包括四大组件
1. 日志相关概念
1.1 日志的级别 level
- DEBUG
- INFO
- NOTICE
- WARNING
- ERROR
- CRITICAL
- ALERT
- EMERGENCY
- 用户可以关注自己所需的程序信息
1.2 LOG 的作用
- 调试
- 了解软件的运行情况
- 分析定位问题
1.3 日志信息
- time
- level
- 地点
- 内容
1.4 成熟的第三方日志
- logging
- log4j
- log4php
1.5 注意
- 不要频繁地进行 IO 操作
2. Logging 模块
2.1 日志级别
- DEBUG
- INFO
- WARNING
- ERROR
- CRITICAL
2.2 使用方法
直接使用 logging，因为 logging 封装了其他组件
用 loging 四大组件直接定制
2.3 注意事项
- 初始化或写日志实例需要指定级别
- 级别可自定义
- 只有当级别等于或高于指定级别才被记录
2.4 logging 模块级别的日志
2.4.1 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 进行一次性配置 |
- logging.basicConfig(**kwargs)
- 只在第一次调用的时候起作用
- 不配置 logger 则使用默认值
- 输出：sys.stderr
- 级别：WARNING
- 格式：level:log_name:content
2.4 2 举例
- format 参数
| 参数 | 用法 | 释义 |
|---|---|---|
| asctime | %(asctime)s | 日志事件发生的时间——人类可读时间 如：2019-12-24 17:00:12,765 |
| created | %(created)f | 日志事件发生的时间——时间戳 与调用 time.time() 函数返回的值相同 |
| relativeCreated | %(relativeCreated)d | 日志事件发生的时间相对于 logging 模块加载时间的相对毫秒数 |
| msecs | %(msecs)d | 日志事件发生事件的毫秒部分 |
| levelname | %(levelname)s | 该日志记录的文字形式的日志级别 'DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL' |
| levelno | %(levelno)s | 该日志记录的数字形式的日志级别 (10, 20, 30, 40, 50) |
| name | %(name)s | 所使用的日志器名称，默认是'root' 因为默认使用的是 rootLogger |
| message | %(message)s | 日志记录的文本内容，通过 msg % args计算得到的 |
| pathname | %(pathname)s | 调用日志记录函数的源码文件的全路径 |
| filename | %(filename)s | pathname 的文件名部分，包含文件后缀 |
| module | %(module)s | filename 的名称部分，不包含后缀 |
| lineno | %(lineno)d | 调用日志记录函数的源代码所在的行号 |
| funcName | %(funcName)s | 调用日志记录函数的函数名 |
| process | %(process)d | 进程 ID |
| processName | %(processName)s | 进程名称，Python 3.1 新增 |
| thread | %(thread)d | 线程 ID |
| threadName | %(thread)s | 线程名称 |
2.5 logging 模块的处理流程
- 四大组件
| 组件 | 作用 |
|---|---|
| 日志器 Logger | 产生日志的一个接口 |
| 处理器 Handler | 把产生的日志发送到相应的目的地 |
| 过滤器 Filter | 更精细的控制那些日志输出 |
| 格式器 Formatter | 对输出信息进行格式化 |
2.5.1 Logger
- 产生一个日志
| 函数 | 释义 |
|---|---|
| Logger.setLevel() | 设置日志器将会处理的日志消息的最低严重级别 |
| Logger.addHandler() 和 Logger.removeHandler() | 为该 logger 对象添加 和 移除一个 handler 对象 |
| Logger.addFilter() 和 Logger.removeFilter() | 为该 logger 对象添加 和 移除一个 filter 对象 |
| Logger.debug | 产生一条 debug 级别的日志 info, error 等同理 |
| Logger.exception() | 创建类似于 Logger.error 的日志消息 |
| Logger.log() | 获取一个明确的日志 level 参数类创建一个日志记录 |
- 如何得到一个 logger 对象
- 实例化
- logging.getLogger()
2.5.2 Handler
- 把 log 发送到制定位置
- 方法
- setLevel
- setFormat
- addFilter, removeFilter
- 不需要直接使用，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 地址 |
| logging.NullHandler | 该 Handler 实例会忽略 error messages 通常被想使用 logging 的 library 开发者使用来避免 'No handlers could be found for logger XXX' 信息的出现 |
2.5.3 Filter 类
- 可以被 Handler 和 Logger 使用
- 控制传递过来的信息的具体内容
2.5.4 Format 类
- 直接实例化
- 可以继承 Format 添加特殊内容
- 三个参数
| 参数 | 释义 |
|---|---|
| fmt | 指定消息格式化字符串，如果不指定该参数则默认使用 message 的原始值 |
| datefmt | 指定日期格式字符串，如果不指定该参数则默认使用 "%Y-%m-%d %H:%M:%S" |
| style | Python 3.2 时新增的参数，可取值为 '%', '{' 和 '$'，如果不指定该参数则默认使用 '%' |