Python logging模块的使用

logging 模块 负责给 打印日志 可以输出到控制台上 也可以 保存到文件中。

1.日志级别
NOTSET

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

ps: 默认生成的root logger 的level 是logging.WARNING，低于该级别的就不输出了。

级别排序：
CRITICAL > ERROR > WARNING > INFO > DEBUG

• debug : 打印全部的日志,详细的信息,通常只出现在诊断问题上
• info : 打印info,warning,error,critical级别的日志,确认一切按预期运行
• warning : 打印warning,error,critical级别的日志,一个迹象表明,一些意想不到的事情发生了,或表明一些问题在不久的将来(例如。磁盘空间低”),这个软件还能按预期工作
• error : 打印error,critical级别的日志,更严重的问题,软件没能执行一些功能
• critical : 打印critical级别,一个严重的错误,这表明程序本身可能无法继续运行

import logging 

logging.basicConfig(level=logging.NOTSET)
# 因为默认是 warning
logging.debug(u"如果设置了日志级别为NOTESET，那么这里可以采取debug，ingo的级别的内容也可以显示在控制台上了")

名词解释

• logging.Formatter：配置日志格式，在里面自定义设置日期和时间，输出日志的时候将会按照设置的格式显示内容
• logging.logger ： logger是logging模块的主体：
  • 为程序提供记录日志的接口
  • 判断日志所处的级别，并判断是否要过滤
  • 根据其日志级别将该日志分发给不同handler
• 常用函数：
  • logger.setLevel():设置日志级别
  • logger.addHandler()和logger.removerHandler()：添加和删除一个Handler
  • logger.addFilter():添加一个Filter，过滤作用
  • logging.Hadler:Handler基于日志级别对日志进行分发，如设置为WARNING级别的Handler只会处理WARNING及以上级别的日志。
    1. setLevel（）：设置级别
    2. setFormatter（）：设置Formatter

日志输出 - 控制台和文件

ch = logging.StreamHadler()
ch.setLevel(logging.WARNING)

ch.setFormatter(formatter)
logger.addHanlder(ch)

import logging
import os.path
import time

# 第一步 创建一个 logger
logger = logging.getLogger()
logger.setLevel(logging.INFO)

# 第二步 创建一个handler 用于写入日志文件(如果文件不存在就新建文件)
rq = time.strftime('%Y%m%d%H%M',time.localtime(time.time()))
# log_path = os.path.dirname(os.getcwd())+'/Logs/'
isExists = os.path.exists(os.path.dirname(os.getcwd())+'/Logs/')
if not isExists:
    log_path = os.path.dirname(os.getcwd())+"/Logs/"
    os.mkdir(log_path)

# log_path = os.path.dirname(os.getcwd())+'/Logs/'
log_name = log_path + rq + '.log'
logfile = log_name
fh = logging.FileHandler(logfile,mode='w')
fh.setLevel(logging.DEBUG)

ch = logging.StreamHadler()
ch.setLevel(logging.WARNING)

# 第三步  定义handler 的输出格式
formatter = logging.Formatter("%(asctime)s - %(filename)s[line:%(lineno)d] - %(levelname)s: %(message)s")
fh.setFormatter(formatter)
ch.setFormatter(formatter)

# 第四步 将logger 添加到handler 里面
logger.addHandler(fh)
logger.addHanlder(ch)

# 第五步 日志
logger.debug('this is a logger debug message')
logger.info('this is a logger info message')
logger.warning('this is a logger warning message')
logger.error('this is a logger error message')
logger.critical('this is a logger critical message')

format常用格式说明

• %(levelno)s: 打印日志级别的数值
• %(levelname)s: 打印日志级别名称
• %(pathname)s: 打印当前执行程序的路径，其实就是sys.argv[0]
• %(filename)s: 打印当前执行程序名
• %(funcName)s: 打印日志的当前函数
• %(lineno): 打印日志的当前行号
• %(asctime)s: 打印日志的时间
• %(thread)d: 打印线程ID
• %(threadName)s: 打印线程名称
• %(process)d: 打印进程ID
• %(message)s: 打印日志信息

---

捕捉异常,用traceback记录

import os.path
import time
import logging
# 创建一个logger
logger = logging.getLogger()
logger.setLevel(logging.INFO)  # Log等级总开关

# 创建一个handler，用于写入日志文件
rq = time.strftime('%Y%m%d%H%M', time.localtime(time.time()))
log_path = os.path.dirname(os.getcwd()) + '/Logs/'
log_name = log_path + rq + '.log'
logfile = log_name
fh = logging.FileHandler(logfile, mode='w')
fh.setLevel(logging.DEBUG)  # 输出到file的log等级的开关

# 定义handler的输出格式
formatter = logging.Formatter("%(asctime)s - %(filename)s[line:%(lineno)d] - %(levelname)s: %(message)s")
fh.setFormatter(formatter)
logger.addHandler(fh)
# 使用logger.XX来记录错误,这里的"error"可以根据所需要的级别进行修改
try:
    open('/path/to/does/not/exist', 'rb')
except (SystemExit, KeyboardInterrupt):
    raise
except Exception, e:
    logger.error('Failed to open file', exc_info=True)

---

日志滚动和过期删除(按时间)

# coding:utf-8
import logging
import time
import re
from logging.handlers import TimedRotatingFileHandler
from logging.handlers import RotatingFileHandler


def backroll():
    #日志打印格式
    log_fmt = '%(asctime)s\tFile \"%(filename)s\",line %(lineno)s\t%(levelname)s: %(message)s'
    formatter = logging.Formatter(log_fmt)
    #创建TimedRotatingFileHandler对象
    log_file_handler = TimedRotatingFileHandler(filename="ds_update", when="M", interval=2, backupCount=2)
    #log_file_handler.suffix = "%Y-%m-%d_%H-%M.log"
    #log_file_handler.extMatch = re.compile(r"^\d{4}-\d{2}-\d{2}_\d{2}-\d{2}.log$")
    log_file_handler.setFormatter(formatter)
    logging.basicConfig(level=logging.INFO)
    log = logging.getLogger()
    log.addHandler(log_file_handler)
    #循环打印日志
    log_content = "test log"
    count = 0
    while count < 30:
        log.error(log_content)
        time.sleep(20)
        count = count + 1
    log.removeHandler(log_file_handler)


if __name__ == "__main__":
    backroll()

filename：日志文件名的prefix；

when：是一个字符串，用于描述滚动周期的基本单位，字符串的值及意义如下：
“S”: Seconds
“M”: Minutes
“H”: Hours
“D”: Days
“W”: Week day (0=Monday)
“midnight”: Roll over at midnight

interval: 滚动周期，单位有when指定，比如：when=’D’,interval=1，表示每天产生一个日志文件

backupCount: 表示日志文件的保留个数