ASP.NET Core应用Azure Application Insights页面视图无法显示求助

核心原因分析及解决方案 #

1. ASP.NET版本与SDK配置逻辑差异 #

• 若使用的是ASP.NET Core（非传统.NET Framework的ASP.NET），默认不会生成applicationinsights.config文件，配置项统一放在appsettings.json或通过代码定义。页面视图追踪依赖客户端JavaScript SDK的自动注入，未开启则无法采集数据：
  • 检查appsettings.json是否包含必要配置：

    "ApplicationInsights": {
      "InstrumentationKey": "你的密钥",
      "EnableClientSideTelemetry": true
    }
    

  • 确认Program.cs中正确注册了Application Insights服务：

    builder.Services.AddApplicationInsightsTelemetry();
    

  • 若自动注入未生效，可手动在布局页（如_Layout.cshtml）添加客户端SDK脚本：

    <script type="text/javascript">
      var appInsights=window.appInsights||function(a){
          function b(a){c[a]=function(){var b=arguments;c.queue.push(function(){c[a].apply(c,b)})}}var c={config:a},d=document,e=window;setTimeout(function(){var b=d.createElement("script");b.src=a.url||"https://az416426.vo.msecnd.net/scripts/b/ai.2.min.js",d.getElementsByTagName("script")[0].parentNode.appendChild(b)});try{c.cookie=d.cookie}catch(a){}c.queue=[];for(var f=["Event","Exception","Metric","PageView","Trace","Dependency"];f.length;)b("track"+f.pop());if(b("setAuthenticatedUserContext"),b("clearAuthenticatedUserContext"),b("startTrackEvent"),b("stopTrackEvent"),b("startTrackPage"),b("stopTrackPage"),b("flush"),!a.disableExceptionTracking){f="onerror",b("_"+f);var g=e[f];e[f]=function(a,b,d,e,h){var i=g&&g(a,b,d,e,h);return!0!==i&&c["_"+f](a,b,d,e,h),i}}return c
      }({
          instrumentationKey:"你的InstrumentationKey"
      });
      
      window.appInsights=appInsights,appInsights.trackPageView();
    </script>
    

2. 采样规则过滤了页面视图 #

• 实时指标可见但页面视图丢失，大概率是采样配置导致数据被过滤。自适应采样或手动设置的采样百分比过低，会丢弃部分页面视图数据：
  • 可临时关闭采样测试：

    "ApplicationInsights": {
      "InstrumentationKey": "你的密钥",
      "EnableAdaptiveSampling": false,
      "SamplingSettings": {
        "Percentage": 100
      }
    }
    

3. 连接服务配置不完整 #

• 通过Visual Studio添加连接服务时，可能未勾选"Enable client-side telemetry"选项，导致客户端追踪未自动配置。传统ASP.NET Framework项目才会生成applicationinsights.config，ASP.NET Core项目需手动确认客户端追踪开启状态：
  • 重新添加连接服务，确保配置步骤中启用客户端追踪；或直接补充上述手动注入脚本。

4. 页面视图触发时机不匹配 #

• 若应用是单页应用（SPA）或依赖AJAX加载内容，默认的页面视图追踪仅在初始页面加载时触发，后续路由切换不会自动上报。需在路由变更时手动调用追踪方法：
  • 以Vue为例，在路由守卫中添加：

    router.afterEach((to, from) => {
      appInsights.trackPageView({name: to.name, uri: to.fullPath});
    });
    

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