python logging的使用

来源:互联网 发布:c 面向对象编程 编辑:程序博客网 时间:2024/06/05 22:49

python为我们提供简单易用,强大的日志模块logging,它由4个主要的组件组成:
logger: 日志类,应用程序往往通过调用它提供的api来记录日志;

handler: 对日志信息处理,可以将日志发送(保存)到不同的目标域中;

filter: 对日志信息进行过滤;

formatter:日志的格式化;
日志的级别
在记录日志的时候,日志消息都会自动关联一个级别(“级别”的本质是一个非负整数)。系统默认6个级别,他们发别是
级别 对应的值
CRITICAL 50
ERROR 40
WARNING 30
INFO 20
DEBUG 10
NOTSET 0
即:CRITICAL>ERROR>WARNGING>INFO>DEBUG>NOTSET,当然你也可以自己定义日志级别
默认级别是:WARNING

将日志打印到屏幕上

import logginglogging.debug("This is debug message")logging.info('This is info message')logging.warning('This is warning message')

结果:

WARNING:root:This is warning message

logging.getLogger([name])
创建Logger对象。日志记录的工作主要由Logger对象来完成。在调用getLogger时要提供Logger的名称(注:注多次使用相同名称来调用getLogger,返回的是同一个对象的引用。),Logger实例之间有层次关系,这些关系通过Logger名称来体现,如:
p = logging.getLogger(“root”)

c1 = logging.getLogger(“root.c1”)

c2 = logging.getLogger(“root.c2”)
例子中,p是父logger,c1,c2分别是子logger。c1,c2将继承p的设置。如果省略了name参数,getLogger将返回日志对象层次关系中的根Logger。

logging.getLevelName(lvl)
用于获取日志级别对应的名称。例如:

print(logging.getLevelName(logging.NOTSET))print(logging.getLevelName(10)) #logging.DEBUGprint(logging.getLevelName(logging.DEBUG))print(logging.getLevelName(30)) #logging.WARNprint(logging.getLevelName(logging.ERROR))print(logging.getLevelName(50))  #logging.CRITICAL

输出:

NOTSETDEBUGDEBUGWARNINGERRORCRITICAL

1.通过logging.basicConfig函数对日志的输出格式及方式做相关配置

import logginglogging.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')logging.debug("This is debug message")logging.info('This is info message')logging.warning('This is warning message')

logging.basicConfig函数:用默认Formatter为日志系统建立一个StreamHandler,设置基础配置并加到root logger中
其中各参数:
filename: 指定日志文件名
filemode: 日志文件的打开模式。 默认值为’a’,表示日志消息以追加的形式添加到日志文件中。如果设为’w’, 那么每次程序启动的时候都会创建一个新的日志文件;
format: 指定输出的格式和内容,format可以输出很多有用信息,如上例所示:
%(levelno)s: 打印日志级别的数值
%(levelname)s: 打印日志级别名称
%(pathname)s: 打印当前执行程序的路径,其实就是sys.argv[0]
%(filename)s: 打印当前执行程序名
%(funcName)s: 打印日志的当前函数
%(lineno)d: 打印日志的当前行号
%(asctime)s: 打印日志的时间
%(thread)d: 打印线程ID
%(threadName)s: 打印线程名称
%(process)d: 打印进程ID
%(message)s: 打印日志信息
datefmt: 指定时间格式,同time.strftime()
level: 设置日志级别,默认为logging.WARNING
stream: 指定将日志的输出流,可以指定输出到sys.stderr,sys.stdout或者文件,默认输出到sys.stderr,当stream和filename同时指定时,stream被忽略

2.Logger对象

通过调用logging.getLogger(name)来创建,它有如下常用的方法和属性:
Logger.setLevel(lvl):设置日志的级别。对于低于该级别的日志消息将被忽略。例:

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

输出log.txt文件:

WARNING:root.test:warnningERROR:root.test:error

Logger.debug(msg,[,*args,[**kwargs]]):记录DEBUG级别的日志信息。参数msg是信息的格式,args与kwargs分别是格式参数。
例如:

import logginglogging.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通过用在异常处理块中,如:

import logginglogging.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.addHandler(hdlr)和Logger.removeHandler(hdlr):添加/移除日志消息处理器。例:

import logginghandler=logging.FileHandler("./mylog.log")def log(level):    logger = logging.getLogger()    #不能重复创建handler,否则会重复写入同样的记录    logger.addHandler(handler)    logger.setLevel(level)    logger.debug("debug")    logger.info("info")    logger.warning("warning")    logger.error("error")    logger.critical("critical\n")if __name__ == "__main__":    log(logging.NOTSET)    log(logging.DEBUG)    log(logging.INFO)    log(logging.WARNING)    log(logging.ERROR)    log(logging.CRITICAL)

这样日志会写入当前文件夹的mylog.log中。

参考文章:
http://python.jobbole.com/81521/
http://www.cnblogs.com/dkblog/archive/2011/08/26/2155018.html