从grpc.core迁移至Grpc.AspNetCore：日志环境变量是否可用？如何设日志级别？

GRPC_TRACE、GRPC_VERBOSITY 环境变量的兼容性说明 #

Grpc.AspNetCore 底层依赖的 gRPC Core 库仍支持 GRPC_TRACE 和 GRPC_VERBOSITY 环境变量，但由于它采用 Microsoft.Extensions.Logging 作为统一日志框架，这些环境变量触发的底层日志会被路由到该框架中，而非直接输出。也就是说你之前的环境变量设置本身有效，但必须配合日志框架的配置，才能让日志正常显示。

完整日志配置步骤 #

1. 保留原有环境变量设置（开启底层Trace日志） #

你在 grpc.core 中使用的环境变量配置可以直接沿用，用来开启 transport_security、tsi 相关的底层追踪日志：

$GrpcTrace = "transport_security,tsi"
$GrpcTraceVerbosity = "Debug"
[Environment]::SetEnvironmentVariable("GRPC_VERBOSITY", $GrpcTraceVerbosity, [System.EnvironmentVariableTarget]::Process)
[Environment]::SetEnvironmentVariable("GRPC_TRACE", $GrpcTrace -join ",", [System.EnvironmentVariableTarget]::Process)

这些日志会被标记为 Grpc.Core 分类下的 Debug 级别日志。

2. 配置 Microsoft.Extensions.Logging 捕获并输出日志 #

需要在 ASP.NET Core 项目中配置日志提供器（以控制台为例），明确开启 Grpc.Core 分类的 Debug 级别日志，避免日志被过滤。

方式一：通过配置文件（appsettings.Development.json）

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Grpc.Core": "Debug" // 允许输出gRPC底层的Debug日志
    },
    "Console": {
      "FormatterOptions": {
        "TimestampFormat": "HH:mm:ss ",
        "IncludeScopes": true
      }
    }
  }
}

方式二：通过代码配置（Program.cs，.NET 6+ 顶级语句）

var builder = WebApplication.CreateBuilder(args);

// 注册gRPC服务
builder.Services.AddGrpc();

// 配置日志过滤和输出
builder.Logging.AddFilter("Grpc.Core", LogLevel.Debug)
               .AddConsole(options =>
               {
                   options.TimestampFormat = "HH:mm:ss ";
               });

var app = builder.Build();

// 映射gRPC服务端点
app.MapGrpcService<YourGrpcServiceImpl>();
app.Run();

3. 验证日志输出 #

完成上述配置后，重启应用（环境变量需在启动前设置），即可在控制台看到 Grpc.Core 分类下，包含 transport_security、tsi 关键词的 Debug 级日志。

关键注意事项 #

• 环境变量必须在应用启动前设置，运行中修改需要重启应用才能生效。
• 如果仅设置环境变量但未开启 Grpc.Core 的 Debug 日志级别，底层日志会被 Microsoft.Extensions.Logging 过滤，导致无法看到输出。

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