logging模块:
logging是一个日志记录模块,可以记录我们日常的操作。
logging日志文件写入默认是gbk编码格式的,所以在查看时需要使用gbk的解码方式打开。
logging日志等级:CRITICAL(50) > ERROR(40) > WARNING(30) > INFO(20) > DEBUG(10)
logging有函数式的和面向对象的两种方式。由于函数式的功能相对比较单一,不适合复杂的环境所以目前主要使用的是面向对象的logging下的方法。
logging默认显示WARNING级别以上的日志,信息如下:
import logging
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级别
可以手动设置日志级别,如下:
import logging
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 | 线程名称 |
下面是一些基本的配置事例:
import logging
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参数做调整,如下:
import logging
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、使用日志对象设置日志等级
代码如下:
import logging
# 创建一个日志对象
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 is Debug
2019-02-18 19:32:54,393 - 测试日志 - [24] - this is info
2019-02-18 19:32:54,393 - 测试日志 - [25] - this is warning
2019-02-18 19:32:54,393 - 测试日志 - [26] - this is error
2019-02-18 19:32:54,393 - 测试日志 - [27] - this is critical
文件信息如下:
如果想为多个用户创建不同的日志,只需要创建流时创建不同的流即可,而不需要创建多个日志对象,如果情况特殊考虑单独在创建一个对象。其实我们可以在创建流的时候直接指定日志等级。流的等级是优先于日志对象的。如下我们创建两个流:
import logging
# 创建一个日志对象
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")
内容如下:
这样我们便创建了两种不同的日志。好吧只讨论到这里吧,更多功能小伙伴们自己慢慢挖掘吧!!!