python的logging模块

日志可以用来干什么?

日志主要用来跟踪程序的运行状态。记录日志能够帮我们了解程序是否运行正常,程序出现问题时,也能够通过日志记录,快速定位到问题所在。

一  logging模块定义了5种日志等级,依次从低到高:

  1. DEBUG:用于调试目的的底层系统信息
  2. INFO:普通系统信息
  3. WARNING:表示出现一个较小问题
  4. ERROR:表示出现一个错误问题
  5. CRITICAL:表示出现一个致命问题

系统默认等级是WARNING,即低于WARNING等级的日志不会显示。

比如:

In [1]: import logging

In [2]: logging.info("aaaa")

In [3]: logging.warning("bbbb")
WARNING:root:bbbb

二  将日志记录到文件中

一个简单例子:

example_logging.py 文件的内容

import logging

logging.basicConfig(level=logging.DEBUG,
                    format='%(asctime)s %(pathname)s %(filename)s [line:%(lineno)s] %(levelname)s %(message)s',
                    filename='/tmp/test.log',
                    filemode='w')

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

文件test.log的内容:

2017-12-31 14:30:01,793 example_logging.py example_logging.py [line:8] DEBUG debug message
2017-12-31 14:30:01,794 example_logging.py example_logging.py [line:9] INFO info message
2017-12-31 14:30:01,794 example_logging.py example_logging.py [line:10] WARNING warning message
2017-12-31 14:30:01,794 example_logging.py example_logging.py [line:11] ERROR error message
2017-12-31 14:30:01,794 example_logging.py example_logging.py [line:12] CRITICAL critical message

basciCofing的参数说明:

level:设置日志等级

format:日志输出格式:

    •  %(levelno)s: 打印日志级别的数值
    •  %(levelname)s: 打印日志级别名称
    •  %(pathname)s: 打印当前执行程序的路径,其实就是sys.argv[0]
    • %(name)s: 打印当前程序的名称,包括前面的模块
    •  %(filename)s: 打印当前执行程序名
    •  %(module)s:filename名称部分,不包含后缀
    •  %(funcName)s: 打印日志的当前函数
    •  %(lineno)d: 打印日志的当前行号
    •  %(asctime)s: 打印日志的时间
    •  %(thread)d: 打印线程ID
    •  %(threadName)s: 打印线程名称
    •  %(process)d: 打印进程ID
    •  %(message)s: 打印日志信息

filename:保存的文件名称

filemode:文件打开模式

三 日志的高级用法

  1. python日志系统是由4部分组成:
    1. logger:Logger 为日志系统的入口。每个logger命名都是bucket,你可以向这个bucket写入需要处理的消息,当一条消息传递给logger 时,消息的日志级别将与logger 的日志级别进行比较。如果消息的日志级别大于等于logger 的日志级别,该消息将会往下继续处理。如果小于,该消息将被忽略。
    2. Handler:Handler 决定如何处理logger 中的每条消息。它表示一个详细的日志行为,例如将消息写到屏幕上、写到文件中或者写到网络socket。与logger 一样,handler 也有一个日志级别。如果消息的日志级别小于handler 的级别,handler 将忽略该消息。
    3. Filter:Filter 用于对从logger 传递给handler 的日志记录进行额外的控制。
    4. Formatter:格式控制
  2. 基本流程
    1. 创建logger,设置logger的各个参数,日志级别、filter等
    2. 创建handler,给logger添加handler,分别处理logger中的信息,handler可以设置参数、日志级别,日志格式、filter等
  3. 简单例子(将日志结果输出到控制台)
import logging

# 创建 一个logger,级别为DEBUG
logger = logging.getLogger('simple_example')
logger.setLevel(logging.DEBUG)

# 创建 一个 handler,用于处理控制台输出,处理级别为DEBUG
ch = logging.StreamHandler()
ch.setLevel(logging.DEBUG)

# 设置输出格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

# 给ch添加输出格式
ch.setFormatter(formatter)

# 将ch添加到logger上
logger.addHandler(ch)

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

 

 运行结果

$ python simple_logging_config.py
2005-03-19 15:38:55,977 - simpleExample - DEBUG - debug message
2005-03-19 15:38:55,979 - simpleExample - INFO - info message
2005-03-19 15:38:56,054 - simpleExample - WARNING - warn message
2005-03-19 15:38:56,055 - simpleExample - ERROR - error message
2005-03-19 15:38:56,130 - simpleExample - CRITICAL - critical message

 四 其他

  1. logging是线程安全的吗?

   是线程安全的,但不是进程安全的

posted @ 2017-12-31 15:33  曲径通幽处  阅读(220)  评论(0编辑  收藏  举报