flask日志

日志功能的实现

python 自身提供了一个用于记录日志的标准库模块：logging。

logging 模块

• logging 模块定义的函数和类为应用程序和库的开发实现了一个灵活的事件日志系统
• logging 模块是 python 的一个标准库模块，由标准库模块提供日志记录 api 的关键好处是所有 python 模块都可以使用这个日志记录功能。

logging 模块的日志级别

• logging模块默认定义了以下几个日志等级，它允许开发人员自定义其他日志级别，但是这是不被推荐的，尤其是在开发供别人使用的库时，因为这会导致日志级别的混乱。
  • debug 最详细的日志信息，典型应用场景是 问题诊断
  • info 信息详细程度仅次于debug，通常只记录关键节点信息，用于确认一切都是按照我们预期的那样进行工作
  • warning 当某些不期望的事情发生时记录的信息（如，磁盘可用空间较低），但是此时应用程序还是正常运行的
  • error 由于一个更严重的问题导致某些功能不能正常运行时记录的信息
  • fatal/critical 整个系统即将/完全崩溃

• 开发应用程序或部署开发环境时，可以使用 debug 或 info 级别的日志获取尽可能详细的日志信息来进行开发或部署调试；
• 应用上线或部署生产环境时，应该使用 warning 或 error 或 critical 级别的日志来降低机器的i/o压力和提高获取错误日志信息的效率。

日志级别的指定通常都是在应用程序的配置文件中进行指定的。

logging 模块的使用方式介绍

• loggers 提供应用程序代码直接使用的接口
• handlers 用于将日志记录发送到指定的目的位置
• filters 提供更细粒度的日志过滤功能，用于决定哪些日志记录将会被输出（其它的日志记录将会被忽略）
• formatters 用于控制日志信息的最终输出格式

# 设置日志的记录等级
logging.basicconfig(level=logging.debug) # 调试debug级
# 创建日志记录器，指明日志保存的路径、每个日志文件的最大大小、保存的日志文件个数上限
file_log_handler = rotatingfilehandler("logs/log", maxbytes=1024*1024*100, backupcount=10)
# 创建日志记录的格式 日志等级 输入日志信息的文件名 行数 日志信息
formatter = logging.formatter('%(levelname)s %(filename)s:%(lineno)d %(message)s')
# 为刚创建的日志记录器设置日志记录格式
file_log_handler.setformatter(formatter)
# 为全局的日志工具对象（flask app使用的）添加日志记录器
logging.getlogger().addhandler(file_log_handler)

使用logging提供的模块级别的函数记录日志

最简单的日志输出

• 先来试着分别输出一条不同日志级别的日志记录：

import logging

logging.debug("this is a debug log.")
logging.info("this is a info log.")
logging.warning("this is a warning log.")
logging.error("this is a error log.")
logging.critical("this is a critical log.")

• 也可以这样写：

logging.log(logging.debug, "this is a debug log.")
logging.log(logging.info, "this is a info log.")
logging.log(logging.warning, "this is a warning log.")
logging.log(logging.error, "this is a error log.")
logging.log(logging.critical, "this is a critical log.")

修改配置改变输出内容

logging.basicconfig(level=logging.debug)

切记：设置 configurations 中的 working directory 为当前项目

集成日志到当前项目

• 在 config.py 文件中在不同的环境的配置下添加日志级别

class config(object):
    ...

    # 默认日志等级
    log_level = logging.debug


class productionconfig(config):
    """生产模式下的配置"""
    log_level = logging.error

• 在 info 目录下的 init.py 文件中添加日志配置的相关方法

def setup_log(config_name):
    """配置日志"""

    # 设置日志的记录等级
    logging.basicconfig(level=config[config_name].log_level)  # 调试debug级
    # 创建日志记录器，指明日志保存的路径、每个日志文件的最大大小、保存的日志文件个数上限
    file_log_handler = rotatingfilehandler("logs/log", maxbytes=1024 * 1024 * 100, backupcount=10)
    # 创建日志记录的格式 日志等级 输入日志信息的文件名 行数 日志信息
    formatter = logging.formatter('%(levelname)s %(filename)s:%(lineno)d %(message)s')
    # 为刚创建的日志记录器设置日志记录格式
    file_log_handler.setformatter(formatter)
    # 为全局的日志工具对象（flask app使用的）添加日志记录器
    logging.getlogger().addhandler(file_log_handler)

• 在 create_app 方法中调用上一步创建的方法，并传入 config_name

def create_app(config_name):
    ...

    # 配置项目日志
    setup_log(config_name)
    app = flask(__name__)
    ...

• 在项目根目录下创建日志目录文件夹 logs，如下：
• 

• 运行项目，当前项目日志已输出到 logs 的目录下自动创建的 log 文件中

  • 在 logs 文件夹下创建 .gitkeep 文件，以便能将 logs 文件夹添加到远程仓库，并在 .gitignore 文件中添加忽略提交生成的日志文件

  logs/log*
  

  在 flask框架 中，其自己对 python 的 logging 进行了封装，在 flask 应用程序中，可以以如下方式进行输出 log:

  current_app.logger.debug('debug')
  current_app.logger.error('error')

• 当前应用程序的 logger 会根据应用程序的调试状态去调整日志级别，如下图：