Azure Function日志归档至存储账户：如何自定义JSON日志结构

可行方案 #

1. 直接通过Log4j2的Azure Blob Appender写入自定义日志 #

绕过Azure的诊断管道，让应用直接将自定义JSON日志写入存储账户的Blob，日志格式会和本地完全一致。

• 配置Log4j2的Azure Blob Appender：在log4j2.xml（或对应配置文件）中添加以下配置，替换为你的存储账户信息和自定义JSON模板：

  <Appenders>
      <!-- 使用本地的JsonTemplateLayout保持格式一致 -->
      <AzureBlob name="AzureBlobAppender" 
                 accountName="your-storage-account-name" 
                 accountKey="your-storage-account-key" 
                 containerName="your-log-container">
          <JsonTemplateLayout eventTemplateUri="classpath:your-custom-template.json"/>
      </AzureBlob>
  </Appenders>
  
  <Loggers>
      <Root level="INFO">
          <AppenderRef ref="AzureBlobAppender"/>
      </Root>
      <!-- 保留其他必要的Logger配置 -->
  </Loggers>
  

• 依赖准备：添加对应的Maven/Gradle依赖，示例：

  <!-- Maven -->
  <dependency>
      <groupId>org.apache.logging.log4j</groupId>
      <artifactId>log4j-azure</artifactId>
      <version>2.20.0</version>
  </dependency>
  

• 安全优化：推荐使用托管标识代替账户密钥，给Function App分配存储账户的Blob数据参与者权限即可，避免硬编码密钥。

2. 开启诊断设置的原始日志格式（若支持） #

部分Azure Functions运行时支持在诊断设置中开启“原始日志格式”，让Azure直接转发应用输出的原始JSON日志，不添加平台包裹结构：

• 进入Azure门户的Function App -> 诊断设置 -> 编辑现有诊断设置
• 找到FunctionAppLogs日志类别，勾选“原始格式”选项（若存在）
• 保存设置后，新生成的日志会以应用输出的原始JSON格式存储到Blob中

3. 自定义日志提取（复杂场景备选） #

如果上述方案无法满足需求，可编写自定义代码提取原始日志：

• 在Function中添加日志拦截逻辑，捕获原始日志内容
• 使用Azure Storage SDK直接将原始JSON写入Blob存储
• 该方案适合需要额外处理日志的场景，但开发成本较高

注意事项 #

• 确保本地和Azure环境的Log4j2配置完全一致，尤其是JsonTemplate模板文件，避免格式差异
• Splunk索引时，需配置对应Blob数据源的JSON解析规则，确保能正确识别自定义日志字段
• 使用托管标识时，确认Function App的身份已被授予存储账户的正确权限

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