本文作者：郭泽源，中南财经政法大学金融学院

本文编辑：胡艺粼

技术总编：孙一博

在日常做项目时，我们不可能直接将所有的信息都输出到控制台中，然而我们可以将这些信息记录到日志文件中，这样不仅方便我们查看程序运行时的情况，也可以在项目出现故障时根据程序运行时产生的日志快速定位问题出现的位置。在python中有很多可以记录日志的第三方库，而今天给大家介绍的是python内置的标准库模块——logging模块；logging模块简单而又强大，它可以记录python中包括第三方模块中的所有模块。

Python 标准库 logging 用作记录日志，默认分为六种日志级别（括号为级别对应的数值），NOTSET（0）、DEBUG（10）、INFO（20）、WARNING（30）、ERROR（40）、CRITICAL（50）。logging默认级别是WARNING, 我们自定义日志级别时注意不要和默认的日志级别数值相同，logging 执行时输出大于等于设置的日志级别的日志信息，如设置日志级别是 INFO，则 INFO、WARNING、ERROR、CRITICAL 级别的日志都会输出。详见下表：

logging 使用非常简单，使用 basicConfig() 方法就能满足基本的使用需要，如果方法没有传入参数，会根据默认的配置创建Logger 对象，默认的日志级别被设置为 WARNING。

示例代码如下：

输出结果如下：

④format：指定日志的格式字符串。例如，如果需要输出日志级别字段，则可以设置%(levelname)s，输出文字形式的日志级别。下表为logging模块支持的常用格式字符串字段：

上面的基本使用可以让我们快速上手 logging 模块，但一般并不能满足实际使用，我们还需要自定义 Logger。获取 Logger 对象的方法为 getLogger()，我们可以创造多个 Logger 对象，但是真正输出日志的是root Logger 对象。每个 Logger 对象都可以设置一个名字，如果设置logger = logging.getLogger(__name__)，__name__ 是 Python 中的一个特殊内置变量，他代表当前模块的名称（默认为__main__）。则 Logger 对象的 name 为建议使用使用以点号作为分隔符的命名空间等级制度。Logger 对象可以设置多个 Handler 对象和 Filter 对象，Handler 对象又可以设置 Formatter 对象。Formatter 对象用来设置具体的输出格式，常用变量格式如上面的表2所示。

示例代码如下：

通常来讲，在一个logger对象中，我们可以创建多个handler，对每一个handler设置不同的输出配置，如日志级别、输出位置等。同时，我们还可以对每个handler设置不同的过滤条件和输出格式，这样，就可以实现多样化的日志输出需求，这也是四大组件的基本工作流程。

• logger类

logger用于提供日志接口，常用于配置和发送日志消息。我们一般使用logging.getLogger(name)方法来获得一个logger对象。其中，可选参数name指定日志器名称，默认为“root”。常用方法包括：

①logger.setLevel()：设置日志器处理日志信息的最低级别

②logger.addHandler()：为该logger对象添加一个handler对象

③logger.removeHandler()：为该logger对象添加移除一个handler对象

④logger.addFilter()：为该logger对象添加一个filter对象

⑤logger.removeFilter()：为该logger对象移除一个filter对象

⑥logger.debug(),logger.info(),logger.warning(),logger.error(),logger.critical()：创建一个对应等级的日志记录

• handler类

handler对象用于将指定的日志信息发送到指定的位置。一个logger对象可以添加多个handler，每个handler又可以定义不同日志级别，以实现日志分级过滤显示。通过handler，我们可以将日志同时输出到多个位置。常用的方法包括：

①handler.setLevel()：设置handler处理的日志信息最低级别

②handler.setFormatter()：为handler设置一个格式器对象

③handler.addFilter()：为handler添加一个过滤器对象

④handler.removeFilter()：为handler删除一个过滤器对象

⑤logging.StreamHandler()：将日志信息发送到Stream

⑥logging.FileHandler()：将日志消息发送到磁盘文件

• filter类

filter是一个过滤器，可以实现比logger和handle更细致灵活的过滤功能。

• formatter类

formatter对象用来输出格式化字符串，构造方法如下：

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

其中：

fmt：指定信息的格式化字符串，如不设定则使用信息的原始字符串

datefmt：指定日期的格式化字符串，如不设定则使用默认格式"%Y-%m-%d %H:%M:%S"

至此，python中的logging就全部介绍完毕了，Python logging 库设计的真的非常灵活，如果有特殊的需要还可以在这个基础的 logging 库上进行改进，创建新的 Handler 类解决实际开发中的问题，快去试一试吧！

重磅福利！为了更好地服务各位同学的研究，爬虫俱乐部将在小鹅通平台上持续提供金融研究所需要的各类指标，包括上市公司十大股东、股价崩盘、投资效率、融资约束、企业避税、分析师跟踪、净资产收益率、资产回报率、国际四大审计、托宾Q值、第一大股东持股比例、账面市值比、沪深A股上市公司研究常用控制变量等一系列深加工数据，基于各交易所信息披露的数据利用Stata在实现数据实时更新的同时还将不断上线更多的数据指标。我们以最前沿的数据处理技术、最好的服务质量、最大的诚意望能助力大家的研究工作！相关数据链接，请大家访问：(https://appbqiqpzi66527.h5.xiaoeknow.com/homepage/10)或扫描二维码：