Application Insights 如何排除localhost数据上报

嘿，这个问题我之前帮不少开发者解决过！要阻止Application Insights上报localhost的遥测数据，不同类型的应用有不同的实用方案，我给你整理了几种最常用的：

方案1：自定义遥测处理器过滤localhost请求 #

这种方法可以精准过滤来自localhost的请求遥测，同时保留其他环境的正常上报。

首先创建一个遥测处理器类：

public class LocalhostFilterTelemetryProcessor : ITelemetryProcessor
{
    private readonly ITelemetryProcessor _nextProcessor;

    public LocalhostFilterTelemetryProcessor(ITelemetryProcessor nextProcessor)
    {
        _nextProcessor = nextProcessor;
    }

    public void Process(ITelemetry telemetryItem)
    {
        // 判断是否是localhost的请求遥测
        if (IsLocalhostRequest(telemetryItem))
        {
            return; // 跳过上报
        }
        _nextProcessor.Process(telemetryItem);
    }

    private bool IsLocalhostRequest(ITelemetry telemetryItem)
    {
        if (telemetryItem is RequestTelemetry requestTelemetry)
        {
            var requestUri = new Uri(requestTelemetry.Url);
            return requestUri.Host.Equals("localhost", StringComparison.OrdinalIgnoreCase) 
                || requestUri.Host == "127.0.0.1";
        }
        // 如果需要过滤其他类型的遥测（比如跟踪日志），可以在这里扩展判断逻辑
        return false;
    }
}

然后在Program.cs里注册这个处理器：

var builder = WebApplication.CreateBuilder(args);

// 添加Application Insights服务
builder.Services.AddApplicationInsightsTelemetry();
// 注册自定义的localhost过滤处理器
builder.Services.AddSingleton<ITelemetryProcessor, LocalhostFilterTelemetryProcessor>();

var app = builder.Build();
// ... 其他中间件配置

方案2：通过开发环境配置直接禁用 #

如果你在localhost运行时用的是Development环境（默认就是），可以直接在appsettings.Development.json里禁用Application Insights：

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

这种方式最简单，适合完全不想在本地开发时上报任何遥测的场景。

方案1：用遥测初始化器标记localhost请求为"合成请求" #

Application Insights会自动忽略标记为合成请求的遥测，我们可以利用这一点：

创建一个遥测初始化器类：

public class LocalhostTelemetryInitializer : ITelemetryInitializer
{
    public void Initialize(ITelemetry telemetry)
    {
        var requestTelemetry = telemetry as RequestTelemetry;
        if (requestTelemetry == null || HttpContext.Current == null)
        {
            return;
        }

        var requestHost = HttpContext.Current.Request.Url.Host;
        if (requestHost.Equals("localhost", StringComparison.OrdinalIgnoreCase) 
            || requestHost == "127.0.0.1")
        {
            // 标记为合成请求，Application Insights会自动跳过
            telemetry.Context.Operation.Synthetic = true;
        }
    }
}

然后在ApplicationInsights.config里注册这个初始化器：

<TelemetryInitializers>
  <Add Type="你的命名空间.LocalhostTelemetryInitializer, 你的程序集名称" />
</TelemetryInitializers>

方案2：利用Web.config转换禁用调试环境上报 #

在Web.Debug.config里添加转换规则，让调试时自动禁用Application Insights：

<applicationInsights enabled="false" xdt:Transform="SetAttributes(enabled)" />

这样当你在localhost调试时，Application Insights就不会工作了。

如果你需要更灵活的控制，可以在应用启动时手动判断环境，然后禁用或过滤遥测：

// 判断是否是本地开发环境（这里以ASP.NET Core的环境变量为例，其他环境可以调整判断逻辑）
var isLocalEnvironment = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") == "Development";

if (isLocalEnvironment)
{
    // 完全禁用遥测
    TelemetryConfiguration.Active.DisableTelemetry = true;
}

注意：这种方式会完全关闭所有遥测上报，如果只是想过滤localhost请求，还是用前面的处理器/初始化器方案更合适。

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