日志的级别：

• DEBUG
• INFO
• WARNNING
• ERROR
• CRITICAL

作者代码可以见 代码

几个重要的概念

• 1. Logger:记录器，是应用程序直接使用的借口
• 2. Handler处理器，将(记录器)产生的日志记录发送往合适的借口
• 3. Filter:过滤器，提供更好的输出控制，可以决定输出哪些日志记录

Logger

 Logger是一个树级的结构，使用debug,info等前一定要创建Logger实例，即创建一个记录器。如果没有显式的创建，默认创建一个root logger，并应用默认的日志级别(WARN)，处理器Handler(StreamHandler,即讲日志信息打印输出在标准的输出上),和格式化器(默认的格式是第一个简单使用程序中输出的样式)。

#创建方法:
logger = logging.getLogger(logger_name)

 创建Logger实例后，可以使用如下的方法设置日志级别，增加处理器Handler。

• logger.setLevel(logging.DEBUG)
• logger.addHadnler(handler_name)
• logger.removeHandler(handler_name)

Handler处理器

 Handler的处理器类型有很多种，常见有三个，Streamhandler,FileHandler,NullHandler。
 创建StreamHandler后可以使用如下的方法设置日志级别(level)，格式化器(Formatter)，过滤器(Filter):

• ch.setLevel(logging.WARN)
• ch.setFormatter(formatter_name)
• ch.addFilter(filter_name)
• ch.removeFilter(filter_name)

#StreamHandler的创建方法：
sh = logging.StreamHandler(stream=None)
#FileHandler创建方法
fh = logging.FileHandler(filename,mode='a',encoding=None,delay=False)
#NullHandler创建方法
这玩意没什么用，由库开发者使用

Formatter格式化器

 使用Formatter对象设置日志信息的最后贵的，结构和内容，默认的时间格式位%Y-%m-%d%H:%M:%S

#创建方法：
formatter = logging.Formatter(fmt=None,datafmt=None)
其中fmt是消息的格式化串，datafmt是日志字符串，如果不指定fmt将会使用%(message)s' 如果不指明datefmt将使ISO8601的日期格式。

Filter过滤器

 Handler和Logger都可以使用Filter完成比级别完成更复杂的过滤，Filter基类仅允许指定Logger层次一下的事件，例如使用'A.B'初始化的Filter允许Logger ‘A.B’, ‘A.B.C’, ‘A.B.C.D’, ‘A.B.D’等记录的事件，logger‘A.BB’, ‘B.A.B’ 等就不行。 如果用空字符串来初始化，所有的事件都接受。

filter = logger.Filter(name=' ')

Logger Handler Filte Formatter几种关系，该关系可以使用如下图进行描述：

几种实例之间的关系

由上图可以知，Logger是一个树形的结构，Logger可以包括多个Handler和Filter，一个Handler可以有多个Formatter和Filter，并且日志级别将会继承。

Logging的工作流程

Logging的工作流程

• 1. 由上图可以知道，如果使用者的代码中产生了日志提交，首先进行判断登记等级是否大于Logger实例的等价，如果小于，会抛弃这个日志，否则进入下一步.
• 2. 创建日志，使用注册到Logger中的Filter进行过滤，轮流进行过滤，如果有一个把他过滤掉了，终止。否则等所有的过滤完成后进入下一步。
• 3. 日子继续往下流
  • 日志流向所有注册在Logger中的Handlers,首先判断等级够不够，接着判断有没有过滤器，都不能拒绝日志的话，将会格式化输出(会产生额外的信息，比如在哪个文件那一行等)。
• 4. 判断日志能够进行传播，如果可以并且有父类Logger，那么将会送入父类进行处理。

几种配置方式

#下面是一些模块级别的函数：
getLogger返回指定name的日志记录器，name=None时候返回层级结构总为根级别的记录器，如果指定了name，name一般是用a. a.b a.b.c.d，这些名称自定义
logging.getLogger(name=None)

logging.GetLoggerClass() 返回标准的Logger类
常见的logging.debug('')都是在根记录器中产生消息

logging.disable(level=logging.CRITICAL)，以为重载的形式会作用在所有的Logger，一般用来限制全局
logging.addLevelName(level,levelName) 自己定义一个等级对应的名字，如30对应一个MyDebug
logging.basicConfig(**   kwags) 使用磨人的Formatte创建一个StreamHandler并加入根日志记录起，如果没有为跟记录器定已处理程序，那么debug()等会自动调用basicConfig。如果根日志记录器配置了处理程序，不执行任何操作。
#logging.shutdown

 上述提到的支持一下参数:

format参数中可能用到的格式化串：

• %(name)s Logger的名字
• %(levelno)s 数字形式的日志级别
• %(levelname)s 文本形式的日志级别
• %(pathname)s 调用日志输出函数的模块的完整路径名，可能没有
• %(filename)s 调用日志输出函数的模块的文件名
• %(module)s 调用日志输出函数的模块名
• %(funcName)s 调用日志输出函数的函数名
• %(lineno)d 调用日志输出函数的语句所在的代码行
• %(created)f 当前时间，用UNIX标准的表示时间的浮 点数表示
• %(relativeCreated)d 输出日志信息时的，自Logger创建以 来的毫秒数
• %(asctime)s 字符串形式的当前时间。默认格式是 “2003-07-08 16:49:45,896”。逗号后面的是毫秒
• %(thread)d 线程ID。可能没有
• %(threadName)s 线程名。可能没有
• %(process)d 进程ID。可能没有
• %(message)s用户输出的消息

一个例子

# -*- encoding:utf-8 -*-
import logging

# create logger
logger_name = "example"
logger = logging.getLogger(logger_name)
logger.setLevel(logging.DEBUG)

# create file handler
log_path = "./log.log"
fh = logging.FileHandler(log_path)
fh.setLevel(logging.WARN)

# create formatter
fmt = "%(asctime)-15s %(levelname)s %(filename)s %(lineno)d %(process)d %(message)s"
datefmt = "%a %d %b %Y %H:%M:%S"
formatter = logging.Formatter(fmt, datefmt)

# add handler and formatter to logger
fh.setFormatter(formatter)
logger.addHandler(fh)

# print log info
logger.debug('debug message')
logger.info('info message')
logger.warn('warn message')
logger.error('error message')
logger.critical('critical message')```

##### 文件配置
配置文件logging.conf如下:
```[loggers]
keys=root,example01

[logger_root]
level=DEBUG
handlers=hand01,hand02

[logger_example01]
handlers=hand01,hand02
qualname=example01
propagate=0

[handlers]
keys=hand01,hand02

[handler_hand01]
class=StreamHandler
level=INFO
formatter=form02
args=(sys.stderr,)

[handler_hand02]
class=FileHandler
level=DEBUG
formatter=form01
args=('log.log', 'a')

[formatters]
keys=form01,form02

[formatter_form01]
format=%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s```

使用程序logger.py如下:
```#!/usr/bin/python
# -*- encoding:utf-8 -*-
import logging
import logging.config

logging.config.fileConfig("./logging.conf")

# create logger
logger_name = "example"
logger = logging.getLogger(logger_name)

logger.debug('debug message')
logger.info('info message')
logger.warn('warn message')
logger.error('error message')
logger.critical('critical message')```

##### 字典配置
有兴趣的童靴可以使用```logging.config.dictConfig(config)```编写一个示例程序发给我，以提供给我进行完善本文。

#### 监听配置