如何修改Azure Application Insights跟踪日志中的AspNetCoreEnvironment值？

一、AspNetCoreEnvironment 的来源与生成逻辑 #

AspNetCoreEnvironment 是 ASP.NET Core 用于标识运行环境的核心变量，取值优先级从高到低为：

• 环境变量：优先读取系统环境变量 ASPNETCORE_ENVIRONMENT（Windows/Linux/macOS 通用）
• 命令行参数：启动时通过 --environment 参数指定（例如 dotnet run --environment Development）
• 本地配置文件：仅本地开发时，读取 launchSettings.json 中 environmentVariables 节点的配置
• 默认值：若以上均未配置，系统自动设为 Production

你遇到三个环境日志值均为 Production，大概率是部署过程中未正确设置 ASPNETCORE_ENVIRONMENT 环境变量，导致触发了默认值逻辑。

二、修改 AspNetCoreEnvironment 值的方法 #

1. Azure 门户配置（云端部署推荐） #

针对 Azure App Service 部署的应用，直接在门户设置环境变量：

• 进入目标 App Service 资源，左侧菜单选择 配置 > 应用程序设置
• 点击 新建应用程序设置，添加键为 ASPNETCORE_ENVIRONMENT，值对应环境标识（如 Dev/Test/Production）
• 保存设置后应用自动重启，后续 Application Insights 日志会显示正确的环境值

2. 代码指定（仅特殊测试场景使用） #

不推荐用于多环境区分，仅临时测试时可在 Program.cs 中强制指定：

var builder = WebApplication.CreateBuilder(args);
// 强制设置环境值，仅测试场景用
builder.Environment.EnvironmentName = "Dev";

3. CI/CD 部署时注入（流水线场景） #

若使用 Azure DevOps、GitHub Actions 等工具部署，可在部署步骤中注入环境变量：

• 例如在 Azure DevOps 的 App Service 部署任务中，设置应用程序设置参数为 ASPNETCORE_ENVIRONMENT=$(EnvironmentName)，其中 $(EnvironmentName) 是流水线定义的环境变量（对应 Dev/Test/Prod）

三、日志分类验证 #

修改完成后，可在 Application Insights 日志查询中验证：

requests
| where customDimensions.AspNetCoreEnvironment == "Dev"
| take 10

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