Python学习-logging

发布时间：2019-08-25 09:36:43编辑：auto阅读（1635）

Python的logging模块提供了通用的日志系统，可以方便第三方模块或者是应用使用。这个模块提供不同的日志级别，并可以采用不同的方式记录日志。

logging的日志可以分为debug(),info(),warning(),error()和critical 五个级别




最简单用法

#!/usr/local/bin/python
# -*- coding:utf-8 -*-
import logging


logging.debug('debug message')
logging.info('info message')
logging.warn('warn message')
logging.error('error message')
logging.critical('critical message')


WARNING:root:warn message
ERROR:root:error message
CRITICAL:root:critical message

默认情况下，logging模块将日志打印到屏幕上(stdout)，日志级别为WARNING(即只有日志级别高于WARNING的日志信息才会输出)日志格式如：

WARNING   : root:       warn message
日志级别 logger实例名  日志消息内容

日志级别

级别	应用
DEBUG	详细信息，典型地调试问题时会感兴趣
INFO	证明事情按预期工作
WARNING	表明发生了一些意外，或者不久的将来会发生问题（如‘磁盘满了’）。软件还是在正常工作
ERROR	由于更严重的问题，软件已不能执行一些功能了
CRITICAL	严重错误，表明软件已不能继续运行了




把日志写到文件里,简单配置

#!/usr/local/bin/python
# -*- coding:utf-8 -*-
import logging

logging.basicConfig(filename='logger.log', level=logging.INFO)

logging.debug('debug message')
logging.info('info message')
logging.warn('warn message')
logging.error('error message')
logging.critical('critical message')


INFO:root:info message
WARNING:root:warn message
ERROR:root:error message
CRITICAL:root:critical message

标准输出(屏幕)未显示任何信息，发现当前工作目录下生成了logger.log

其中下面这句level=loggin.INFO意思是，把日志纪录级别设置为INFO，也就是说，只有比日志是INFO或比INFO级别更高的日志才会被纪录到文件里，在这个例子， 第一条日志是不会被纪录的，如果希望纪录debug的日志，那把日志级别改成DEBUG就行了

如果想同时把log打印在屏幕和文件日志里，就需要了解一点复杂的知识了

几个重要的概念

Logger	记录器，暴露了应用程序代码能直接使用的接口
Handler	处理器，将（记录器产生的）日志记录发送至合适的目的地
Filter	过滤器，提供了更好的粒度控制，它可以决定输出哪些日志记录
Formatter	格式化器，指明了最终输出中日志记录的布局




Logger 记录器

Logger是一个树形层级结构，在使用接口debug，info，warn，error，critical之前必须创建Logger实例，即创建一个记录器，如果没有显式的进行创建，则默认创建一个root logger，并应用默认的日志级别(WARN)，处理器Handler(StreamHandler，即将日志信息打印输出在标准输出上)，和格式化器Formatter(默认的格式即为第一个简单使用程序中输出的格式)。

# 创建方法
logger = logging.getLogger(logger_name)

创建Logger实例后，可以使用以下方法进行日志级别设置，增加处理器Handler

·logger.setLevel(logging.ERROR) # 设置日志级别为ERROR，即只有日志级别大于等于ERROR的日志才会输出

·logger.addHandler(handler_name) # 为Logger实例增加一个处理器

·logger.removeHandler(handler_name) # 为Logger实例删除一个处理器




Handler 处理器

Handler处理器类型有很多种，比较常用的有三个，StreamHandler，FileHandler，NullHandler

# 创建方法
sh = logging.StreamHandler(stream=None)
fh = logging.FileHandler(filename, mode='a', encoding=None, delay=False)

创建StreamHandler之后，可以通过使用以下方法设置日志级别，设置格式化器Formatter，增加或删除过滤器Filter

·ch.setLevel(logging.WARN) # 指定日志级别，低于WARN级别的日志将被忽略

·ch.setFormatter(formatter_name) # 设置一个格式化器formatter

·ch.addFilter(filter_name) # 增加一个过滤器，可以增加多个

·ch.removeFilter(filter_name) # 删除一个过滤器

NullHandler类位于核心logging包，不做任何的格式化或者输出。
本质上它是个“什么都不做”的handler，由库开发者使用




Formatter 格式化器

使用Formatter对象设置日志信息最后的规则、结构和内容，默认的时间格式为%Y-%m-%d %H:%M:%S

# 创建方法
formatter = logging.Formatter(fmt=None, datefmt=None)

其中，fmt是消息的格式化字符串，datefmt是日期字符串。如果不指明fmt，将使用'%(message)s'。如果不指明datefmt，将使用ISO8601日期格式




Filter 过滤器

暂且略过





basicConfig关键字参数

关键字	描述
filename	创建一个FileHandler，使用指定的文件名，而不是使用StreamHandler
filemode	如果指明了文件名，指明打开文件的模式（如果没有指明filemode，默认为'a'）
format	handler使用指明的格式化字符串
datefmt	使用指明的日期／时间格式
level	指明根logger的级别
stream	使用指明的流来初始化StreamHandler。该参数与'filename'不兼容，如果两个都有，'stream'被忽略




format格式

格式	描述
%(levelno)s	打印日志级别的数值
%(levelname)s	打印日志级别名称
%(pathname)s	打印当前执行程序的路径
%(filename)s	打印当前执行程序名称
%(funcName)s	打印日志的当前函数
%(lineno)d	打印日志的当前行号
%(asctime)s	打印日志的时间
%(thread)d	打印线程id
%(threadName)s	打印线程名称

%(process)d	打印进程ID
%(message)s	打印日志信息




配置示例

显式配置

# -*- encoding:utf-8 -*-
import logging

# create logger
logger_name = "le"
logger = logging.getLogger(logger_name)
logger.setLevel(logging.DEBUG)

# create console handler and set level to debug
ch = logging.StreamHandler()
ch.setLevel(logging.DEBUG)

# create file handler and set level to warning
log_path = "./log.log"
fh = logging.FileHandler(log_path)
fh.setLevel(logging.WARN)

# create formatter
fmt = "%(asctime)-15s %(levelname)s %(filename)s %(lineno)d %(process)d %(message)s"
datefmt = "%a %d %b %Y %H:%M:%S"
formatter = logging.Formatter(fmt, datefmt)

# add handler and formatter to logger
ch.setFormatter(formatter)
fh.setFormatter(formatter)
logger.addHandler(ch)
logger.addHandler(fh)

# print log info
logger.debug('debug message')
logger.info('info message')
logger.warn('warn message')
logger.error('error message')
logger.critical('critical message')




源自作者，好吃的野菜&alex大王

关键字：