Python Azure Function读取Blob时日志冗余问题及解决咨询

问题原因 #

• Azure SDK默认日志级别过高：Python版Azure Blob Storage SDK（azure-storage-blob）默认输出DEBUG级日志，包含所有Blob请求、响应的头部、body等详细信息，而Azure Function的日志框架会自动捕获第三方SDK的日志，导致冗余输出。
• 日志配置未过滤第三方组件：此前工作流可能通过配置限制了第三方日志级别，或使用的SDK版本默认日志更简洁；当前可能因SDK升级、配置重置等原因，第三方日志未被过滤。

Python适配的优化/规避方法 #

1. 代码内调整SDK日志级别 #

在函数初始化代码中，直接修改Azure相关模块的日志级别，仅保留WARNING及以上的关键日志：

import logging

# 限制azure-storage-blob的日志级别
logging.getLogger("azure.storage.blob").setLevel(logging.WARNING)
# 若存在azure.core模块的冗余日志，同步调整
logging.getLogger("azure.core").setLevel(logging.WARNING)

2. 通过配置文件全局过滤 #

无需修改代码，通过配置文件限制第三方SDK日志级别：

• 本地开发：在local.settings.json中添加配置：

{
  "Values": {
    "AzureFunctionsJobHost__logging__logLevel__azure.storage.blob": "Warning",
    "AzureFunctionsJobHost__logging__logLevel__azure.core": "Warning"
  }
}

• 云端部署：在Azure门户的函数应用「配置」-「应用程序设置」中添加上述键值对，设置后函数会自动重启生效。

3. 自定义日志过滤器（精细控制） #

如果需要只保留自己的自定义日志，可添加日志过滤器：

import logging

class CustomLogFilter(logging.Filter):
    def filter(self, record):
        # 仅保留自定义日志（替换为你的函数模块名或自定义logger前缀）
        return record.name.startswith("your_function_module_name")

# 为根日志处理器添加过滤器
root_logger = logging.getLogger()
for handler in root_logger.handlers:
    handler.addFilter(CustomLogFilter())

注意事项 #

• 若使用旧版azure-storage-blob，需确认对应的logger名称（可从日志输出的logger字段查看），调整时替换为正确的名称。
• 本地修改配置后需重启函数应用，配置才能生效。

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