Flask+uWSGI 的 Logging 支持

 1def create_logger(app):
 2    """Creates a logger for the given application.  This logger works
 3    similar to a regular Python logger but changes the effective logging
 4    level based on the application's debug flag.  Furthermore this
 5    function also removes all attached handlers in case there was a
 6    logger with the log name before.
 7    """
 8    Logger = getLoggerClass()
 9
10    class DebugLogger(Logger):
11        def getEffectiveLevel(self):
12            if self.level == 0 and app.debug:
13                return DEBUG
14            return Logger.getEffectiveLevel(self)
15
16    class DebugHandler(StreamHandler):
17        def emit(self, record):
18            if app.debug and _should_log_for(app, 'debug'):
19                StreamHandler.emit(self, record)
20
21    class ProductionHandler(StreamHandler):
22        def emit(self, record):
23            if not app.debug and _should_log_for(app, 'production'):
24                StreamHandler.emit(self, record)
25
26    debug_handler = DebugHandler()
27    debug_handler.setLevel(DEBUG)
28    debug_handler.setFormatter(Formatter(DEBUG_LOG_FORMAT))
29
30    prod_handler = ProductionHandler(_proxy_stream)
31    prod_handler.setLevel(ERROR)
32    prod_handler.setFormatter(Formatter(PROD_LOG_FORMAT))
33
34    logger = getLogger(app.logger_name)
35    # just in case that was not a new logger, get rid of all the handlers
36    # already attached to it.
37    del logger.handlers[:]
38    logger.__class__ = DebugLogger
39    logger.addHandler(debug_handler)
40    logger.addHandler(prod_handler)
41
42    # Disable propagation by default
43    logger.propagate = False
44
45    return logger

 1def _set_logger(flaskapp):
 2    """
 3    设置 Flask app 的logger
 4    """
 5    # 删除 Flask 的默认 Handler
 6    del flaskapp.logger.handlers[:]
 7    if flaskapp.config.get('DEBUG'):
 8        # 在 DEBUG 模式下，使用 StreamHandler，并使用 DEBUG 级别，这样可以将所有的信息都输出到控制台
 9        hdr = logging.StreamHandler()
10        hdr.setLevel(logging.DEBUG)
11        flask.logger.setLevel(DEBUG)
12    else:
13        # 不使用 StreamHandler 的原因，是 uwsgi 可能会在标准输出中加入它自己的 Log，为了避免Log被弄乱，单独使用一个 FileHandler
14        hdr = logging.FileHandler(config.getdir('logs', 'app.log'), encoding='utf8')
15        hdr.setLevel(logging.INFO)
16        flask.logger.setLevel(INFO)
17
18    # 加入足够详细的信息
19    LOG_FORMAT = """
20[%(asctime)s] %(levelname)s in %(module)s.%(funcName)s [%(pathname)s:%(lineno)d]:
21%(message)s"""
22    hdr.setFormatter(logging.Formatter(LOG_FORMAT))
23
24    # 如果存在 sqlalchemy 的 Log 对象，也为其加入这个 Handler
25    for log in (flaskapp.logger, logging.getLogger('sqlalchemy')):
26        if log:
27            log.addHandler(hdr)

 1class MYFlask(Flask):
 2    def log_exception(self, exc_info):
 3        """...description omitted..."""
 4        self.logger.error(
 5            """
 6Request:   {method} {path}
 7IP:        {ip}
 8Agent:     {agent_platform} | {agent_browser} {agent_browser_version}
 9Raw Agent: {agent}
10            """.format(
11                method=request.method,
12                path=request.path,
13                ip=request.remote_addr,
14                agent_platform=request.user_agent.platform,
15                agent_browser=request.user_agent.browser,
16                agent_browser_version=request.user_agent.version,
17                agent=request.user_agent.string,
18            ), exc_info=exc_info
19        )

 1; 将写入 log 的工作委托给 master 进程
 2log-master = true
 3
 4; 单独开一个线程进行 log 写入工作，这样有更好的性能
 5threaded-log = true
 6
 7; 所有 log 都会写入这个文件
 8; 若希望所有 log 放在一起，设置了此选项后，不要设置 req-logger 和 logger 选项
 9; %d 代表 uwsgi.ini 所在文件夹（包含结尾的/）， %n 代表 uwsgi.ini 的主文件名
10; 魔术变量： http://uwsgi-docs-zh.readthedocs.io/zh_CN/latest/Configuration.html#magicvars
11daemonize = %dlogs/%n.log
12
13; 将 uWSGI 请求 log 写入单独的 log 文件，这样做可以让log更加分离，便于查错
14; 设置了此选项后，daemonize 设置的输出文件就得不到请求相关的日志输出了
15req-logger = file:%dlogs/req.log
16
17; 将 uWSGI stdout/stderr log 写入单独的 log 文件
18; 因为设定了 req-logger ，必须同时设定 logger ，此时 daemonize 不会有 stderr/stdout 之外的日志输出
19logger = file:%dlogs/%n.log

1log-format = [pid: %(pid)] %(addr) (%(user)) {%(vars) vars in %(pktsize) bytes} [%(ctime)] %(method) %(uri) => generated %(rsize) bytes in %(msecs) msecs (%(proto) %(status)) %(headers) headers in %(hsize) bytes (%(switches) switches on core %(core))