Python 模块学习 logging(2)

一、模块级函数

除了上面描述的类,有许多模块级功能。

1、logging.getLogger([name])

见上小节

2、logging.debug(msg[,*args[,*kwargs]])

在 root logger 上记录消息以level DEBUG；

msg:表示消息格式字符串。

args:作用于msg，是使用字符串格式操作符（注意,这意味着您可以使用关键字的格式字符串,连同一个字典参数。）

kwargs:两个关键字参数,exc_info.

exc_info which, if it does not evaluate as false, causes exception information to be added to the logging message. If an exception tuple (in the format returned bysys.exc_info()) is provided, it is used; otherwise,sys.exc_info() is called to get the exception information.

另一个参数是extra,which can be used to pass a dictionary which is used to populate（填充） the __dict__ of the LogRecord created for the logging event with user-defined attributes.

import loggingFORMAT = '%(asctime)s:[%(IP)s--%(user)-8s]%(message)s'logging.basicConfig(format=FORMAT)d = {'IP':'192.168.0.1','user':'BeginMan'}logging.warning('msg:%s','OK',extra=d)      #2013-09-23 15:58:31,619:[192.168.0.1--BeginMan]msg:OK

这里关键字参数传递不能与logging系统的关键字参数冲突。如'message'

3、下同

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

logging.warning(msg[,*args[, **kwargs]])

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

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

 4、logging.exception(msg[,*args])

用法同上上

try:    raise Exception,u'错误异常'except:    logging.exception('msg:%s','Error')# ERROR:root:msg:Error# Traceback (most recent call last):#   File "E:\project\py\src\log4.py", line 15, in <module>#     raise Exception,u'错误异常'# Exception: 错误异常

5、logging.log(level,msg[, *args[,**kwargs]])

参数用法同logging.debug()

import loggingFORMAT = '%(asctime)s:[%(IP)s--%(user)-8s]%(message)s'logging.basicConfig(format=FORMAT)d = {'IP':'192.168.0.1','user':'BeginMan'}logging.log(logging.DEBUG, 'Great:%s','Python',extra=d)

 6、logging.disable(level)

其作用是禁用所有日志当其级别在给定级及以下,当出现需要暂时截流日志输出下来整个应用程序,这个函数可以是有用的。

logging.disable(logging.WARNING)#提供一个覆盖所有优先于日志级别的级别logging.warn('msg')     #没有输出logging.critical('msg') #CRITICAL:msg

撤销的话，就使用logging.disable(levle)或logging.disable(logging.NOSET)

7、logging.addLevelName(lel,levelname)

增加自定义的logging level,并起名。

logging.addLevelName(88,'myLevelName')logging.log(88, '自定义设置级别')  #myLevelName:root:自定义设置级别

级别是整数，系统设置如下：

8、logging.getLevelName(lvl)

返回的文本表示的日志级别

logging.addLevelName(88,'myLevelName')logging.log(88, '自定义设置级别')             #myLevelName:root:自定义设置级别print logging.getLevelName(88)              #myLevelNameprint logging.getLevelName(logging.INFO)    #INFO

9、logging.basicConfig()

Does basic configuration for the logging system by creating a StreamHandler with a defaultFormatter and adding it to the root logger. The functionsdebug(),info(),warning(),error() andcritical() will callbasicConfig() automatically if no handlers are defined for the root logger.

This function does nothing if the root logger already has handlers configured for it.

见上节详解。

二、logging.handlers

接下来学习logging的控制器，有三类:StreamHandler、FileHandler、NullHandler。

StreamHandler类，在logging包中，发送日志输出流 如sys.stdout

 

The FileHandler class,发送日志输出到磁盘文件，它继承了StreamHandler输出功能。
    class logging.FileHandler(filename, mode='a', encoding=None, delay=False)
返回一个FileHandler类的实例，如果存在延时(delay=True),那么,文件打开推迟到第一次调用emit()。
 它有如下方法：close():关闭一个文件;emit(record):输出文件的记录。

import osimport loggingimport datetime'''FileHandler''''''FileHandler类，存在于logging包中，发送日志输出到磁盘文件中，它继承了StreamHandler输出功能。    class logging.FileHandler(filename, mode='a', encoding=None, delay=False)    返回一个FileHandler类的实例，如果存在延时(delay=True),那么,文件打开推迟到第一次调用emit()。    它有如下方法：close():关闭一个文件;emit(record):输出文件的记录。'''logger = logging.getLogger()    #生成一个日志对象hdlr = logging.FileHandler(os.path.join(os.getcwd(),'log.txt'),'w') #返回一个FileHandler对象formatter = logging.Formatter('%(asctime)s:%(name)s-->%(levelname)s %(message)s')hdlr.setFormatter(formatter)    #将格式器设置到处理器上logger.addHandler(hdlr)         #将处理器加到日志对象上logger.setLevel(logging.NOTSET) #设为NOTSET（值为0）,输出所有try:    lis = []    lis+'s'    print lisexcept  Exception,e:    logger.error('出现异常:%s',e)    #打开log.txt文件查看错误：# 2013-09-23 17:33:16,418:root-->ERROR 出现异常:can only concatenate list (not "str") to list    

三、使用fileConfig来使用logger

import loggingimport logging.configlogging.config.fileConfig("logging.conf")# create loggerlogger = logging.getLogger("simpleExample")# "application" codelogger.debug("debug message")logger.info("info message")logger.warn("warn message")logger.error("error message")logger.critical("critical message")

logging.conf文件如下：

[loggers]keys=root,simpleExample[handlers]keys=consoleHandler[formatters]keys=simpleFormatter[logger_root]level=DEBUGhandlers=consoleHandler[logger_simpleExample]level=DEBUGhandlers=consoleHandlerqualname=simpleExamplepropagate=0[handler_consoleHandler]class=StreamHandlerlevel=DEBUGformatter=simpleFormatterargs=(sys.stdout,)[formatter_simpleFormatter]format=%(asctime)s - %(name)s - %(levelname)s - %(message)sdatefmt=

运行结果：

2005-03-19 15:38:55,977 - simpleExample - DEBUG - debug message
2005-03-19 15:38:55,979 - simpleExample - INFO - info message
2005-03-19 15:38:56,054 - simpleExample - WARNING - warn message
2005-03-19 15:38:56,055 - simpleExample - ERROR - error message
2005-03-19 15:38:56,130 - simpleExample - CRITICAL - critical message

参考：http://www.cnblogs.com/itech/archive/2011/01/18/1934468.html

四、个人常用

#应用django项目Simport loggingimport datetimeLOGDIR = os.path.join(DIRNAME,'log')LOGFILE = datetime.datetime.now().strftime('%Y-%m-%d')+'.log'logging.basicConfig(level=logging.DEBUG,                    format='',                    datefmt='%a, %d %b %Y %H:%M:%S',                    filename = os.path.join(LOGDIR,LOGFILE),                    filemode='a'                    )fileLog = logging.FileHandler(os.path.join(LOGDIR,LOGFILE),'w')formatter = logging.Formatter('%(asctime)s %(name)s:%(levelname)s %(message)s')fileLog.setFormatter(formatter)logging.getLogger('demo').addHandler(fileLog)logging.getLogger('demo').setLevel(logging.DEBUG)logging.getLogger('demo').info(u'项目已启动：')