flask的日志记录需要用到python标准库logging的支持。

最简单示例:

from flask import Flask
import logging

app = Flask(__name__)


@app.route('/')
def root():
    app.logger.info('info log')
    app.logger.warning('warning log')
    return 'hello'

if __name__ == '__main__':
    app.debug = True
    handler = logging.FileHandler('flask.log')
    app.logger.addHandler(handler)
    app.run()

记录到flask.log中内容为:

info log
warning log

handler = logging.FileHandler('flask.log')

即创建一个log handler,比较常用的有FileHandlerRotatingHandler,其中FileHandler函数原型为

class logging.FileHandler(filename,mode='a',encoding=None,delay=False)
app.logger.addHandler(handler)

即将此handler加入到此app中

app.logger.info('info log')

即以INFO级别将'info log'写入到日志中。

logging的级别主要有NOTSETDEBUGINFOWARNINGERRORCRITICAL,挺容易理解的。


高级一些的示例:

from flask import Flask
import logging

app = Flask(__name__)


@app.route('/')
def root():
    app.logger.info('info log')
    app.logger.warning('warning log')
    return 'hello'

if __name__ == '__main__':
    app.debug = True
    handler = logging.FileHandler('flask.log', encoding='UTF-8')
    handler.setLevel(logging.DEBUG)
    logging_format = logging.Formatter(
        '%(asctime)s - %(levelname)s - %(filename)s - %(funcName)s - %(lineno)s - %(message)s')
    handler.setFormatter(logging_format)
    app.logger.addHandler(handler)
    app.run()

记录到flask.log中内容为:

2015-08-29 10:12:48,004 - INFO - test.py - root - 9 - info log
2015-08-29 10:12:48,004 - WARNING - test.py - root - 10 - warning log
handler.setLevel(logging.DEBUG)

即设置日志记录最低级别为DEBUG,低于DEBUG级别的日志记录会被忽略,不设置setLevel()则默认为NOTSET级别。

logging_format = logging.Formatter(
    '%(asctime)s - %(levelname)s - %(filename)s - %(funcName)s - %(lineno)s - %(message)s')
handler.setFormatter(logging_format)

这两句用来控制日志记录格式,效果如上述记录内容;在Python参考文档中有更详细的说明,这里简单介绍一下:

  • %(asctime)s 即日志记录时间,精确到毫秒
  • %(levelname)s 即此条日志级别
  • %(filename)s 即触发日志记录的python文件名
  • %(funcName)s 即触发日志记录的函数名
  • %(lineno)s 即触发日志记录代码的行号
  • %(message)s 这项即调用如app.logger.info('info log')中的参数,即message

注意:此示例来自Python 3.4.3 和Flask 0.10.1