Python 日志（Log）

日志？

• 日志，就是用来记录程序运行的时候都发生了什么事。

• 事件按严重程度划分level

• 事件内容：
  • 时间
  • 位置
  • 事件的严重程度--level
  • 内容

• 用logging模块实现

logging 模块

• 日志级别（level）：DEBUG < INFO < NOTICE < WARNING < ERROR < CRITICAL < ALERT < EMERGENCY

• 记录日志方式：

  logging模块定义的模块级别的常用函数：

  函数	说明
  logging.debug(msg, *args, **kwargs)	创建一条严重级别为DEBUG的日志记录
  logging.info(msg, *args, **kwargs)	创建一条严重级别为INFO的日志记录
  logging.warning(msg, *args, **kwargs)	创建一条严重级别为WARNING的日志记录
  logging.error(msg, *args, **kwargs)	创建一条严重级别为ERROR的日志记录
  logging.critical(msg, *args, **kwargs)	创建一条严重级别为CRITICAL的日志记录
  logging.log(level, *args, **kwargs)	创建一条严重级别为level的日志记录
  logging.basicConfig(**kwargs)	对root logger进行一次性配置

  • logging.basicConfig(**kwargs) 对root logger进行一次性配置

    • 只在第一次调用的时候起作用

    • 不配置logger则使用默认值：
      • 输出： sys.stderr
      • 级别： WARNING
      • 格式： level:log_name:content

  eg_2

  import logging
  
  LOG_FORMAT = "%(asctime)s=====%(levelname)s++++++%(message)s"
  
  logging.basicConfig(filename="eg_1.log", level=logging.DEBUG, format=LOG_FORMAT)
  
  logging.debug("This is a debug log.") # 参数msg
  logging.info("This is a info log.")
  logging.warning("This is a warning log.")
  logging.error("This is a error log.")
  logging.critical("This is a critical log.")
  
  '''
  eg_1.log:
  
  2018-08-28 21:31:35,269=====DEBUG++++++This is a debug log.
  2018-08-28 21:31:35,271=====INFO++++++This is a info log.
  2018-08-28 21:31:35,271=====WARNING++++++This is a warning log.
  2018-08-28 21:31:35,271=====ERROR++++++This is a error log.
  2018-08-28 21:31:35,271=====CRITICAL++++++This is a critical log.
  2018-08-28 21:31:57,768=====DEBUG++++++This is a debug log.
  2018-08-28 21:31:57,776=====INFO++++++This is a info log.
  2018-08-28 21:31:57,776=====WARNING++++++This is a warning log.
  2018-08-28 21:31:57,777=====ERROR++++++This is a error log.
  2018-08-28 21:31:57,777=====CRITICAL++++++This is a critical log.
  
  
  '''

  format当然是有很多参数的喵~用时自查

  四大组件

  • 日志器(Logger): 产生日志的一个接口

    • 操作

    Logger.setLevel() ——设置日志器将会处理的日志消息的最低严重级别
    Logger.addHandler() 和 Logger.removeHandler()——为该logger对象添加 和 移除一个handler对象
    Logger.addFilter() 和 Logger.removeFilter()——为该logger对象添加 和 移除一个filter对象
    Logger.debug()—— 产生一条debug级别的日志，同理，info，error，等
    Logger.exception()——创建类似于Logger.error的日志消息
    Logger.log()——获取一个明确的日志level参数类创建一个日志记录

    • 得到一个logger——实例化：logging.getLogger()

  • 处理器(Handler):把产生的日志发送到相应的目的地

    logging.StreamHandler ——将日志消息发送到输出到Stream，如std.out, std.err或任何file-like对象。
    logging.FileHandler——将日志消息发送到磁盘文件，默认情况下文件大小会无限增长
    logging.handlers.RotatingFileHandler——将日志消息发送到磁盘文件，并支持日志文件按大小切割
    logging.hanlders.TimedRotatingFileHandler——将日志消息发送到磁盘文件，并支持日志文件按时间切割
    logging.handlers.HTTPHandler——将日志消息以GET或POST的方式发送给一个HTTP服务器
    logging.handlers.SMTPHandler——将日志消息发送给一个指定的email地址
    logging.NullHandler——该Handler实例会忽略error messages，通常被想使用logging的library开发者使用来避免'No handlers could be found for logger XXX'信息的出现。

  • 过滤器(Filter): 更精细的控制那些日志输出

    • 直接实例化

    • 继承Format添加特殊内容

    • 三个参数

      • fmt：指定消息格式化字符串，如果不指定该参数则默认使用message的原始值

      • datefmt：指定日期格式字符串，如果不指定该参数则默认使用"%Y-%m-%d %H:%M:%S"

      • style：Python 3.2新增的参数，可取值为 '%', '{'和 '$'，如果不指定该参数则默认使用'%'

  • 格式器(Formatter): 对输出信息进行格式化

    • 可以被Handler和Logger使用

    • 控制传递过来的信息的具体内容

  eg_2

  '''
  1. 需求
  现在有以下几个日志记录的需求：
      1）要求将所有级别的所有日志都写入磁盘文件中
      2）all.log文件中记录所有的日志信息，日志格式为：日期和时间 - 日志级别 - 日志信息
      3）error.log文件中单独记录error及以上级别的日志信息，日志格式为：日期和时间 - 日志级别 - 文件名[:行号] - 日志信息
      4）要求all.log在每天凌晨进行日志切割
  
  2. 分析
      1）要记录所有级别的日志，因此日志器的有效level需要设置为最低级别--DEBUG;
      2）日志需要被发送到两个不同的目的地，因此需要为日志器设置两个handler；另外，两个目的地都是磁盘文件，因此这两个handler都是与FileHandler相关的；
      3）all.log要求按照时间进行日志切割，因此他需要用logging.handlers.TimedRotatingFileHandler; 而error.log没有要求日志切割，因此可以使用FileHandler;
      4）两个日志文件的格式不同，因此需要对这两个handler分别设置格式器；
  '''
  
  import logging
  import logging.handlers
  import datetime
  
  
  # 定义logger
  logger = logging.getLogger('mylogger')
  logger.setLevel(logging.DEBUG)
  
  
  #为两个不同的文件设置不同的handler
  rf_handler = logging.handlers.TimedRotatingFileHandler('all.log', when='midnight', interval=1, backupCount=7, atTime=datetime.time(0, 0, 0, 0))
  rf_handler.setFormatter(logging.Formatter("%(asctime)s - %(levelname)s - %(message)s"))
  
  
  
  f_handler = logging.FileHandler('error.log')
  f_handler.setLevel(logging.ERROR)
  f_handler.setFormatter(logging.Formatter("%(asctime)s - %(levelname)s - %(filename)s[:%(lineno)d] - %(message)s"))
  
  # 把相应的处理器组装到logger上
  logger.addHandler(rf_handler)
  logger.addHandler(f_handler)
  
  
  logger.debug('debug message')
  logger.info('info message')
  logger.warning('warning message')
  logger.error('error message')
  logger.critical('critical message')