python学习之-- logging模块

logging模块
功能：提供了标准的日志接口，可以通过它存储各种格式的日志。
日志5个级别分：debug(),info(),warning(),error(),critical()

logging.basicConfig函数各参数:
filename: 指定日志文件名
filemode: 和file函数意义相同，指定日志文件的打开模式，'w'或'a'
format: 指定输出的格式和内容，format可以输出很多有用信息，如上例所示:
 %(levelno)s: 打印日志级别的数值
 %(levelname)s: 打印日志级别名称
 %(pathname)s: 打印当前执行程序的路径，其实就是sys.argv[0]
 %(filename)s: 打印当前执行程序名
 %(funcName)s: 打印日志的当前函数
 %(lineno)d: 打印日志的当前行号
 %(asctime)s: 打印日志的时间
 %(thread)d: 打印线程ID
 %(threadName)s: 打印线程名称
 %(process)d: 打印进程ID
 %(message)s: 打印日志信息
datefmt: 指定时间格式，同time.strftime()
level: 设置日志级别，默认为logging.WARNING
stream: 指定将日志的输出流，可以指定输出到sys.stderr,sys.stdout或者文件，默认输出到sys.stderr，当stream和filename同时指定时，stream被忽略

简单示例：5种日志打印和顺序
import logging
logging.debug('mess')
logging.info('mess')
logging.warning('user warnning log info')
logging.error('error')
logging.critical('server is down')
输出critical的日志如下：
CRITICAL:root:server is down

举例：日志记录到文件中

import logging
#打开记录日志文件并设定日志写入级别为info以上,设定日志文件格式，开头是时间，然后是日志信息
logging.basicConfig(filename='example.log',
                    level=logging.INFO,
                    format='%(asctime)s %(levelname)s %(message)s',
                    datefmt='%m%d%Y %I:%M:%S %p')
logging.info('mess')
logging.warning('warning')

logging模块记录日志涉及4个类：
1：logger提供了应用程序可以直接使用的接口
2：handler将（logger创建的）日志记录发送到合适的目的输出。
3：filter提供了细度设备来决定输出哪条日志记录
4：formatter决定日志记录的最终输出格式。
另：logging 有2种方式可以切割日志（根据时间 或者 根据大小 ）
logger：每个程序在输出信息之前都要获得一个logger，logger通常对应了程序的模块名。如：
LOG = logging.getLogger('access.log')
而核心模块可以这样：
LOG = logging.getLogger('chat.kernel')
Logger.setLevel(lel):指定最低的日志级别，低于lel的级别将被忽略。debug为最低，critical为最高。
Logger.addFilter(filt),Logger.removeFilter(filt)：添加或删除指定的filter
Logger.addHandler(hdlr),Logger.removeHandler(hdlr)：添加或删除指定的handler
Logger.debug(),Logger.Info(),Logger.Warning(),Logger.error(),Logger.critical() 为可以设定的日志级别。

handler：负责把信息发送到指定的目的地，如：控制台，文件，网络或者编写自己的handler。通过addHandler()添加多个handler
Handler.setLevel(lel)：指定被处理的信息级别，低于lel级别的被忽略。
Handler.setFormatter()：给一个handler选择一个格式。
Handler.addFilter(filt),Handler.removeFilter(filt)：新增/删除一个filter对象。
以下为常用的handler:
1：logging.StreamHandler：就是屏幕输出
2：logging.FileHandler：输出到文件
3：logging.handlers.RotatingFileHandler：可以管理文件大小，当达到指定大小后，会自动对当前文件改名。改为：文件名.1,.2,.3这样
    格式为：RotatingFileHandler(filename[,mode[,maxBytes[,backupCount]]])
    参数：maxBytes 是文件大小，0为无限大。backupCount：保留的备份文件个数。
4：logging.handlers.TimeRotatingFileHandler：按照时间切割日志
    格式为：TimeRotatingFileHandler(filename,[,when[,interval[,backupCount]]])
    参数：interval 时间间隔
          when 是个字符串，时间间隔的单位有（S秒，M分，H小时，D天，W星期，midnight每天凌晨）
日志基本流程图

举例：实现日志的屏幕和文件输出

import logging
#自定义日志名字test-log
logger = logging.getLogger('test-log')
#设置最低日志级别DEBUG
logger.setLevel(logging.DEBUG)

#添加一个handler到屏幕输出
ch = logging.StreamHandler()
#屏幕输出自定义级别为WARNING
ch.setLevel(logging.WARNING)

#在添加一个handler输出到文件
fh = logging.FileHandler('access.log',encoding='utf-8')
fh.setLevel(logging.ERROR)

# 在定义日志输出的格式(这个定义为到文件格式）
fh_formatter = logging.Formatter('%(asctime)s%(process)d %(filename)s - %(levelname)s - %(message)s')
# 这个定义为屏幕打印格式
ch_formatter = logging.Formatter('%(asctime)s, - %(name)s - %(levelname)s - %(message)s')

#接下来将自定义的日志格式和handler关联起来
#关联文件handler
fh.setFormatter(fh_formatter)
#关联屏幕handler
ch.setFormatter(ch_formatter)

#最后将定义好的handler关联到logger，日志通过logger输出
logger.addHandler(fh)
logger.addHandler(ch)

#到现在，就可以做输出日志进行测试
logger.debug('debug message')
logger.info('info message')
logger.warning('warning message')
logger.error('error message')
logger.critical('critical message')

举例：按照文件大小或者时间切割日志

import logging
from logging import handlers
logger = logging.getLogger(__name__)
log_file = 'logname.log'
#按照文件大小切割日志
# fh = handlers.RotatingFileHandler(filename=log_file,maxBytes=10,backupCount=3,encoding='utf-8')
#按照文件时间切割日志,这里的 'S' 表示秒
# fh = handlers.TimedRotatingFileHandler(filename=log_file,when="S",interval=5,backupCount=3,encoding='utf-8')

formatter = logging.Formatter('%(asctime)s %(module)s %(message)s')
fh.setFormatter(formatter)
logger.addHandler(fh)