python - 如何在 Python 中配置日志记录

Question

我是 Python 新手，刚刚开始一个项目。我习惯在 Java 中使用 log4j，我想在 Python 中记录所有模块和类，就像在 Java 中一样。

在 Java 中，我在 src 文件夹中有一个名为 log4j.properties 的日志配置文件，如下所示:

log4j.rootLogger=DEBUG, Console, fileout

log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d{dd/MM/yyyy HH:mm:ss} %5p [%t] (%F:%L) - %m%n

log4j.appender.fileout=org.apache.log4j.RollingFileAppender
log4j.appender.fileout.File=servidor.log
log4j.appender.fileout.layout=org.apache.log4j.PatternLayout
log4j.appender.fileout.layout.ConversionPattern=%d{dd/MM/yyyy HH:mm:ss} (%F:%L) %p %t %c - %m%n

它记录到控制台和文件。

在我的类中，我只需要导入 log4j 并添加一个静态属性来恢复加载配置的 log4j 记录器，然后所有类都将登录控制台和文件.配置文件按名称自动加载。例如:

import org.apache.log4j.Logger;

public class Main {
    public static Logger logger = Logger.getLogger(Main.class);
    public static void main(String[] args) {
        logger.info("Hello");
    }
}

现在我在 Python 中设置日志记录时遇到问题，我已阅读文档，但找不到在许多模块/类中使用它的方法。如何以一种简单的方式设置 Python 日志记录，以便在每个模块/类中无需大量代码来记录我的模块和类？是否可以重现我在 Python 中编写的相同代码？

Answer 1

实际上在 Python 中它看起来非常相似。有不同的方法可以做到这一点。我通常创建一个非常简单的记录器类:

import os
import logging 
import settings   # alternativly from whereever import settings  

class Logger(object):

    def __init__(self, name):
        name = name.replace('.log','')
        logger = logging.getLogger('log_namespace.%s' % name)    # log_namespace can be replaced with your namespace 
        logger.setLevel(logging.DEBUG)
        if not logger.handlers:
            file_name = os.path.join(settings.LOGGING_DIR, '%s.log' % name)    # usually I keep the LOGGING_DIR defined in some global settings file
            handler = logging.FileHandler(file_name)
            formatter = logging.Formatter('%(asctime)s %(levelname)s:%(name)s %(message)s')
            handler.setFormatter(formatter)
            handler.setLevel(logging.DEBUG)
            logger.addHandler(handler)
        self._logger = logger

    def get(self):
        return self._logger

然后，如果我想在类或模块中记录某些内容，我只需导入记录器并创建一个实例。传递类名将为每个类创建一个文件。然后，记录器可以通过调试、信息、错误等将消息记录到其文件中:

from module_where_logger_is_defined import Logger

class MyCustomClass(object):

    def __init__(self):
        self.logger = Logger(self.__class__.__name__).get()   # accessing the "private" variables for each class

    def do_something():
        ...
        self.logger.info('Hello')

    def raise_error():
        ...
        self.logger.error('some error message')

更新答案

多年来，我改变了我使用 Python 日志记录的方式。主要基于良好实践，我在应用程序启动期间首先加载的任何模块中配置整个应用程序的日志记录，然后在每个文件中使用单独的记录器。示例:

# app.py (runs when application starts)

import logging
import os.path

def main():
    logging_config = {
        'version': 1,
        'disable_existing_loggers': False,
        'formatters': {
            'standard': {
                'format': '%(asctime)s [%(levelname)s] %(name)s: %(message)s'
            },
        },
        'handlers': {
            'default_handler': {
                'class': 'logging.FileHandler',
                'level': 'DEBUG',
                'formatter': 'standard',
                'filename': os.path.join('logs', 'application.log'),
                'encoding': 'utf8'
            },
        },
        'loggers': {
            '': {
                'handlers': ['default_handler'],
                'level': 'DEBUG',
                'propagate': False
            }
        }
    }
    logging.config.dictConfig(logging_config)
    # start application ...

if __name__ == '__main__':
    main()

# submodule.py (any application module used later in the application)

import logging

# define top level module logger
logger = logging.getLogger(__name__)

def do_something():
    # application code ...
    logger.info('Something happended')
    # more code ...
    try:
        # something which might break
    except SomeError:
        logger.exception('Something broke')
        # handle exception
    # more code ...

以上是推荐的方法。每个模块都定义了自己的记录器，并且可以根据 __name__ 属性轻松识别在您检查日志时哪个模块记录了哪个消息。这从我的原始答案中删除了样板文件，而是使用 Python 标准库中的 logging.config 模块。