python中logging的使用

参考资料：https://www.cnblogs.com/yuanchenqi/articles/5732581.html

1 基本使用

import logging

logging.debug("debug")
logging.info("info")
logging.warning("warning")
logging.error("error")
logging.critical("critical")

输出为：

默认情况下，python中的logging模块将日志打印到标准输出中，且只显示大于等于WARNING级别的日志，这说明默认的日志级别设置为WARNING（日志级别等级CRITICAL > ERROR > WARNING > INFO > DEBUG > NOTSET），默认的日志格式为日志级别：Logger用户名称：用户输出消息。

2 基本配置

logging.basicConfig(
    level="DEBUG",             #设置数据输出级别
    filename='test.log',       #设置日志输出文件
    #设置日志输出格式 asctime：时间，  filename：文件名，  lineno：行号，  
    levelname：日志级别， message：日志内容 
    format='%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s',   
   # datefmt='%a, %d %b %Y %H:%M:%S',    #设置时间格式
    filemode='w'      # 默认为a追加的模式，改写为w覆盖模式
)

配置以后，日志输出格式为：

2018-07-18 11:38:40,236 rizhi.py[line:15] DEBUG debug
2018-07-18 11:38:40,236 rizhi.py[line:16] INFO info
2018-07-18 11:38:40,236 rizhi.py[line:17] WARNING warning
2018-07-18 11:38:40,236 rizhi.py[line:18] ERROR error
2018-07-18 11:38:40,236 rizhi.py[line:19] CRITICAL critical

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

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

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

2 logger对象的使用

# 创建一个logger对象，用于管理日志
logger=logging.getLogger()     #返回一个默认的Logger，即root Logger，并应用默认的日志级别、Handler和Formatter设置。
# 创建一个文件Handler,用于写日志到文件
fh=logging.FileHandler('test.log')
# 再创建一个streamHandler，用于输出到控制台
ch=logging.StreamHandler()
# 设置日志的格式
formatter=logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
#将格式分别添加到文件handler和控制台handler
fh.setFormatter(formatter)
ch.setFormatter(formatter)
#将文件handler和控制台handler分别添加到logger
logger.addHandler(fh)
logger.addHandler(ch)
#设置输出日志级别
logger.setLevel('DEBUG')
#用logger输出日志
logger.debug("debug")
logger.info("info")
logger.warning("warning")
logger.error("error")
logger.critical("critical")

3 问题剖析

• 同名logger相当于是同一个logger

logger1 = logging.getLogger('mylogger')
logger1.setLevel(logging.DEBUG)

logger2 = logging.getLogger('mylogger')
logger2.setLevel(logging.INFO)

logger1.addHandler(fh)
logger1.addHandler(ch)

logger2.addHandler(fh)
logger2.addHandler(ch)

logger1.debug('logger1 debug message')
logger1.info('logger1 info message')
logger1.warning('logger1 warning message')
logger1.error('logger1 error message')
logger1.critical('logger1 critical message')
  
logger2.debug('logger2 debug message')
logger2.info('logger2 info message')
logger2.warning('logger2 warning message')
logger2.error('logger2 error message')
logger2.critical('logger2 critical message')

logger1 与logger2 同名，所以二者相当于是一个logger，虽然分别设置了一次level,但只会根据最新的一次设置输出，最终都按info的级别输出。

• logger = logging.getLogger()默认创建的是root logger,logger1 = logging.getLogger('mylogger')创建了root Logger的孩子(root.)mylogger,logger1 与logger 之间存在继承关系，logger1在输出自己的时候若logger 也有输出，会把logger 按照logger1的级别重新输出一次，即logger1会输出两次。