python:logging模块

python内置logging模块

ps:Python中文前加u：unicode，对于python3.7来说，加不加u都一样

默认生成的root logger的level是logging.WARNING,低于该级别的就不输出了
如果需要显示低于WARNING级别的内容，可以引入NOTSET级别来显示：


Logging.Formatter：这个类配置了日志的格式，在里面自定义设置日期和时间，输出日志的时候将会按照设置的格式显示内容。
Logging.Logger：Logger是Logging模块的主体，进行以下三项工作：

1. 为程序提供记录日志的接口
2. 判断日志所处级别，并判断是否要过滤
3. 根据其日志级别将该条日志分发给不同handler
   常用函数有：
   Logger.setLevel() 设置日志级别
   Logger.addHandler() 和 Logger.removeHandler() 添加和删除一个Handler
   Logger.addFilter() 添加一个Filter,过滤作用
   Logging.Handler：Handler基于日志级别对日志进行分发，如设置为WARNING级别的Handler只会处理WARNING及以上级别的日志。
   常用函数有：
   setLevel() 设置级别
   setFormatter() 设置Formatter

logging模块常用format格式说明

%(levelno)s: 打印日志级别的数值
%(levelname)s: 打印日志级别名称
%(pathname)s: 打印当前执行程序的路径，其实就是sys.argv[0]
%(filename)s: 打印当前执行程序名，python如：login.py
%(funcName)s: 打印日志的当前函数
%(lineno)d: 打印日志的当前行号,在第几行打印的日志
%(asctime)s: 打印日志的时间
%(thread)d: 打印线程ID
%(threadName)s: 打印线程名称
%(process)d: 打印进程ID
%(message)s: 打印日志信息

使用前理解：
logging.basicConfig函数各参数:

filename: 指定日志文件名，如my.log 或my.txt
filemode: 和file函数意义相同，指定日志文件的打开模式，‘w’或’a’
format: 指定输出的格式和内容，format可以输出很多有用信息，如下例所示:
datefmt: 指定时间格式，同time.strftime()
level: 设置日志级别，默认为logging.WARNING
stream: 指定将日志的输出流，可以指定输出到sys.stderr,sys.stdout或者文件，默认输出到sys.stderr，当stream和filename同时指定时，stream被忽略

logging中使用format：

例1:指定文件测试

logging.basicConfig(level=logging.DEBUG,
format=’%(asctime)s %(filename)s [line:%(lineno)d] %(levelname)s %(message)s’,
datefmt=’%a, %d %b %Y %H:%M:%S’,
filename=‘myapp.txt’,
filemode=‘w’)
logging.debug(“这是一个debug”)

执行结果：

例2:不指定文件，在窗口打印日志


例3:日志输出-文件

import logging # 引入logging模块
import os.path
import time

第一步，创建一个logger
logger = logging.getLogger()
logger.setLevel(logging.INFO) # Log等级总开关

第二步，创建一个handler，用于写入日志文件
rq = time.strftime(’%Y%m%d%H%M’, time.localtime(time.time()))
log_path = os.path.dirname(os.getcwd()) + ‘/Logs/’
log_name = log_path + rq + ‘.log’
logfile = log_name
fh = logging.FileHandler(logfile, mode=‘w’)
fh.setLevel(logging.DEBUG) # 输出到file的log等级的开关

第三步，定义handler的输出格式
formatter = logging.Formatter("%(asctime)s - %(filename)s[line:%(lineno)d] - %(levelname)s: %(message)s")
fh.setFormatter(formatter)

第四步，将logger添加到handler里面
logger.addHandler(fh)

日志
logger.debug(‘this is a logger debug message’)
logger.info(‘this is a logger info message’)
logger.warning(‘this is a logger warning message’)
logger.error(‘this is a logger error message’)
logger.critical(‘this is a logger critical message’)

例4:日志输出-控制台和文件

只要在输入到日志中的第二步和第三步插入一个handler输出到控制台：
创建一个handler，用于输出到控制台
ch = logging.StreamHandler()
ch.setLevel(logging.WARNING) # 输出到console的log等级的开关
第四步和第五步分别加入以下代码即可
ch.setFormatter(formatter)
logger.addHandler(ch)

例5:捕捉异常,用traceback记录

import os.path
import time
import logging

创建一个logger

logger = logging.getLogger()
logger.setLevel(logging.INFO) # Log等级总开关

创建一个handler，用于写入日志文件

rq = time.strftime(’%Y%m%d%H%M’, time.localtime(time.time()))
log_path = os.path.dirname(os.getcwd()) + ‘/Logs/’
log_name = log_path + rq + ‘.log’
logfile = log_name
fh = logging.FileHandler(logfile, mode=‘w’)
fh.setLevel(logging.DEBUG) # 输出到file的log等级的开关

定义handler的输出格式

formatter = logging.Formatter("%(asctime)s - %(filename)s[line:%(lineno)d] - %(levelname)s: %(message)s")
fh.setFormatter(formatter)
logger.addHandler(fh)

使用logger.XX来记录错误,这里的"error"可以根据所需要的级别进行修改

try:
    open('/path/to/does/not/exist', 'rb')
except (SystemExit, KeyboardInterrupt):
    raise
except Exception, e:
    logger.error('Failed to open file', exc_info=True)

如果需要将日志不上报错误，仅记录，可以将exc_info=False

例6:多模块调用logging,日志输出顺序

warning_output.py

import logging

def write_warning():
    logging.warning(u"记录文件warning_output.py的日志")


error_output.py

import logging

def write_error():
    logging.error(u"记录文件error_output.py的日志")

main.py

import logging
import warning_output
import error_output

def write_critical():
    logging.critical(u"记录文件main.py的日志")

warning_output.write_warning()  # 调用warning_output文件中write_warning方法
write_critical()
error_output.write_error()  # 调用error_output文件中write_error方法

例7:日志滚动和过期删除(按时间)

# coding:utf-8
import logging
import time
import re
from logging.handlers import TimedRotatingFileHandler
from logging.handlers import RotatingFileHandler


def backroll():
    #日志打印格式
    log_fmt = '%(asctime)s\tFile \"%(filename)s\",line %(lineno)s\t%(levelname)s: %(message)s'
    formatter = logging.Formatter(log_fmt)
    #创建TimedRotatingFileHandler对象
    log_file_handler = TimedRotatingFileHandler(filename="ds_update", when="M", interval=2, backupCount=2)
    #log_file_handler.suffix = "%Y-%m-%d_%H-%M.log"
    #log_file_handler.extMatch = re.compile(r"^\d{4}-\d{2}-\d{2}_\d{2}-\d{2}.log$")
    log_file_handler.setFormatter(formatter)
    logging.basicConfig(level=logging.INFO)
    log = logging.getLogger()
    log.addHandler(log_file_handler)
    #循环打印日志
    log_content = "test log"
    count = 0
    while count < 30:
        log.error(log_content)
        time.sleep(20)
        count = count + 1
    log.removeHandler(log_file_handler)


if __name__ == "__main__":
    backroll()

filename：日志文件名的prefix；

when：是一个字符串，用于描述滚动周期的基本单位，字符串的值及意义如下：
“S”: Seconds
“M”: Minutes
“H”: Hours
“D”: Days
“W”: Week day (0=Monday)
“midnight”: Roll over at midnight

interval: 滚动周期，单位有when指定，比如：when=’D’,interval=1，表示每天产生一个日志文件

backupCount: 表示日志文件的保留个数

例8:logging生成的日志写入到文件中,乱码问题


logging的打印按照权重来表示