Python模块:日志输出—logging模块
1. logging介绍
Python的logging模块提供了通用的日志系统,可以方便第三方模块或者是应用使用。这个模块提供不同的日志级别,并可以采用不同的方式记录日志,比如文件,HTTP GET/POST,SMTP,Socket等,甚至可以自己实现具体的日志记录方式。
logging模块与log4j的机制是一样的,只是具体的实现细节不同。模块提供logger,handler,filter,formatter。
logger:提供日志接口,供应用代码使用。logger最长用的操作有两类:配置和发送日志消息。可以通过logging.getLogger(name)获取logger对象,如果不指定name则返回root对象,多次使用相同的name调用getLogger方法返回同一个logger对象。
handler:将日志记录(log record)发送到合适的目的地(destination),比如文件,socket等。一个logger对象可以通过addHandler方法添加0到多个handler,每个handler又可以定义不同日志级别,以实现日志分级过滤显示。
filter:提供一种优雅的方式决定一个日志记录是否发送到handler。
formatter:指定日志记录输出的具体格式。formatter的构造方法需要两个参数:消息的格式字符串和日期字符串,这两个参数都是可选的。
与log4j类似,logger,handler和日志消息的调用可以有具体的日志级别(Level),只有在日志消息的级别大于logger和handler的级别。
import logging import logging.handlers LOG_FILE = 'tst.log' handler = logging.handlers.RotatingFileHandler(LOG_FILE, maxBytes = 1024*1024, backupCounts = 5) # 实例化handler fmt = '%(asctime)s - %(filename)s:%(lineno)s - %(name)s - %(message)s' formatter = logging.Formatter(fmt) # 实例化formatter handler.setFormatter(formatter) # 为handler添加formatter logger = logging.getLogger('tst') # 获取名为tst的logger logger.addHandler(handler) # 为logger添加handler logger.setLevel(logging.DEBUG) logger.info('first info message') logger.debug('first debug message')
输出:
2012-03-04 23:21:59,682 - log_test.py:16 - tst - first info message 2012-03-04 23:21:59,682 - log_test.py:17 - tst - first debug message
关于formatter的配置,采用的是%(<dict key>)s的形式,就是字典的关键字替换。提供的关键字包括:
Format | Description |
---|---|
%(name)s | Name of the logger (logging channel). |
%(levelno)s | Numeric logging level for the message (DEBUG, INFO, WARNING, ERROR, CRITICAL). |
%(levelname)s | Text logging level for the message ('DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'). |
%(pathname)s | Full pathname of the source file where the logging call was issued (if available). |
%(filename)s | Filename portion of pathname. |
%(module)s | Module (name portion of filename). |
%(funcName)s | Name of function containing the logging call. |
%(lineno)d | Source line number where the logging call was issued (if available). |
%(created)f | Time when the LogRecord was created (as returned by time.time()). |
%(relativeCreated)d | Time in milliseconds when the LogRecord was created, relative to the time the logging module was loaded. |
%(asctime)s | Human-readable time when the LogRecord was created. By default this is of the form “2003-07-08 16:49:45,896” (the numbers after the comma are millisecond portion of the time). |
%(msecs)d | Millisecond portion of the time when the LogRecord was created. |
%(thread)d | Thread ID (if available). |
%(threadName)s | Thread name (if available). |
%(process)d | Process ID (if available). |
%(message)s | The logged message, computed as msg % args. |
这个是摘自官网,提供了很多信息。
2. logging的配置
logging的配置可以采用python代码或是配置文件。python代码的方式就是在应用的主模块中,构建handler,handler,formatter等对象。而配置文件的方式是将这些对象的依赖关系分离出来放在文件中。比如前面的例子就类似于python代码的配置方式。这里看一下采用配置文件的方式。
- import logging
- import logging.config
- logging.config.fileConfig("logging.conf") # 采用配置文件
- # create logger
- logger = logging.getLogger("simpleExample")
- # "application" code
- logger.debug("debug message")
- logger.info("info message")
- logger.warn("warn message")
- logger.error("error message")
- logger.critical("critical message")
loggin.conf采用了模式匹配的方式进行配置,正则表达式是r'^[(.*)]$',从而匹配出所有的组件。对于同一个组件具有多个实例的情况使用逗号‘,’进行分隔。对于一个实例的配置采用componentName_instanceName配置块。使用这种方式还是蛮简单的。
- [loggers]
- keys=root,simpleExample
- [handlers]
- keys=consoleHandler
- [formatters]
- keys=simpleFormatter
- [logger_root]
- level=DEBUG
- handlers=consoleHandler
- [logger_simpleExample]
- level=DEBUG
- handlers=consoleHandler
- qualname=simpleExample
- propagate=0
- [handler_consoleHandler]
- class=StreamHandler
- level=DEBUG
- formatter=simpleFormatter
- args=(sys.stdout,)
- [formatter_simpleFormatter]
- format=%(asctime)s - %(name)s - %(levelname)s - %(message)s
- datefmt=
在指定handler的配置时,class是具体的handler类的类名,可以是相对logging模块或是全路径类名,比如需要RotatingFileHandler,则class的值可以为:RotatingFileHandler或者logging.handlers.RotatingFileHandler。args就是要传给这个类的构造方法的参数,就是一个元组,按照构造方法声明的参数的顺序。
输出:
[plain] view plaincopyprint?
2012-03-06 00:09:35,713 - simpleExample - DEBUG - debug message
2012-03-06 00:09:35,713 - simpleExample - INFO - info message
2012-03-06 00:09:35,714 - simpleExample - WARNING - warn message
2012-03-06 00:09:35,714 - simpleExample - ERROR - error message
2012-03-06 00:09:35,714 - simpleExample - CRITICAL - critical message
这里还要明确一点,logger对象是有继承关系的,比如名为a.b和a.c的logger都是名为a的子logger,并且所有的logger对象都继承于root。如果子对象没有添加handler等一些配置,会从父对象那继承。这样就可以通过这种继承关系来复用配置。
3. 多模块使用logging
logging模块保证在同一个python解释器内,多次调用logging.getLogger('log_name')都会返回同一个logger实例,即使是在多个模块的情况下。所以典型的多模块场景下使用logging的方式是在main模块中配置logging,这个配置会作用于多个的子模块,然后在其他模块中直接通过getLogger获取Logger对象即可。
这里使用上面配置文件:
[plain] view plaincopyprint?
[loggers]
keys=root,main
[handlers]
keys=consoleHandler,fileHandler
[formatters]
keys=fmt
[logger_root]
level=DEBUG
handlers=consoleHandler
[logger_main]
level=DEBUG
qualname=main
handlers=fileHandler
[handler_consoleHandler]
class=StreamHandler
level=DEBUG
formatter=fmt
args=(sys.stdout,)
[handler_fileHandler]
class=logging.handlers.RotatingFileHandler
level=DEBUG
formatter=fmt
args=('tst.log','a',20000,5,)
[formatter_fmt]
format=%(asctime)s - %(name)s - %(levelname)s - %(message)s
datefmt=
主模块main.py:
- import logging
- import logging.config
- logging.config.fileConfig('logging.conf')
- root_logger = logging.getLogger('root')
- root_logger.debug('test root logger...')
- logger = logging.getLogger('main')
- logger.info('test main logger')
- logger.info('start import module \'mod\'...')
- import mod
- logger.debug('let\'s test mod.testLogger()')
- mod.testLogger()
- root_logger.info('finish test...')
子模块mod.py:
- import logging
- import submod
- logger = logging.getLogger('main.mod')
- logger.info('logger of mod say something...')
- def testLogger():
- logger.debug('this is mod.testLogger...')
- submod.tst()
子子模块submod.py:
- import logging
- logger = logging.getLogger('main.mod.submod')
- logger.info('logger of submod say something...')
- def tst():
- logger.info('this is submod.tst()...')
然后运行python main.py,控制台输出:
- 2012-03-09 18:22:22,793 - root - DEBUG - test root logger...
- 2012-03-09 18:22:22,793 - main - INFO - test main logger
- 2012-03-09 18:22:22,809 - main - INFO - start import module 'mod'...
- 2012-03-09 18:22:22,809 - main.mod.submod - INFO - logger of submod say something...
- 2012-03-09 18:22:22,809 - main.mod - INFO - logger say something...
- 2012-03-09 18:22:22,809 - main - DEBUG - let's test mod.testLogger()
- 2012-03-09 18:22:22,825 - main.mod - DEBUG - this is mod.testLogger...
- 2012-03-09 18:22:22,825 - main.mod.submod - INFO - this is submod.tst()...
- 2012-03-09 18:22:22,841 - root - INFO - finish test...
可以看出,和预想的一样,然后在看一下tst.log,logger配置中的输出的目的地:
- 2012-03-09 18:22:22,793 - main - INFO - test main logger
- 2012-03-09 18:22:22,809 - main - INFO - start import module 'mod'...
- 2012-03-09 18:22:22,809 - main.mod.submod - INFO - logger of submod say something...
- 2012-03-09 18:22:22,809 - main.mod - INFO - logger say something...
- 2012-03-09 18:22:22,809 - main - DEBUG - let's test mod.testLogger()
- 2012-03-09 18:22:22,825 - main.mod - DEBUG - this is mod.testLogger...
- 2012-03-09 18:22:22,825 - main.mod.submod - INFO - this is submod.tst()...
tst.log中没有root logger输出的信息,因为logging.conf中配置了只有main logger及其子logger使用RotatingFileHandler,而root logger是输出到标准输出。
转:http://blog.csdn.net/chosen0ne/article/details/7319306
Python模块:日志输出—logging模块相关推荐
- Python的日志记录-logging模块的使用
一.日志 1.1什么是日志 日志是跟踪软件运行时所发生的事件的一种方法,软件开发者在代码中调用日志函数,表明发生了特定的事件,事件由描述性消息描述,同时还包含事件的重要性,重要性也称为级别或严重性. ...
- python日志:logging模块使用
# python日志:logging模块使用 logging模块是Python内置的标准模块,主要用于输出运行日志,可以设置输出日志的等级.日志保存路径.日志文件回滚等, 记录运行时的过程 ## 日志 ...
- python日志模块备份_Python Logging模块 输出日志颜色、过期清理和日志滚动备份
#coding:utf-8 importloggingfrom logging.handlers importRotatingFileHandler # 按文件大小滚动备份import colorlo ...
- python日志模块 限制日志记录数_python日志记录-logging模块
1.logging模块日志级别 使用logging模块简单示例: >>>import logging >>>logging.debug("this's a ...
- 令人震惊的大坑——python多进程多日志运用logging模块时磁盘内存不足
前言:最近写测试框架遇到了一个磁盘内存不足的问题,问题是多进程往同一个日志文件中写日志,由于我设置了日志文件大小,所以会面临不同进程对同一个文件进行读写,句柄泄漏导致磁盘空间无法释放,机器的磁盘被占满 ...
- python logging模块使用_python logging模块使用
近来再弄一个小项目,已经到收尾阶段了.希望加入写log机制来增加程序出错后的判断分析.尝试使用了python logging模块. #-*- coding:utf-8 -*- importloggin ...
- python三十九:logging模块
import logginglogging.basicConfig(level=logging.DEBUG # 设置日志级别, 默认为 WARNING,filename="logger.lo ...
- 优雅地记录Python程序日志2:模块组件化日志记录器
本文摘自:https://zhuanlan.zhihu.com/p/32043593 本篇将会涉及: logging的各个模块化组件 构建一个组件化的日志器 logging的模块组件化 在上一篇文章中 ...
- python logging模块 默认_python logging模块
函数式简单配置 importlogging logging.debug('debug message') #计算或者工作的细节 logging.info('info message') #记录一些用户 ...
最新文章
- BIOS设置和CMOS设置的区别和联系
- ip通信基础第九周(下)
- 树莓派模拟电路_9.树莓派3B+ PWM操作
- Python自动化办公之Excel对比工具
- html文件中script标签放在哪里?
- Leetcode 3:无重复字符的最长子串
- idft重建图像 matlab_利用 MATLAB 编程,打开一幅图像,对其进行 DFT 变换,并置其不同区域内的系数为零,进行 IDFT ,观察其输出效果。_学小易找答案...
- cassandra学习笔记三
- 如何在Python中读取属性文件?
- 反病毒工具 PCHunter 1.5.6
- 美通企业日报 | 拜耳健康消费品中国研发中心开幕;TCL上半年电视机销量稳居全球第二...
- 语义分割中的mIoU计算函数解读
- 【疑难杂症】The last packet sent successfully to the server was 0 milliseconds ago.
- 关于互联网公司的加班制度,我想说点心里话
- GuiLite 2.0 发布:Golang 的 GUI 外衣
- DecimalFormat 保留小数格式化
- 上线MES系统后,这6大问题必须注意
- 简单五子棋算法——初级篇
- wetool个人版_wetool企业版下载安装社群运营管理工具
- centos查找和替换字符串
热门文章
- iPhone 路径大全
- vscode 新建php模板,使用vscode快速建立vue模板
- 2018最新java面试题(含答案)
- 1084. Broken Keyboard (20)
- 《像计算机科学家一样思考Java》—— 导读
- lightoj 1224
- 64Ubuntu报错Failed to get the adb version:
- SQL Server:Like 通配符特殊用法:Escape
- 3d geometric model website http://www.cse.ohio-state.edu/~tamaldey/
- 软件开发需要重视对异常的处理