如何使用Python处理日志？logging模块配置

import logging
import os

# 1. 基础配置：快速启动，但全局生效，不推荐在复杂应用中使用
# logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
# logging.info("这是一个通过basicConfig记录的信息。")

# 2. 更推荐的方式：获取Logger实例，并配置Handler和Formatter

# 创建一个Logger实例
# 通常推荐使用 __name__ 作为logger的名字，这样可以根据模块名区分日志来源
logger = logging.getLogger(__name__) 
logger.setLevel(logging.DEBUG) # 设置Logger的最低处理级别，低于此级别的日志不会被处理

# 创建一个FileHandler，用于将日志写入文件
log_file_path = 'my_application.log'
# 确保日志文件目录存在，这是个小细节，但实际开发中经常被忽略
os.makedirs(os.path.dirname(log_file_path) or '.', exist_ok=True) 
file_handler = logging.FileHandler(log_file_path, encoding='utf-8')
file_handler.setLevel(logging.INFO) # 设置FileHandler的最低处理级别

# 创建一个StreamHandler，用于将日志输出到控制台
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.DEBUG) # 设置StreamHandler的最低处理级别

# 创建一个Formatter，定义日志的输出格式
# %(asctime)s: 日志时间
# %(name)s: Logger的名称
# %(levelname)s: 日志级别
# %(message)s: 日志内容
# %(filename)s: 产生日志的文件名
# %(lineno)d: 产生日志的代码行号
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(filename)s:%(lineno)d - %(message)s')

# 为Handler设置Formatter
file_handler.setFormatter(formatter)
console_handler.setFormatter(formatter)

# 将Handler添加到Logger
# 避免重复添加Handler，这在多次调用getLogger时可能发生
if not logger.handlers:
    logger.addHandler(file_handler)
    logger.addHandler(console_handler)

# 记录不同级别的日志
logger.debug("这是一条调试信息。")
logger.info("这是一条普通信息。")
logger.warning("这是一条警告信息。")
logger.error("这是一条错误信息。")
logger.critical("这是一条严重错误信息。")

try:
    result = 1 / 0
except ZeroDivisionError:
    logger.exception("发生了一个除零错误！") # exception() 会自动记录堆栈信息

# module_a.py
import logging
logger_a = logging.getLogger('my_app.module_a') # 获取特定名称的logger
logger_a.setLevel(logging.DEBUG)
# ... 为logger_a添加其专属的handler和formatter

# module_b.py
import logging
logger_b = logging.getLogger('my_app.module_b')
logger_b.setLevel(logging.INFO)
# ... 为logger_b添加其专属的handler和formatter

import logging.config

LOGGING_CONFIG = {
    'version': 1,
    'disable_existing_loggers': False, # 关键：不禁用已存在的logger，允许在代码中获取并使用
    'formatters': {
        'standard': {
            'format': '%(asctime)s - %(name)s - %(levelname)s - %(filename)s:%(lineno)d - %(message)s'
        },
        'json_formatter': {
            'format': '{"time": "%(asctime)s", "name": "%(name)s", "level": "%(levelname)s", "message": "%(message)s"}',
            # 实际生产中会用更专业的json formatter库
        }
    },
    'handlers': {
        'console': {
            'level': 'DEBUG',
            'class': 'logging.StreamHandler',
            'formatter': 'standard'
        },
        'file_info': {
            'level': 'INFO',
            'class': 'logging.handlers.TimedRotatingFileHandler',
            'filename': 'logs/app_info.log',
            'when': 'midnight',
            'interval': 1,
            'backupCount': 7,
            'encoding': 'utf-8',
            'formatter': 'standard'
        },
        'file_error': {
            'level': 'ERROR',
            'class': 'logging.handlers.RotatingFileHandler',
            'filename': 'logs/app_error.log',
            'maxBytes': 10 * 1024 * 1024,
            'backupCount': 5,
            'encoding': 'utf-8',
            'formatter': 'json_formatter' # 错误日志可能希望是JSON格式
        }
    },
    'loggers': {
        '': {  # 根logger
            'handlers': ['console', 'file_info'],
            'level': 'INFO',
            'propagate': False # 阻止日志向上级logger传递
        },
        'my_app.module_a': {
            'handlers': ['console', 'file_info', 'file_error'],
            'level': 'DEBUG',
            'propagate': False
        },
        'my_app.module_b': {
            'handlers': ['file_info'],
            'level': 'WARNING',
            'propagate': False
        }
    },
    'root': { # 根logger的另一种配置方式，与''等价
        'handlers': ['console', 'file_info'],
        'level': 'INFO'
    }
}

try:
    os.makedirs('logs', exist_ok=True) # 确保日志目录存在
    logging.config.dictConfig(LOGGING_CONFIG)
except Exception as e:
    print(f"Error loading logging configuration: {e}") # 紧急打印错误

logger_main = logging.getLogger(__name__)
logger_module_a = logging.getLogger('my_app.module_a')
logger_module_b = logging.getLogger('my_app.module_b')

logger_main.info("主应用启动信息")
logger_module_a.debug("模块A的调试信息")
logger_module_a.error("模块A的错误信息")
logger_module_b.warning("模块B的警告信息")

try:
    value = int("abc")
except ValueError:
    logger.exception("类型转换错误发生！") # 会自动打印完整的调用栈

import json

class JsonFormatter(logging.Formatter):
    def format(self, record):
        log_record = {
            "timestamp": self.formatTime(record, self.datefmt),
            "level": record.levelname,
            "logger_name": record.name,
            "message": record.getMessage(),
            "file": record.filename,
            "line": record.lineno
        }
        if record.exc_info:
            log_record["exception"] = self.formatException(record.exc_info)
        return json.dumps(log_record, ensure_ascii=False)

# ... (在logging.config.dictConfig或手动配置时，使用这个JsonFormatter)
# formatter = JsonFormatter()