日志是每个程序都应该具备的一项功能,它能帮你调试代码、查找问题、警告通知等等。Python内置了一个名叫logging的日志模块,提供了标准的日志接口,可以通过它存储各种格式的日志,logging的日志可以分为debug,info,warning,errorandcritical五个级别。在logging内部,每个级别由一个数字表示如下:
CRITICAL=50
ERROR=40
WARNING=30
INFO=20
DEBUG=10
如果只是简单的将日志输入到屏幕,可以这么做:
import logging
logging.warning("user [jack] attempted wrong password more than 3 times")
logging.critical("server is down")
#输出
WARNING:root:user [jack] attempted wrong password more than3times
CRITICAL:root:serverisdown
如果要将日志写入某个文件,那么可以这么做:
import logging
logging.basicConfig(filename='log.log',#这一行指定日志文件
format='%(asctime)s - %(name)s - %(levelname)s -%(module)s: %(message)s',## 这一行控制每条日志的格式
datefmt='%Y-%m-%d %H:%M:%S %p',# 这一行控制时间格式
level=10)# 系统只会将高于level的信息写入文件
logging.debug('debug')
logging.info('info')
logging.warning('warning')
logging.error('error')
logging.critical('critical')
logging.log(10,'log')
对于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#指定时间格式,默认为logging.strftime()
#用法:datefmt = '%a,%d %b %Y %H:%M:S'
level#设置日志级别,默认为logging.WARNING
stream#指定将日志的输出流,可以指定输出到sys.stderr、sys.stdout或者文件,默认输出到sts.stderr
对于输出的格式,如上面例子中的asctime/name/levelname等,还有其它属性如下图:
图中红色字体部分是比较有用的属性,可以看出logging模块还是相当强大的,甚至能记录调用日志的
进程ID或者进程名,线程ID或者线程名。
而如果想要同时把日志打印在屏幕和保存在文件日志里,则必须对logging模块有更深的了解。
首先,我们需要了解logging模块的四个部分:loggers, handlers, filters, formatters。
loggers:提供让程序代码直接使用的接口
handlers:将logger产生的日志发送到希望的目的地
filter:用于过滤日志,将符合条件的日志输出
formatters:在输出前格式化日志,使之符合你想要的格式。
下面我们根据一个具体的例子来看:
import logging
# 创建logger
logger=logging.getLogger('jack')# 使用getLogger方法,并指定用户名
logger.setLevel(logging.DEBUG)# 设置全局的日志记录等级为DEBUG
# 创建要发送到屏幕的handler,并设置其局部日志等级为DEBUG
ch=logging.StreamHandler()
ch.setLevel(logging.DEBUG)
# 创建要发送到日志文件的handler,并设置其局部日志等级为WARNING
fh=logging.FileHandler("access.log")# 设置日志文件名为access.log
fh.setLevel(logging.WARNING)
# 创建一种formatter格式,你可以根据需要创建任意种
formatter=logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
# 为先前创建好的Handlers添加formatter格式
ch.setFormatter(formatter)
fh.setFormatter(formatter)
# 为一开始创建的logger添加Handlers,也就是处理逻辑,有几个Handlers就添加几次
logger.addHandler(ch)
logger.addHandler(fh)
# 下面是应用程序的代码
logger.debug('debug message')
logger.info('info message')
logger.warn('warn message')
logger.error('error message')
logger.critical('critical message')
屏幕显示:
2016-06-0616:53:37,554-jack-DEBUG-debug message
2016-06-0616:53:37,555-jack-INFO-info message
2016-06-0616:53:37,555-jack-WARNING-warn message
2016-06-0616:53:37,555-jack-ERROR-error message
2016-06-0616:53:37,555-jack-CRITICAL-critical message
access.log日志文件中的内容:
2016-06-0616:53:37,555-jack-WARNING-warn message
2016-06-0616:53:37,555-jack-ERROR-error message
2016-06-0616:53:37,555-jack-CRITICAL-critical message
其实就是上面这么个过程,一步一步完成就可以了,逻辑其实很简单,学习模块其实就是学习一个软件,没什么复杂的。