.NET Core 3.1 WebJob本地运行日志无法写入Azure Application Insights

一、确认依赖包安装正确性 #

必须确保项目安装了以下NuGet包，缺一不可：

• Serilog.Sinks.ApplicationInsights：负责Serilog与Application Insights的适配
• Microsoft.ApplicationInsights.WorkerService：针对Worker Service/WebJob场景的AI SDK
• Serilog.AspNetCore：用于ASP.NET Core环境下的Serilog集成

可通过NuGet命令行安装：

Install-Package Serilog.Sinks.ApplicationInsights
Install-Package Microsoft.ApplicationInsights.WorkerService
Install-Package Serilog.AspNetCore

二、验证配置文件有效性 #

.NET Core 3.1 WebJob优先使用appsettings.json而非app.config，确保配置项准确：

{
  "Serilog": {
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "Microsoft": "Warning",
        "System": "Warning"
      }
    }
  },
  "ApplicationInsights": {
    "InstrumentationKey": "你的AI实例密钥"
  }
}

注意：本地运行时，检查系统环境变量是否存在APPINSIGHTS_INSTRUMENTATIONKEY，若存在需与配置文件中的密钥保持一致，避免被覆盖。

三、检查Program.cs集成逻辑 #

WebJob的Program.cs需正确完成Serilog与Application Insights的绑定，示例代码如下：

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Serilog;
using Serilog.Sinks.ApplicationInsights.TelemetryConverters;

namespace YourWebJobNamespace
{
    class Program
    {
        static void Main(string[] args)
        {
            var host = new HostBuilder()
                .ConfigureServices((context, services) =>
                {
                    // 注册WebJob专用的Application Insights服务
                    services.AddApplicationInsightsTelemetryWorkerService();
                    // 注册你的WebJob业务服务
                    services.AddHostedService<YourWebJobService>();
                })
                .UseSerilog((context, services, configuration) => configuration
                    .ReadFrom.Configuration(context.Configuration)
                    .Enrich.FromLogContext()
                    // 绑定AI的TelemetryClient，使用Trace转换器确保日志被正确识别
                    .WriteTo.ApplicationInsights(services.GetRequiredService<Microsoft.ApplicationInsights.TelemetryClient>(),
                        new TraceTelemetryConverter()))
                .Build();

            host.Run();
        }
    }
}

关键注意点：

• 必须调用AddApplicationInsightsTelemetryWorkerService，而非Web应用场景的AddApplicationInsightsTelemetry
• Serilog的AI输出端必须传入容器中初始化好的TelemetryClient实例，避免手动创建导致配置失效

四、本地运行特殊事项 #

1. 数据延迟：本地发送的日志需等待5-10分钟才会在AI门户显示，不要立即刷新查询
2. 网络限制：确保本地防火墙/代理允许向dc.services.visualstudio.com和in.applicationinsights.azure.com发起HTTPS请求
3. 日志级别过滤：确认代码中输出的日志级别（如LogInformation）不低于Serilog配置的MinimumLevel，否则日志会被过滤

五、调试与验证 #

在WebJob业务类中注入ILogger和TelemetryClient，手动发送测试日志：

private readonly ILogger<YourWebJobService> _logger;
private readonly TelemetryClient _telemetryClient;

public YourWebJobService(ILogger<YourWebJobService> logger, TelemetryClient telemetryClient)
{
    _logger = logger;
    _telemetryClient = telemetryClient;
}

public async Task StartAsync(CancellationToken cancellationToken)
{
    _logger.LogInformation("WebJob本地启动测试日志");
    _telemetryClient.TrackEvent("WebJobLocalTestEvent");
    
    // 业务逻辑代码...
}

随后在AI门户的**日志（Analytics）**中用Kusto查询验证：

// 查询测试日志
traces | where message contains "WebJob本地启动测试日志" | order by timestamp desc

// 查询测试事件
customEvents | where name == "WebJobLocalTestEvent" | order by timestamp desc

六、常见错误排查 #

• 密钥错误：核对InstrumentationKey是否与AI实例一致，避免空格或多余字符
• Sink配置缺失：确认WriteTo.ApplicationInsights代码未被注释或遗漏
• 版本冲突：确保所有AI相关包版本兼容，.NET Core 3.1建议使用2.15.0以上版本的AI包

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