Azure Function App自定义追踪消息写入Application Insights失败排查

以下是可能导致你无法在Application Insights中看到自定义追踪消息的常见问题及解决方法：

• TelemetryClient初始化方式错误
  你直接手动实例化TelemetryClient的方式不符合Azure Function的最佳实践，手动创建的实例无法自动加载应用的Application Insights配置（如连接字符串或 instrumentation key），导致追踪数据无法正常上报。
  正确做法是通过依赖注入获取TelemetryClient实例：

  public class YourFunction
  {
      private readonly TelemetryClient _telemetryClient;
  
      // 构造函数注入TelemetryClient
      public YourFunction(TelemetryClient telemetryClient)
      {
          _telemetryClient = telemetryClient;
      }
  
      [FunctionName("YourFunctionName")]
      public void Run([YourTriggerType] TriggerInput input)
      {
          _telemetryClient.TrackTrace($"Alert Button Pressed by Device -> {CloudObject.A}", SeverityLevel.Warning, new Dictionary<string, string> { { "IoT Object", IOTMESSAGE } });
      }
  }
  

• Application Insights配置未正确设置

  • 检查Function App的配置项中是否添加了APPLICATIONINSIGHTS_CONNECTION_STRING或APPINSIGHTS_INSTRUMENTATIONKEY，确保值与你的Application Insights资源一致。
  • 本地开发时，需在local.settings.json中添加上述配置项，否则本地运行的函数无法将数据上报到AI。

• 采样策略过滤了追踪数据
  Application Insights默认的采样规则可能会过滤部分追踪信息：

  • 进入Function App的Application Insights配置页面，检查采样率设置，确保Warning级别或自定义追踪的采样率未设为0。
  • 本地开发时，可在配置文件中禁用采样强制采集所有数据：

    {
      "ApplicationInsights": {
        "Sampling": {
          "Enabled": false
        }
      }
    }
    

• 数据延迟或查询方式错误

  • Application Insights数据上报存在几分钟延迟，不要立即查询，等待一段时间后再尝试。
  • 使用正确的Kusto查询语句筛选数据，比如：

    traces
    | where severityLevel == 2
    | where message contains "Alert Button Pressed by Device"
    | order by timestamp desc
    

  也可以直接在AI的日志界面搜索消息关键词确认数据是否存在。

• 缺少必要的NuGet包
  确保项目已安装对应版本的Application Insights包：

  • 隔离模式Function需安装Microsoft.ApplicationInsights.WorkerService
  • 使用依赖注入需安装Microsoft.Azure.Functions.Extensions.DependencyInjection
    建议使用最新稳定版包避免兼容性问题。

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