python logging

logging
一、StreamHandler
流handler——包含在logging模块中的三个handler之一。
能够将日志信息输出到sys.stdout, sys.stderr 或者类文件对象（更确切点，就是能够支持write()和flush()方法的对象）。
只有一个参数：
class logging.StreamHandler(stream=None)
日志信息会输出到指定的stream中，如果stream为空则默认输出到sys.stderr。
二、FileHandler
logging模块自带的三个handler之一。继承自StreamHandler。将日志信息输出到磁盘文件上。
构造参数：
class logging.FileHandler(filename, mode=‘a’, encoding=None, delay=False)
模式默认为append，delay为true时，文件直到emit方法被执行才会打开。默认情况下，日志文件可以无限增大。
三、NullHandler
空操作handler，logging模块自带的三个handler之一。
没有参数。
四、WatchedFileHandler
位于logging.handlers模块中。用于监视文件的状态，如果文件被改变了，那么就关闭当前流，重新打开文件，创建一个新的流。由于newsyslog或者logrotate的使用会导致文件改变。这个handler是专门为linux/unix系统设计的，因为在windows系统下，正在被打开的文件是不会被改变的。
参数和FileHandler相同：
class logging.handlers.WatchedFileHandler(filename, mode=‘a’, encoding=None, delay=False)
五、RotatingFileHandler
位于logging.handlers支持循环日志文件。
class logging.handlers.RotatingFileHandler(filename, mode=‘a’, maxBytes=0, backupCount=0, encoding=None, delay=0)
参数maxBytes和backupCount允许日志文件在达到maxBytes时rollover.当文件大小达到或者超过maxBytes时，就会新创建一个日志文件。上述的这两个参数任一一个为0时，rollover都不会发生。也就是就文件没有maxBytes限制。backupcount是备份数目，也就是最多能有多少个备份。命名会在日志的base_name后面加上.0-.n的后缀，如example.log.1,example.log.1,…,example.log.10。当前使用的日志文件为base_name.log。
六、TimedRotatingFileHandler
定时循环日志handler，位于logging.handlers，支持定时生成新日志文件。
class logging.handlers.TimedRotatingFileHandler(filename, when=‘h’, interval=1, backupCount=0, encoding=None, delay=False, utc=False)
参数when决定了时间间隔的类型，参数interval决定了多少的时间间隔。如when=‘D’，interval=2，就是指两天的时间间隔，backupCount决定了能留几个日志文件。超过数量就会丢弃掉老的日志文件。
when的参数决定了时间间隔的类型。两者之间的关系如下：

1. ‘S’ | 秒
3. ‘M’ | 分
5. ‘H’ | 时
7. ‘D’ | 天
9. ‘W0’-‘W6’ | 周一至周日
11. ‘midnight’ | 每天的凌晨
    utc参数表示UTC时间。
    七、其他handler——SocketHandler、DatagramHandler、SysLogHandler、NtEventHandler、SMTPHandler、MemoryHandler、HTTPHandler
    这些handler都不怎么常用，所以具体介绍就请参考官方文档 其他handlers
    下面使用简单的例子来演示handler的使用：
    例子一——不使用配置文件的方式（StreamHandler）：
12. import logging

14. set up logging to file - see previous section for more details

15. logging.basicConfig(level=logging.DEBUG,

16.                  format='%(asctime)s %(name)-12s %(levelname)-8s %(message)s',
    

17.                  datefmt='%m-%d %H:%M',
    

18.                  filename='/temp/myapp.log',
    

19.                  filemode='w')
    

20. define a Handler which writes INFO messages or higher to the sys.stderr

22. console = logging.StreamHandler()
23. console.setLevel(logging.INFO)

24. set a format which is simpler for console use

25. #设置格式
26. formatter = logging.Formatter(’%(name)-12s: %(levelname)-8s %(message)s’)

27. tell the handler to use this format

28. #告诉handler使用这个格式
29. console.setFormatter(formatter)

30. add the handler to the root logger

31. #为root logger添加handler
32. logging.getLogger(’’).addHandler(console)

34. Now, we can log to the root logger, or any other logger. First the root…

35. #默认使用的是root logger
36. logging.info(‘Jackdaws love my big sphinx of quartz.’)

38. Now, define a couple of other loggers which might represent areas in your

39. application:

41. logger1 = logging.getLogger(‘myapp.area1’)
42. logger2 = logging.getLogger(‘myapp.area2’)
44. logger1.debug(‘Quick zephyrs blow, vexing daft Jim.’)
45. logger1.info(‘How quickly daft jumping zebras vex.’)
46. logger2.warning(‘Jail zesty vixen who grabbed pay from quack.’)
47. logger2.error(‘The five boxing wizards jump quickly.’)
    输出到控制台的结果：
48. root : INFO Jackdaws love my big sphinx of quartz.
49. myapp.area1 : INFO How quickly daft jumping zebras vex.
50. myapp.area2 : WARNING Jail zesty vixen who grabbed pay from quack.
51. myapp.area2 : ERROR The five boxing wizards jump quickly.
    例子二——使用配置文件的方式(TimedRotatingFileHandler) :
    log.conf 日志配置文件：
52. [loggers]
53. keys=root,test.subtest,test
55. [handlers]
56. keys=consoleHandler,fileHandler
58. [formatters]
59. keys=simpleFormatter
61. [logger_root]
62. level=INFO
63. handlers=consoleHandler,fileHandler
65. [logger_test]
66. level=INFO
67. handlers=consoleHandler,fileHandler
68. qualname=tornado
69. propagate=0
71. [logger_test.subtest]
72. level=INFO
73. handlers=consoleHandler,fileHandler
74. qualname=rocket.raccoon
75. propagate=0
77. [handler_consoleHandler] #输出到控制台的handler
78. class=StreamHandler
79. level=DEBUG
80. formatter=simpleFormatter
81. args=(sys.stdout,)
83. [handler_fileHandler] #输出到日志文件的handler
84. class=logging.handlers.TimedRotatingFileHandler
85. level=DEBUG
86. formatter=simpleFormatter
87. args=(‘rocket_raccoon_log’,‘midnight’)
89. [formatter_simpleFormatter]
90. format=[%(asctime)s-%(name)s(%(levelname)s)%(filename)s:%(lineno)d]%(message)s
91. datefmt=
93. logging.config.fileConfig(‘conf/log.conf’)
94. logger = getLogging()
    获取logger方法：
95. def getLogging():

96.  return logging.getLogger("test.subtest")
    

配置logger并且调用：

1. logging.config.fileConfig(‘conf/log.conf’)
2. logger = getLogging()
3. logger.info(“this is an example!”)
   控制台和日志文件中都会输出：
   [2016-07-01 09:22:06,470-test.subtest(INFO)main.py:55]this is an example!