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

举例:日志记录到文件中

python log文件保存路径 python logging filename_打印日志

python log文件保存路径 python logging filename_打印日志_02

1 import logging
2 #打开记录日志文件并设定日志写入级别为info以上,设定日志文件格式,开头是时间,然后是日志信息
3 logging.basicConfig(filename='example.log',
4                     level=logging.INFO,
5                     format='%(asctime)s %(levelname)s %(message)s',
6                     datefmt='%m%d%Y %I:%M:%S %p')
7 logging.info('mess')
8 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每天凌晨)

日志基本流程图

python log文件保存路径 python logging filename_打印日志_03

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

python log文件保存路径 python logging filename_打印日志

python log文件保存路径 python logging filename_打印日志_02

1 import logging
 2 #自定义日志名字test-log
 3 logger = logging.getLogger('test-log')
 4 #设置最低日志级别DEBUG
 5 logger.setLevel(logging.DEBUG)
 6 
 7 #添加一个handler到屏幕输出
 8 ch = logging.StreamHandler()
 9 #屏幕输出自定义级别为WARNING
10 ch.setLevel(logging.WARNING)
11 
12 #在添加一个handler输出到文件
13 fh = logging.FileHandler('access.log',encoding='utf-8')
14 fh.setLevel(logging.ERROR)
15 
16 # 在定义日志输出的格式(这个定义为到文件格式)
17 fh_formatter = logging.Formatter('%(asctime)s%(process)d %(filename)s - %(levelname)s - %(message)s')
18 # 这个定义为屏幕打印格式
19 ch_formatter = logging.Formatter('%(asctime)s, - %(name)s - %(levelname)s - %(message)s')
20 
21 #接下来将自定义的日志格式和handler关联起来
22 #关联文件handler
23 fh.setFormatter(fh_formatter)
24 #关联屏幕handler
25 ch.setFormatter(ch_formatter)
26 
27 #最后将定义好的handler关联到logger,日志通过logger输出
28 logger.addHandler(fh)
29 logger.addHandler(ch)
30 
31 #到现在,就可以做输出日志进行测试
32 logger.debug('debug message')
33 logger.info('info message')
34 logger.warning('warning message')
35 logger.error('error message')
36 logger.critical('critical message')

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

python log文件保存路径 python logging filename_打印日志

python log文件保存路径 python logging filename_打印日志_02

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)