Azure Functions接入Application Insights日志间歇性丢失问题排查

可能的原因 #

• Application Insights采样规则不匹配：虽然已排除Request类型，但默认采样策略仍可能对Trace类型（即LogInformation记录的日志）进行随机丢弃。低流量场景下出现问题，大概率是采样率设置过低或采样逻辑触发了无差别丢弃。
• 日志未完成上传就被宿主回收：函数执行完成（或抛出异常）后，Application Insights日志客户端可能还在后台异步上传日志，若此时函数宿主被快速回收（如无服务器冷启动、资源释放），会直接导致部分日志丢失。尤其是抛出异常的分支，throw语句可能中断日志的异步提交流程。
• 日志类别匹配错误：host.json中配置的CardAlertsEventSubscriber必须和代码中ILogger的实际类别完全一致。如果注入的Logger类别是函数类全名（而非仅类名），会导致日志级别设置不生效，部分日志被过滤。
• 依赖包版本兼容性问题：当前使用的Microsoft.NET.Sdk.Functions4.4.0版本（2023年初发布）存在已知的日志丢失bug，尤其在异步函数场景下；同时Microsoft.Azure.WebJobs.Extensions.ServiceBus旧版本也可能与宿主日志系统存在冲突。
• CancellationToken提前终止日志操作：若HandleInvalidMessageAsync或ProcessEventAsync中提前触发了CancellationToken取消，会直接中断日志写入流程，导致日志未被记录。

需要检查的额外配置与操作 #

• 调整Application Insights采样策略：
  先关闭采样测试是否解决问题：

  "applicationInsights": {
    "samplingExcludedTypes": "Request,Trace",
    "samplingSettings": {
      "isEnabled": false
    }
  }
  

  若关闭后日志正常，再逐步调整采样率（如设置fixedRate: 1.0），确保Trace类型日志不被丢弃。
• 验证Logger类别一致性：
  在代码中临时添加一行输出Logger类别：

  _logger.LogInformation("Logger category: {Category}", _logger.GetType().GetProperty("CategoryName")?.GetValue(_logger));
  

  确认输出类别与host.json中CardAlertsEventSubscriber完全一致，不一致则修改host.json的logLevel键值。
• 升级依赖包版本：
  将Microsoft.NET.Sdk.Functions升级到最新稳定版，同步升级Microsoft.Azure.WebJobs.Extensions.ServiceBus到对应兼容版本，避免版本冲突导致的日志集成问题。
• 配置日志强制刷新：
  在host.json中添加日志刷新间隔，确保日志及时提交：

  "logging": {
    "applicationInsights": {
      "flushInterval": "00:00:05"
    }
  }
  

• 检查函数平台日志：
  在Azure门户函数应用的监控->日志中，切换到AppServiceConsoleLogs或FunctionAppLogs，查看是否有日志上传失败的错误（如Application Insights连接超时、权限不足）。
• 验证异常分支的日志记录：
  确认LogError方法正确使用_logger.LogError关联异常信息，示例：

  private void LogError(Exception ex, string sbMsg)
  {
      _logger.LogError(ex, "Error processing Service Bus message: {SbMsg}", sbMsg);
  }
  

  避免遗漏异常参数或未正确关联日志上下文。
• 检查CancellationToken的使用：
  确保HandleInvalidMessageAsync和ProcessEventAsync中没有提前调用cancellationToken.ThrowIfCancellationRequested()，防止日志未完成记录就终止函数。

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