如何在structlog中根据日志级别适配上下文信息？

在日志记录中，一个常见需求是根据日志级别输出不同详细程度的信息——比如仅当日志级别为DEBUG或更低时，才在日志中包含大体积的冗余负载（noisy payload）。你已经尝试了三种方案：

import random
import logging
import structlog

log_level = logging.INFO
wrapper_class = structlog.make_filtering_bound_logger(log_level)
structlog.configure(wrapper_class=wrapper_class)
logger = structlog.get_logger()

noisy = random.randbytes(1024)

# 方案1
logger.info("Approach 1")
logger.debug("Approach 1", noisy=noisy)

# 方案2
if log_level <= logging.DEBUG:
    logger.debug("Approach 2", noisy=noisy)
else:
    logger.info("Approach 2")

# 方案3
log = logger.bind(noisy=noisy) if log_level <= logging.DEBUG else logger.bind()
log.info("Approach 3")

现有方案的问题 #

• 方案1：DEBUG级别下会生成两条日志，同一事件易被误判为独立事件，增加日志分析的复杂度。
• 方案2：切换到DEBUG级别后，原有的INFO日志消失，不利于跟踪同一事件在不同级别下的上下文一致性。
• 方案3：能在DEBUG级别下为INFO日志添加冗余负载，是相对合理的方案，但仍有优化空间。

实际代码库的最佳实践及structlog专属优化 #

在生产代码中，更推荐分离业务逻辑与日志调整逻辑，避免在业务代码中嵌入大量日志级别判断，同时利用structlog的扩展能力实现动态日志内容控制：

1. 自定义处理器动态添加字段

structlog的核心优势在于处理器链，可以通过自定义处理器，在日志输出前根据级别动态添加或移除字段，无需在业务代码中做条件判断：

import random
import logging
import structlog

def dynamic_noisy_payload_processor(_, __, event_dict):
    # 仅当日志级别为DEBUG时添加冗余负载，且延迟生成避免资源浪费
    if event_dict["level"] == "debug":
        event_dict["noisy"] = random.randbytes(1024)
    return event_dict

# 配置structlog
log_level = logging.INFO
structlog.configure(
    wrapper_class=structlog.make_filtering_bound_logger(log_level),
    processors=[
        structlog.processors.TimeStamper(fmt="%Y-%m-%d %H:%M:%S"),
        dynamic_noisy_payload_processor,  # 插入自定义处理器
        structlog.processors.LogfmtRenderer()  # 保持你原有的渲染格式
    ]
)

logger = structlog.get_logger()

# 业务代码中直接打日志，无需关心级别判断
logger.info("Optimized Approach")
logger.debug("Debug-specific Event")

2. 延迟生成冗余负载

如果冗余负载的生成需要消耗较多资源（比如读取大文件、序列化复杂对象），一定要延迟生成——像上面的处理器那样，只在确定需要输出DEBUG日志时才生成，避免在INFO级别下做无用功。

3. 保持事件的一致性

无论日志级别如何，同一业务事件应该对应同一条日志（仅详细度不同），避免像方案1那样拆分两条日志。这样在日志排查时，能通过事件描述快速关联不同级别下的上下文。

总结 #

方案3是可行的临时方案，但利用structlog的处理器实现动态字段控制是更优雅的生产级方案——它能让业务代码更简洁，同时统一日志调整逻辑，便于后续维护。

内容的提问来源于stack exchange，提问作者Vincent