如何使用 Python 的日志记录模块？

从 Python 2.3 开始支持 Python 标准库中的日志系统。只需导入日志即可使用此模块。如果你想开发一个日志系统，既要将日志输出到控制台，又要写入日志文件，请参考以下内容。

代码如下:

import logging
# 创建一个logger
logger = logging.getLogger('mylogger')
logger.setLevel(logging.DEBUG)
# 创建一个handler，用于写入日志文件
fh = logging.FileHandler('test.log')
fh.setLevel(logging.DEBUG)
# 再创建一个handler，用于输出到控制台
ch = logging.StreamHandler()
ch.setLevel(logging.DEBUG)
# 定义handler的输出格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
fh.setFormatter(formatter)
ch.setFormatter(formatter)
# 给logger添加handler
logger.addHandler(fh)
logger.addHandler(ch)
# 记录一条日志
logger.info('foorbar')

结合上面的例子，我们说下几个最常使用的API：

　　logging.getLogger([name])

如果未指定名称，则返回记录器实例或根记录器。只要名称相同，则返回的logger实例是相同的且只有一个，即名称和logger实例是一一对应的。这意味着不需要跨模块传递记录器实例。只要知道名称，就可以获得相同的记录器实例。

　　Logger.setLevel(lvl)

设置logger的level， level有以下几个级别：

级别高低顺序：NOTSET < DEBUG < INFO < WARNING < ERROR < CRITICAL

如果 looger 的级别设置为 INFO，那么小于 INFO 级别的日志不会输出，大于等于 INFO 级别的日志会输出。

代码如下:

logger.debug("foobar") # 不输出 
logger.info("foobar") # 输出 
logger.warning("foobar") # 输出 
logger.error("foobar") # 输出 
logger.critical("foobar") # 输出

Logger.addHandler(hdlr)

日志内容可以通过handler对象写入不同的地方。比如一个简单的 StreamHandler 就是把日志写到类似文件的地方。 Python 提供了十几个实用的处理程序，比较常用的有：

StreamHandler: 输出到控制台

FileHandler: 输出到文件

BaseRotatingHandler 可以按时间写入不同的日志。例如，日志在不同日期的末尾写入文件文件。

SocketHandler 用TCP网络连接写LOG

DatagramHandler 用UDP网络连接写LOG

SMTPHandler 把LOG写成EMAIL邮寄出去

logging.basicConfig([**kwargs])* 该函数用于配置根logger，为根logger创建StreamHandler，设置默认格式。 * 这些函数：logging.debug(), logging.info(), logging.warning(), logging.error(), logging.critical() 如果root logger在调用时没有任何handler，它会自动调用basicConfig添加一个处理程序 handler* 如果根记录器已经有一个处理程序，这个函数什么也不做。使用 basicConfig 配置根记录器的输出格式和级别：

代码如下:

import logging
logging.basicConfig(format='%(levelname)s:%(message)s', level=logging.DEBUG)
logging.debug('This message should appear on the console')

ogger 对象直接提供了日志接口。 formatter 描述了日志的格式。处理程序将日志写入不同的位置。可以将日志保存为本地文件，也可以每小时写入一个日志文件，也可以通过套接字将日志发送到其他机器。

从最简单的格式化程序对象。格式化程序指定每条日志记录的头部信息，即可以指定日志记录的时间格式、进程号、文件名、函数名等信息。你可以使用此方法创建格式化程序对象：

代码如下:

logging.Formatter.__init__( fmt=None, datefmt=None)

fmt 参数指定进程 ID、文件名和函数名等信息的存在和格式。 datefmt 是日期和时间格式。默认日期格式精确到微秒，例如 '2003-07-08 16:49:45,896'。 fmt中可以指定多个字段，每个字段的格式为“%()s”。例如，如果要打印时间、日志级别和日志信息，可以使用以下格式：

代码如下:

'%(asctime)s - %(levelname)s - %(message)s'

记录日志时，需要定义日志的级别。级别越高，日志越详细。我们可以使用字典来设置不同的日志信息对应不同的级别：

代码如下:

#用字典保存日志级别

format_dict = {
1 : logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),
2 : logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),
3 : logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),
4 : logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'),
5 : logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
}

将本文开始的代码封装在一个类中

代码如下:

#开发一个日志系统， 既要把日志输出到控制台， 还要写入日志文件 
class Logger():
def __init__(self, logname, loglevel, logger):
'''
指定保存日志的文件路径，日志级别，以及调用文件
将日志存入到指定的文件中
'''
# 创建一个logger
self.logger = logging.getLogger(logger)
self.logger.setLevel(logging.DEBUG)
# 创建一个handler，用于写入日志文件
fh = logging.FileHandler(logname)
fh.setLevel(logging.DEBUG)
# 再创建一个handler，用于输出到控制台
ch = logging.StreamHandler()
ch.setLevel(logging.DEBUG)
# 定义handler的输出格式
#formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
formatter = format_dict[int(loglevel)]
fh.setFormatter(formatter)
ch.setFormatter(formatter)
# 给logger添加handler
self.logger.addHandler(fh)
self.logger.addHandler(ch)
def getlog(self):
return self.logger

然后按如下方式调用，就是一个简单的日志系统

代码如下:

logger = Logger(logname='log.txt', loglevel=1, logger="fox").getlog()