Python 日志模块logging

2020-01-17 16:29:34 浏览数 (1)

logging模块:

logging是一个日志记录模块,可以记录我们日常的操作。

logging日志文件写入默认是gbk编码格式的,所以在查看时需要使用gbk的解码方式打开。

logging日志等级:CRITICAL(50) > ERROR(40) > WARNING(30) > INFO(20) > DEBUG(10)

logging有函数式的和面向对象的两种方式。由于函数式的功能相对比较单一,不适合复杂的环境所以目前主要使用的是面向对象的logging下的方法。

logging默认显示WARNING级别以上的日志,信息如下:

代码语言:javascript复制
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级别

可以手动设置日志级别,如下:

代码语言:javascript复制
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

线程名称

下面是一些基本的配置事例:

代码语言:javascript复制
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参数做调整,如下:

代码语言:javascript复制
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、使用日志对象设置日志等级

代码如下:

代码语言:javascript复制
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

文件信息如下:

如果想为多个用户创建不同的日志,只需要创建流时创建不同的流即可,而不需要创建多个日志对象,如果情况特殊考虑单独在创建一个对象。其实我们可以在创建流的时候直接指定日志等级。流的等级是优先于日志对象的。如下我们创建两个流:

代码语言:javascript复制
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")

内容如下:

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

0 人点赞