python-logging

原文：
https://my.oschina.net/leejun2005/blog/126713
http://www.stamhe.com/?p=862

Python 使用logging模块记录日志涉及四个主要类，使用官方文档中的概括最为合适：

logger提供了应用程序可以直接使用的接口；
handler将(logger创建的)日志记录发送到合适的目的输出；
filter提供了细度设备来决定输出哪条日志记录；
formatter决定日志记录的最终输出格式。

模块级函数
logging.getLogger([name]):返回一个logger对象，如果没有指定名字将返回root logger：

logging.debug()、logging.info()、logging.warning()、logging.error()、logging.critical()：设定root logger的日志级别
logging.basicConfig():用默认Formatter为日志系统建立
*StreamHandler，设置基础配置并加到root logger中

logger:

每个程序在输出信息之前都要获得一个Logger。Logger通常对应了程序的模块名，比如聊天工具的图形界面模块可以这样获得它的Logger：
LOG=logging.getLogger(”chat.gui”)
而核心模块可以这样：
LOG=logging.getLogger(”chat.kernel”)

Logger.setLevel(lel):指定最低的日志级别，低于lel的级别将被忽略。debug是最低的内置级别，critical为最高
Logger.debug()、Logger.info()、Logger.warning()、Logger.error()、Logger.critical()：可以设置的日志级别

Handlers:

handler对象负责发送相关的信息到指定目的地。
Python的日志系统有多种Handler可以使用。

logging.StreamHandler() 信息输出到控制台
logging.FileHandler() 把信息输出到文件
logging.handlers.HTTPHandler: 通过"GET"或"POST"远程输出到HTTP服务器
logging.handlers.SMTPHandler 远程输出日志到邮件地址

上面的方法返回一个Handler对象

addHandler() 可以通过方法添加多个handler.
Handler.setLevel(lel):指定被处理的信息级别，低于lel级别的信息将被忽略
Handler.setFormatter()：给这个handler选择一个格式
Handler.addFilter(filt)、Handler.removeFilter(filt)：新增或删除一个filter对象

example:

console = logging.StreamHandler()
# 打到屏幕上
console.setLevel(logging.INFO)
# 这个Level不起作用么？？
formatter = logging.Formatter('%(name)-12s: %(levelname)-8s %(message)s')
# 日志格式
console.setFormatter(formatter)
# 选定格式
logging.getLogger('').addHandler(console)
# 添加多个Handler

Formatters

Formatter对象设置日志信息最后的规则、结构和内容，默认的时间格式为%Y-%m-%d %H:%M:%S，下面是Formatter常用的一些信息：

火狐截图_2017-05-19T11-38-20.609Z.png

example：

# !/usr/bin/python
# encoding=utf-8
import logging

logging.basicConfig(level=logging.DEBUG,
            format='%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s',
            datefmt='%a, %d %b %Y %H:%M:%S',
            filename='myapp.log',
            filemode='w')
# level: logging.DEBUG  最低级别(会打印所有)， 默认日志级别为logging.WARNING
# format:  asctime -> 当前时间  
#               filename -> 调用函数的文件名
#               lineno -> 调用日志输出的代码行
#               levelname -> 文本形式的日志级别
#               message -> 用户输出的信息
#               datefmt: 指定时间格式，同time.strftime()
# stream: 指定将日志的输出流，可以指定输出到sys.stderr,sys.stdout或者文件，默认输出到sys.stderr，当stream和       filename同时指定时，stream被忽略
# filename: 指定日志文件名
# filemode: 和file函数意义相同，指定日志文件的打开模式，’w’或’a’

logging.debug('This is debug message')
logging.info('This is info message')
logging.warning('This is warning message')

longging日志回滚

import logging
from logging.handlers import RotatingFileHandler
 
#################################################################################################
#定义一个RotatingFileHandler，最多备份5个日志文件，每个日志文件最大10M
Rthandler = RotatingFileHandler('myapp.log', maxBytes=10*1024*1024,backupCount=5)
Rthandler.setLevel(logging.INFO)
formatter = logging.Formatter('%(name)-12s: %(levelname)-8s %(message)s')
Rthandler.setFormatter(formatter)
logging.getLogger('').addHandler(Rthandler)
################################################################################################

从上例和本例可以看出，logging有一个日志处理的主对象，其它处理方式都是通过addHandler添加进去的。
logging的几种handle方式如下：

logging.StreamHandler: 日志输出到流，可以是sys.stderr、sys.stdout或者文件
logging.FileHandler: 日志输出到文件
 
日志回滚方式，实际使用时用RotatingFileHandler和TimedRotatingFileHandler
logging.handlers.BaseRotatingHandler
logging.handlers.RotatingFileHandler
logging.handlers.TimedRotatingFileHandler
 
logging.handlers.SocketHandler: 远程输出日志到TCP/IP sockets
logging.handlers.DatagramHandler:  远程输出日志到UDP sockets
logging.handlers.SMTPHandler:  远程输出日志到邮件地址
logging.handlers.SysLogHandler: 日志输出到syslog
logging.handlers.NTEventLogHandler: 远程输出日志到Windows NT/2000/XP的事件日志
logging.handlers.MemoryHandler: 日志输出到内存中的制定buffer
logging.handlers.HTTPHandler: 通过"GET"或"POST"远程输出到HTTP服务器

logging.config.fileConfig

上面的例子是将日志打印配置写在代码里的，实际上我们用的时候更多是将其写在单独的一个配置文件里，方便修改：

#logger.conf
 
###############################################
 
[loggers]
keys=root,example01,example02
 
[logger_root]
level=DEBUG
handlers=hand01,hand02
 
[logger_example01]
handlers=hand02
qualname=example01
propagate=0
 
[logger_example02]
handlers=hand01,hand03
qualname=example02
propagate=0
 
###############################################
 
[handlers]
keys=hand01,hand02,hand03
 
[handler_hand01]
class=StreamHandler
level=INFO
formatter=form02
args=(sys.stderr,)
 
[handler_hand02]
class=FileHandler
level=DEBUG
formatter=form01
args=('myapp.log', 'a')
 
[handler_hand03]
class=handlers.RotatingFileHandler
level=INFO
formatter=form02
args=('myapp.log', 'a', 10*1024*1024, 5)
 
###############################################
 
[formatters]
keys=form01,form02
 
[formatter_form01]
format=%(asctime)s %(filename)s[line:%(lineno)d] %(levelname)s %(message)s
datefmt=%a, %d %b %Y %H:%M:%S
 
[formatter_form02]
format=%(name)-12s:%(asctime)s: %(levelname)-8s %(message)s
datefmt=%a, %d %b %Y %H:%M:%S

[formatter_form03]
format=%(name)-12s: %(levelname)-8s %(message)s
datefmt=

配置中
args=(sys.stderr) 屏幕打印
hand03中的RotatingFileHandler 当file满了10M时，会将log文件myapp.log 备份, 重新命名为myapp.log.1, 以此类推。
而FileHandler默认值保存一个文件，不限大小

代码中调用日志配置文件：

logging.config.fileConfig("logging.conf")
# 读取配置文件
logger = logging.getLogger("example01")
# 返回一个logger对象，如果没有指定名字将返回root logger