.NET 8 Azure Functions隔离进程：LogDebug/LogTrace日志不显示排查

DevOps 小满

2026-6-13

问题

我正在使用.NET 8的Azure Functions隔离工作进程模型，尝试通过ILogger捕获详细日志。我的日志调用包含LogDebug、LogTrace及LogInformation，但仅LogInformation消息会出现在以下两个位置：

Azure门户>函数>监控>日志（“代码+测试”面板）
Application Insights（通过日志中的KQL查询）

我的host.json配置如下：

{
  "version": "2.0",
  "logging": {
    "logLevel": {
      "Default": "Trace",
      "Function.ProcessImmediateSubscriptions": "Trace"
  },
    "applicationInsights": {
        "LogLevel": {
            "Default": "Trace"
        },
        "samplingSettings": {
            "isEnabled": true,
            "excludedTypes": "Request"
        },
        "enableLiveMetricsFilters": true
    }
  }
}

Program.cs配置如下：

using IMFSubscriptionProcessor.Application;
using IMFSubscriptionProcessor.Infrastructure;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

var host = new HostBuilder()
    .ConfigureFunctionsWebApplication()
    .ConfigureServices((context, services) =>
    {
        // Add telemetry and App Insights
        services.AddApplicationInsightsTelemetryWorkerService();
        services.ConfigureFunctionsApplicationInsights();
        services.AddLogging();

        // Add your DI services
        var configuration = context.Configuration;
        services.AddInfrastructureServices(configuration);
        services.AddApplicationServices(configuration);
    })

    .Build();

host.Run();

请问为何已将host.json日志级别设为Trace，LogDebug和LogTrace日志仍未出现在Application Insights或实时日志中？从隔离工作进程Azure Functions中持久化或输出Debug/Trace日志是否需要额外配置？

解决方案

针对隔离工作进程模型的Azure Functions，要让LogDebug和LogTrace日志正常输出，需要检查并调整以下几个配置：

补充host.json的日志输出目标配置
隔离模型默认可能未将Debug/Trace级别日志发送到所有输出目标，需在logging节点下添加console的日志级别配置，确保低级别日志能被输出：

"logging": {
  "logLevel": {
    "Default": "Trace",
    "Function.ProcessImmediateSubscriptions": "Trace"
  },
  "console": {
    "logLevel": {
      "Default": "Trace"
    }
  },
  "applicationInsights": {
    "LogLevel": {
      "Default": "Trace"
    },
    "samplingSettings": {
      "isEnabled": true,
      "excludedTypes": "Request"
    },
    "enableLiveMetricsFilters": true
  }
}

调整Application Insights采样规则
当前采样配置仅排除了Request类型，但Debug/Trace日志可能被采样过滤。可临时关闭采样验证：
```
"samplingSettings": {
  "isEnabled": false
}
```
若关闭后日志正常显示，再根据需求调整采样规则，比如设置maxTelemetryItemsPerSecond或添加includedTypes包含Trace/Debug日志。

显式配置Program.cs中的日志最小级别
在ConfigureServices中明确设置日志提供程序的最小级别，避免默认配置覆盖：

services.AddLogging(builder =>
{
    builder.SetMinimumLevel(LogLevel.Trace);
    builder.AddApplicationInsights().SetMinimumLevel(LogLevel.Trace);
});

修改Azure门户日志查询范围
门户日志查询默认可能只显示Information及以上级别，需调整KQL查询包含Trace和Debug：
```
traces
| where severityLevel <= 2 // 0=Verbose(Trace),1=Debug,2=Information
| order by timestamp desc
```
本地调试验证基础输出
先在本地运行函数，查看控制台是否能输出LogDebug和LogTrace日志。如果本地正常，说明问题出在Azure环境配置；如果本地也不输出，检查ILogger注入是否正确（比如是否使用ILogger<MyFunction>而非通用ILogger）。

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