操作系统服务：logging日志记录模块

许多应用程序中都会有日志模块，用于记录系统在运行过程中的一些关键信息，以便于对系统的运行状况进行跟踪。

在.NET平台中，有非常著名的第三方开源日志组件log4net，c++中，有人们熟悉的log4cpp。

而在Python中，我们不需要第三方的日志组件，因为它已经为我们提供了简单易用、且功能强大的日志模块：logging。

logging模块支持将日志信息保存到不同的目标域中，如：保存到日志文件中；以邮件的形式发送日志信息；以http get或post的方式提交日志到web服务器；以windows事件的形式记录等等。这些日志保存方式可以组合使用，每种方式可以设置自己的日志级别以及日志格式。

logging模块主要函数

• 16.6.logging — Logging facility for Python
  • 16.6.1. Logger Objects
  • 16.6.2. Logging Levels
  • 16.6.3. Handler Objects
  • 16.6.4. Formatter Objects
  • 16.6.5. Filter Objects
  • 16.6.6. LogRecord Objects
  • 16.6.7. LogRecord attributes
  • 16.6.8. LoggerAdapter Objects
  • 16.6.9. Thread Safety
  • 16.6.10. Module-Level Functions
  • 16.6.11. Module-Level Attributes
  • 16.6.12. Integration with the warnings module
• 16.7.logging.config — Logging configuration
  • 16.7.1. Configuration functions
  • 16.7.2. Configuration dictionary schema
    • 16.7.2.1. Dictionary Schema Details
    • 16.7.2.2. Incremental Configuration
    • 16.7.2.3. Object connections
    • 16.7.2.4. User-defined objects
    • 16.7.2.5. Access to external objects
    • 16.7.2.6. Access to internal objects
    • 16.7.2.7. Import resolution and custom importers
  • 16.7.3. Configuration file format
• 16.8.logging.handlers — Logging handlers
  • 16.8.1. StreamHandler
  • 16.8.2. FileHandler
  • 16.8.3. NullHandler
  • 16.8.4. WatchedFileHandler
  • 16.8.5. BaseRotatingHandler
  • 16.8.6. RotatingFileHandler
  • 16.8.7. TimedRotatingFileHandler
  • 16.8.8. SocketHandler
  • 16.8.9. DatagramHandler
  • 16.8.10. SysLogHandler
  • 16.8.11. NTEventLogHandler
  • 16.8.12. SMTPHandler
  • 16.8.13. MemoryHandler
  • 16.8.14. HTTPHandler
  • 16.8.15. QueueHandler
  • 16.8.16. QueueListener

皮皮blog

logging模块的基本使用

logging使用的基本格式如下

import logginglogging.basicConfig(format='%(asctime)s : %(levelname)s : %(message)s', level=logging.INFO)

简单例子1

[python] view plain copy

print?

1. import logging    
2. logging.basicConfig(filename = os.path.join(os.getcwd(), 'log.txt'), level = logging.DEBUG)    
3. logging.debug('this is a message')    

import logging  logging.basicConfig(filename = os.path.join(os.getcwd(), 'log.txt'), level = logging.DEBUG)  logging.debug('this is a message')  

运行上面例子的代码，将会在程序的根目录下创建一个log.txt文件，打开该文件，里面有一条日志记录："DEBUG:root:this is a message"。

四个主要的组件
logger: 日志类，应用程序往往通过调用它提供的api来记录日志；
handler: 对日志信息处理，可以将日志发送(保存)到不同的目标域中；
filter: 对日志信息进行过滤；
formatter:日志的格式化；

日志级别

在记录日志时, 日志消息都会关联一个级别("级别"本质上是一个非负整数)。系统默认提供了6个级别，它们分别是：

级别对应的值CRITICAL50ERROR40WARNING30INFO20DEBUG10NOTSET0可以给日志对象(Logger Instance)设置日志级别，低于该级别的日志消息将会被忽略，也可以给Hanlder设置日志级别，对于低于该级别的日志消息, Handler也会忽略。

皮皮blog

logging模块中的常用函数

logging.basicConfig([**kwargs]):

为日志模块配置基本信息。

kwargs 支持如下几个关键字参数
filename ：日志文件的保存路径。如果配置了些参数，将自动创建一个FileHandler作为Handler；
filemode ：日志文件的打开模式。 默认值为'a'，表示日志消息以追加的形式添加到日志文件中。如果设为'w', 那么每次程序启动的时候都会创建一个新的日志文件；
format ：设置日志输出格式；
datefmt ：定义日期格式；
level ：设置日志的级别，对低于该级别的日志消息将被忽略；
stream ：设置特定的流用于初始化StreamHandler；

[python] view plain copy

print?

1. import logging    
2. logging.basicConfig(filename = os.path.join(os.getcwd(), 'log.txt'), /    
3.     level = logging.WARN, filemode = 'w', format = '%(asctime)s - %(levelname)s: %(message)s')    
4. logging.debug('debug')  #被忽略    
5. logging.info('info')    #被忽略    
6. logging.warning('warn')    
7. logging.error('error')    
8. #----- 结果    
9. #2009-07-13 21:42:15,592 - WARNING: warn    
10. #2009-07-13 21:42:15,640 - ERROR: error    

import logging  logging.basicConfig(filename = os.path.join(os.getcwd(), 'log.txt'), /      level = logging.WARN, filemode = 'w', format = '%(asctime)s - %(levelname)s: %(message)s')  logging.debug('debug')  #被忽略  logging.info('info')    #被忽略  logging.warning('warn')  logging.error('error')  #----- 结果  #2009-07-13 21:42:15,592 - WARNING: warn  #2009-07-13 21:42:15,640 - ERROR: error  

logging.getLogger([name])

创建Logger对象。日志记录的工作主要由Logger对象来完成。在调用getLogger时要提供Logger的名称（注：多次使用相同名称来调用getLogger，返回的是同一个对象的引用。）

Logger实例之间有层次关系，这些关系通过Logger名称来体现，如：

p = logging.getLogger("root")

c1 = logging.getLogger("root.c1")

c2 = logging.getLogger("root.c2")

Note:

1. p是父logger, c1,c2分别是p的子logger。c1, c2将继承p的设置。

2. 如果省略了name参数, getLogger将返回日志对象层次关系中的根Logger。

logging.setLoggerClass(klass)

logging.getLoggerClass()

　　获取/设置日志类型。用户可以自定义日志类来代替系统提供的logging.Logger类。

logging.getLevelName(lvl)

　　获取日志级别对应的名称。

logging.shutdown()

　　当不再使用日志系统的时候，调用该方法，它会将日志flush到对应的目标域上。一般在系统退出的时候调用。

皮皮blog

Logger对象方法和属性

通过调用logging.getLogger(name)来创建，有如下常用的方法和属性：

Logger.setLevel(lvl):

设置日志的级别。对于低于该级别的日志消息将被忽略。setLevel方法的例子：

[python] view plain copy

print?

1. #coding=gbk    
2. import logging    
3. logging.basicConfig(filename = os.path.join(os.getcwd(), 'log.txt'), level = logging.DEBUG)    
4. log = logging.getLogger('root.test')    
5. log.setLevel(logging.WARN)  #日志记录级别为WARNNING    
6. log.info('info')    #不会被记录    
7. log.debug('debug')  #不会被记录    
8. log.warning('warnning')    
9. log.error('error')  

#coding=gbk  import logging  logging.basicConfig(filename = os.path.join(os.getcwd(), 'log.txt'), level = logging.DEBUG)  log = logging.getLogger('root.test')  log.setLevel(logging.WARN)  #日志记录级别为WARNNING  log.info('info')    #不会被记录  log.debug('debug')  #不会被记录  log.warning('warnning')  log.error('error')

Logger.debug(msg[ ,*args [, **kwargs]])

记录DEBUG级别的日志信息。参数msg是信息的格式，args与kwargs分别是格式参数。

[python] view plain copy

print?

1. import logging    
2. logging.basicConfig(filename = os.path.join(os.getcwd(), 'log.txt'), level = logging.DEBUG)    
3. log = logging.getLogger('root')    
4. log.debug('%s, %s, %s', *('error', 'debug', 'info'))    
5. log.debug('%(module)s, %(info)s', {'module': 'log', 'info': 'error'})    

    import logging      logging.basicConfig(filename = os.path.join(os.getcwd(), 'log.txt'), level = logging.DEBUG)      log = logging.getLogger('root')      log.debug('%s, %s, %s', *('error', 'debug', 'info'))      log.debug('%(module)s, %(info)s', {'module': 'log', 'info': 'error'})  

Logger.info(msg[ , *args[ , **kwargs]] )

Logger.warnning(msg[ , *args[ , **kwargs]] )

Logger.error(msg[ , *args[ , **kwargs]] )

Logger.critical(msg[ , *args[ , **kwargs]] )

　　记录相应级别的日志信息。参数的含义与Logger.debug一样。

Logger.log(lvl, msg[ , *args[ , **kwargs]] )

记录日志，参数lvl用户设置日志信息的级别。参数msg, *args, **kwargs的含义与Logger.debug一样。

Logger.exception(msg[, *args]) 

　　以ERROR级别记录日志消息，异常跟踪信息将被自动添加到日志消息里。Logger.exception通过用在异常处理块中，如：

[python] view plain copy

print?

1. import logging    
2. logging.basicConfig(filename = os.path.join(os.getcwd(), 'log.txt'), level = logging.DEBUG)    
3. log = logging.getLogger('root')    
4. try:    
5.     raise Exception, 'this is a exception'    
6. except:    
7.     log.exception('exception') #异常信息被自动添加到日志消息中    

    import logging      logging.basicConfig(filename = os.path.join(os.getcwd(), 'log.txt'), level = logging.DEBUG)      log = logging.getLogger('root')      try:          raise Exception, 'this is a exception'      except:          log.exception('exception') #异常信息被自动添加到日志消息中  

Logger.addFilter(filt)

Logger.removeFilter(filt)

　　添加/移除日志消息过滤器。

Logger.addHandler(hdlr)

Logger.removeHandler(hdlr)

　　添加/移除日志消息处理器。

Logger.makeRecord(name, lvl, fn, lno, msg, args, exc_info[, func, extra])

　　创建LogRecord对象。日志消息被实例为一个LogRecord对象，并在日志类内处理。

[Python模块学习 ---- logging 日志记录（一）]

from:http://blog.csdn.net/pipisorry/article/details/45151825