logging.config模块---使用配置文件管理logger
logging配置文件
一.使用到的模块:
logging.config
官方文档:
https://docs.python.org/3/library/logging.config.html
非官方文档(中文版):
http://python.usyiyi.cn/translate/python_352/library/logging.config.html
- 配置文件长什么样:
官方: https://docs.python.org/3/library/logging.config.html#logging-config-fileformat
fileConfig()理解的配置文件格式基于configparser的功能。文件必需包含名为[loggers], [handlers] 和 [formatters]的节:如下表
[loggers] keys=root,log02,log03,log04,log05,log06,log07
[handlers] keys=hand01,hand02,hand03,hand04,hand05,hand06,hand07,hand08,hand09
[formatters] keys=form01,form02,form03,form04,form05,form06,form07,form08,form09 |
1：loggers节，以及字节的设置
根logger必需指定级别和handler列表。根logger节的例子给定如下。
[logger_root] level=NOTSET handlers=hand01 |
level可以是DEBUG, INFO, WARNING, ERROR, CRITICAL 或 NOTSET其中之一。NOTSET表示所有的消息都要记录，这只对根logger有效。级别值使用eval()在logging包空间演算得到。
handlers是逗号分隔的handler名字的列表，这些必需出现在[handlers]节中。这些名字必需出现在[handlers]节中，且在配置文件中有对应的节。
对于非根logger的logger来说，需要一些额外的信息。如下例所示。
[logger_parser] level=DEBUG handlers=hand01 propagate=1 qualname=compiler.parser |
level 和 handlers 的解读和根logger的一样，如果非根logger的级别为NOTSET，系统参考高层次的logger来决定logger的有效级别。
propagate为1表示将消息传递给高层次logger的handler，为0表示不传播。
qualname是logger在层次中的名字，应用通过该名字得到logger。
2：handler节，以及字节的设置
[handler_hand01] class=StreamHandler level=NOTSET formatter=form01 args=(sys.stdout,) |
class条目指示处理程序的类（如通过eval() 在logging包的命名空间）。
The level is interpreted as for loggers, and NOTSET is taken to mean 'log everything'.
formatter条目表示此处理程序的格式化程序的关键名称。如果为空，logging._defaultFormatter则使用默认格式化程序（）。如果指定了一个名称，它必须出现在该[formatters]部分，并在配置文件中有相应的部分。
该args条目eval()在logging 程序包命名空间的上下文中使用时，是处理程序类的构造函数的参数列表。请参阅相关处理程序的构造函数，或下面的示例，了解如何构建典型的条目。
[handler_hand02] class=FileHandler level=DEBUG formatter=form02 args=('python.log', 'w')
[handler_hand03] class=handlers.SocketHandler level=INFO formatter=form03 args=('localhost', handlers.DEFAULT_TCP_LOGGING_PORT) |
3：formatters节，以及字节的设置
指定了格式化配置的节典型如下
[formatter_form01] format=F1 %(asctime)s %(levelname)s %(message)s datefmt= class=logging.Formatter |
format是整体的格式化字符串，
datefmt是strftime()兼容的日期/时间格式化字符串。如果为空，使用ISO8601格式，基本上等同于格式'%Y-%m-%d %H:%M:%S'。ISO8601格式在上述格式的末尾指明了毫秒，中间有个逗号。ISO8601格式的例子：2003-01-23 00:29:50,411。
class可选。它表示formatter类的名字（带点的模块和类名）。实例化Formatter子类时该选项很有用。Formatter子类可以用来表示详细／概要的异常回溯。
- 配置文件写好之后怎么用?
import logging import logging.config logging.config.fileConfig("logger.conf") logger = logging.getLogger("你当时写的qualname ") logger.debug('This is debug message') |
四:DEMO
#logging_setting.ini [loggers] keys=root,log01 #可以没有别的,但是必须得有root
[handlers] keys=hand01,hand02
[formatters] keys=form01,form02
[logger_root] level=NOTSET #可以不写 handlers=hand01 #可以为空
[logger_log01] level=ERROR handlers=hand01 propagate=0 qualname=test.test123
[handler_hand01] class=StreamHandler level=DEBUG formatter=form01 args=() #括号内可为空,但不可不写,括号内有一个内容时,必须在后面加",",以保证是tuple类型 除此之外,另外别的后面不允许有多余的逗号
[handler_hand02] class=FileHandler level=NOTSET formatter=form01 args=("test1.log","a",'utf-8')
[formatter_form01] format=F1 %(asctime)s %(levelname)s %(message)s datefmt= class=logging.Formatter
[formatter_form02] format= %(asctime)s %(levelname)s %(message)s datefmt= class=logging.Formatter | import logging.config logging.config.fileConfig("logging_setting.ini") log1 = logging.getLogger("test.test123") log1.info("阿斯顿发") |
#args=()可以里面没有内容,但是只有一个内容的时候,后面必须加上逗号,表示是一个元组
