Python 日志模块logging

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")

内容如下：

这样我们便创建了两种不同的日志。好吧只讨论到这里吧，更多功能小伙伴们自己慢慢挖掘吧！！！

---

下一篇：python序列化（json，pickle，shelve）：https://www.cnblogs.com/caesar-id/p/10415132.html