内置模块之logging

logging模块

　　logging模块是用来操作日志的。这个时候你就开始有疑问了，日志是什么呢？

错误日志是软件用来记录运行时出错信息的文本文件。编程人员和维护人员等可以利用错误日志对系统进行调试和维护

　　一般的日志分为以下几个等级（critical > error > warning > info > debug）

　　　　debug  ：记录计算或工作中的细节

　　　　info      ：记录一些用户的增删改查的操作

　　　　warning ： 警告操作

　　　　error    ：错误操作

　　　　critical ：记录一些直接让程序出错的严重错误

　　默认情况下，在python中的logging模块中直接将日志打印到标准输出，并且只打印warning及以上级别的信息。

---

 简单配置项

import logging
logging.debug('debug message')
logging.info('info message')
logging.warning('warning message')
logging.error('error message')
logging.critical('critical message')

# 修改logging.basicConfig(level= )来修改显示
logging.basicConfig(level=logging.DEBUG)
logging.debug('debug message')
logging.info('info message')
logging.warning('warning message')
logging.error('error message')
logging.critical('critical message')

　　如图所示，logging模块默认会把结果打印到屏幕，并且只会打印warning级别以上的信息。此时如果想改变，就需要在logging.basicConfig()中，把level级别调低。

　　此时，如果不想日志默认输出到标准输出，想重定向输出到指定的日志文件中，那么也可以通过修改logging.basicconfig()中filename属性，指定重定向的文件。

# 通过修改logging.basicConfig(filename=‘file_path’),进行输出重定向
import logging
logging.basicConfig(level=logging.DEBUG,
                    filename = 'log1.txt')
logging.debug('debug message')
logging.info('info message')
logging.warning('warning message')
logging.error('error message')
logging.critical('critical message')

　　至此，我们已经知道了如果调整输出级别，如果重定向输出，但是这种默认的输出格式，太过简单了，不能满足大多数需求，所以日志的输出格式，可以通过自定义来实现。

logging.basicConfig()函数中可通过具体参数来更改logging模块默认行为，可用参数有：

filename：用指定的文件名创建FiledHandler，这样日志会被存储在指定的文件中。
filemode：文件打开方式，在指定了filename时使用这个参数，默认值为“a”还可指定为“w”。
format：指定handler使用的日志显示格式。
datefmt：指定日期时间格式。
level：设置rootlogger（后边会讲解具体概念）的日志级别
stream：用指定的stream创建StreamHandler。可以指定输出到sys.stderr,sys.stdout或者文件(f=open(‘test.log’,’w’))，默认为sys.stderr。若同时列出了filename和stream两个参数，则stream参数会被忽略。

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用户输出的消息

总结：

　　通过logging模块的简单配置项可以完成对日志的基本操作，但是依然有几点痛点：

　　（1）basicConifg不支持输出中文

　　（2）日志的输出只能够文件/屏幕二选一，不能做到同时。

---

对象配置项

　　既然logging模块自带的basicConfig配置不能够解决中文问题，那么只能通过自己创建对象的方式来更加灵活的操作，解决固有的痛点：1.不能支持中文  2.同时向文件和屏幕输出内容

　　事前应该有几个准备事项：

　　（1）先实例化一个日志对象

　　（2）创建一个控制文件输出的文件操作符

　　（3）创建一个控制屏幕输出的屏幕操作符

　　（4）指定日志输出的格式（可以指定多个，文件输出和屏幕输出格式可以不同）

　　（5）文件操作符绑定一个日志格式

　　（6）屏幕操作符绑定一个日志格式

　　（7）日志对象绑定文件操作符以及屏幕操作符

#（1）创建一个log对象
logger = logging.getLogger()
# (2)  创建一个控制文件输出的文件操作符,encoding='utf-8‘’，解决中文问题
file_handler = logging.FileHandler('log2.txt',encoding='utf-8')
#（3）创建一个控制屏幕输出的屏幕操作符
screen_handler = logging.StreamHandler()
#(4) 设置日志输出的格式
log_fmt = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
#（5）文件操作符绑定一个日志格式
file_handler.setFormatter(log_fmt)
# (6)  屏幕操作符绑定一个日志格式
screen_handler.setFormatter(log_fmt)
# （7）日志对象绑定文件操作符和屏幕操作符
logger.addHandler(file_handler)
logger.addHandler(screen_handler)
#(8) 调整日志输出的级别
logger.setLevel(logging.INFO)
#(9) 打印日志
logger.debug('这是debug的消息')
logger.info('这是info的消息')
logger.warning('这是warning的消息')
logger.error('这是error的消息')