logging模块:
logging是一个日志记录模块,可以记录我们日常的操作。
logging日志文件写入默认是gbk编码格式的,所以在查看时需要使用gbk的解码方式打开。
logging日志等级:CRITICAL(50) > ERROR(40) > WARNING(30) > INFO(20) > DEBUG(10)
logging有函数式的和面向对象的两种方式。由于函数式的功能相对比较单一,不适合复杂的环境所以目前主要使用的是面向对象的logging下的方法。
logging默认显示WARNING级别以上的日志,信息如下:
importlogging
logging.debug("debug级别")
logging.info("info级别")
logging.warning("warning级别")
logging.error("error级别")
logging.critical("critical级别")#打印内容如下,默认只打印WARNING级别以上。
WARNING:root:warning级别
ERROR:root:error级别
CRITICAL:root:critical级别
可以手动设置日志级别,如下:
importlogging
logging.basicConfig(level=logging.DEBUG) #设置日志报警等级
logging.debug("我是DEBUG")
logging.info("我是info")
logging.warning("我是warning")
logging.error("我是error")
logging.critical("我是critical")#打印内容如下
DEBUG:root:我是DEBUG
INFO:root:我是info
WARNING:root:我是warning
ERROR:root:我是error
CRITICAL:root:我是critical
basicConfig()里面有很多参数,参考如下:
参数名称
描述
filename
将日志信息写入文件中,指定该设置项后日志信息就不会被输出到控制台了
filemode
指定日志文件的打开模式,默认为'a'。需要注意的是,该选项要在filename指定时才有效
format
指定日志格式字符串,即指定日志输出时所包含的字段信息以及它们的顺序。logging模块定义的格式字段下面会列出。
datefmt
指定日期/时间格式。需要注意的是,该选项要在format中包含时间字段%(asctime)s时才有效。
level
指定日志级别
stream
指定日志输出目标stream,如sys.stdout、sys.stderr以及网络stream。需要说明的是,stream和filename不能同时提供,否则会引发 ValueError异常
style
Python 3.2中新添加的配置项。指定format格式字符串的风格,可取值为'%'、'{'和'$',默认为'%'
handlers
Python 3.3中新添加的配置项。该选项如果被指定,它应该是一个创建了多个Handler的可迭代对象,这些handler将会被添加到root logger。需要说明的是:filename、stream和handlers这三个配置项只能有一个存在,不能同时出现2个或3个,否则会引发ValueError异常。
上面的时间需要使用format中包含时间段,过于format还有如下参数:
字段/属性名称
使用格式
描述
asctime
%(asctime)s
日志事件发生的时间--人类可读时间,如:2003-07-08 16:49:45,896
created
%(created)f
日志事件发生的时间--时间戳,就是当时调用time.time()函数返回的值
relativeCreated
%(relativeCreated)d
日志事件发生的时间相对于logging模块加载时间的相对毫秒数(目前还不知道干嘛用的)
msecs
%(msecs)d
日志事件发生事件的毫秒部分
levelname
%(levelname)s
该日志记录的文字形式的日志级别('DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL')
levelno
%(levelno)s
该日志记录的数字形式的日志级别(10, 20, 30, 40, 50)
name
%(name)s
所使用的日志器名称,默认是'root',因为默认使用的是 rootLogger
message
%(message)s
日志记录的文本内容,通过 msg % args计算得到的
pathname
%(pathname)s
调用日志记录函数的源码文件的全路径
filename
%(filename)s
pathname的文件名部分,包含文件后缀
module
%(module)s
filename的名称部分,不包含后缀
lineno
%(lineno)d
调用日志记录函数的源代码所在的行号
funcName
%(funcName)s
调用日志记录函数的函数名
process
%(process)d
进程ID
processName
%(processName)s
进程名称,Python 3.1新增
thread
%(thread)d
线程ID
threadName
%(thread)s
线程名称
下面是一些基本的配置事例:
importlogging
FORMAT_DATA= format="%(asctime)s - %(name)s -[%(lineno)d] - %(message)s"logging.basicConfig(level=logging.DEBUG,
format=FORMAT_DATA,
filename="test.log",
filemode="a+")
logging.debug("我是DEBUG")
logging.info("我是info")
logging.warning("我是warning")
logging.error("我是error")
logging.critical("我是critical")
内容如下:
如果对format中asctime格式化的时间格式不满意,可以使用basicConfig函数中的datefmt参数做调整,如下:
importlogging
FORMAT_DATA= format="%(asctime)s - %(name)s -[%(lineno)d] - %(message)s"DEFINE_TIME= "%Y/%m/%d %H:%M:%S" #自定义时间格式
logging.basicConfig(level=logging.DEBUG,
datefmt=DEFINE_TIME,
format=FORMAT_DATA,
filename="test.log",
filemode="a+")
logging.debug("我是DEBUG")
logging.info("我是info")
logging.warning("我是warning")
logging.error("我是error")
logging.critical("我是critical")
日志文件内容如下:
发现日期改成了我们想要的格式。
下面使用封装后的logging写日志
使用logging类的步骤如下:
1、先创建一个日志的对象
2、创建一个模板
3、创建输出流(文件流,屏幕流两种)
4、将流和模板绑定
5、将日志和流进行绑定
6、使用日志对象设置日志等级
代码如下:
importlogging#创建一个日志对象
logg = logging.getLogger("测试日志")#定义一个模板
FORMATTER = logging.Formatter("%(asctime)s - %(name)s - [%(lineno)d] - %(message)s")#创建一个屏幕流
p_stream =logging.StreamHandler()#创建一个文件流
f_stream = logging.FileHandler("log.log",mode="a",encoding="utf-8")#将流绑定到模板
p_stream.setFormatter(FORMATTER)
f_stream.setFormatter(FORMATTER)#将日志和流进行绑定
logg.addHandler(p_stream)
logg.addHandler(f_stream)#设置日志记录等级
logg.setLevel(logging.DEBUG)#打印日志信息
logg.debug("this is Debug")
logg.info("this is info")
logg.warning("this is warning")
logg.error("this is error")
logg.critical("this is critical")#打印内容如下
2019-02-18 19:32:54,393 - 测试日志 - [23] - this isDebug2019-02-18 19:32:54,393 - 测试日志 - [24] - this isinfo2019-02-18 19:32:54,393 - 测试日志 - [25] - this iswarning2019-02-18 19:32:54,393 - 测试日志 - [26] - this iserror2019-02-18 19:32:54,393 - 测试日志 - [27] - this is critical
文件信息如下:
如果想为多个用户创建不同的日志,只需要创建流时创建不同的流即可,而不需要创建多个日志对象,如果情况特殊考虑单独在创建一个对象。其实我们可以在创建流的时候直接指定日志等级。流的等级是优先于日志对象的。如下我们创建两个流:
importlogging#创建一个日志对象
logg = logging.getLogger("测试日志")#创建一个程序员模板和老板模板
CORE_FORMATTER = logging.Formatter("%(asctime)s - %(name)s - [%(lineno)d] - %(message)s")
BOOS_FORMATTER= logging.Formatter("%(asctime)s - %(message)s")#创建一个程序员的流和一个老板的流
core_stream = logging.FileHandler("core.log",mode="a",encoding="utf-8")
boos_stream= logging.FileHandler("boos.log",mode="a",encoding="utf-8")#设置日志等级(老板的日志等级设置WARNING)
boos_stream.setLevel(logging.WARNING)#将流绑定到模板
core_stream.setFormatter(CORE_FORMATTER)
boos_stream.setFormatter(BOOS_FORMATTER)#将日志和流进行绑定
logg.addHandler(core_stream)
logg.addHandler(boos_stream)#设置日志记录等级
logg.setLevel(logging.DEBUG)#打印日志信息
logg.debug("this is Debug")
logg.info("this is info")
logg.warning("this is warning")
logg.error("this is error")
logg.critical("this is critical")
内容如下:
这样我们便创建了两种不同的日志。好吧只讨论到这里吧,更多功能小伙伴们自己慢慢挖掘吧!!!