如何在Asp.Net Webforms应用中配置使用Application Insight

针对经典.NET Framework下的WebForms应用，不要套用ASP.NET Core的接入逻辑，两者的HTTP管道实现完全不同，Master Page架构不需要做特殊适配，按以下步骤操作即可：

• 首先安装适配经典ASP.NET的官方SDK：右键WebForms项目打开NuGet包管理器，搜索安装Microsoft.ApplicationInsights.Web，这是专门给.NET Framework 4.x场景做的自动集成包，安装完成后项目根目录会自动生成ApplicationInsights.config配置文件。
• 配置密钥：打开ApplicationInsights.config，将Azure门户中创建的Application Insights资源对应的检测密钥填入<InstrumentationKey>节点；也可以直接在web.config的appSettings节点下加配置项<add key="APPINSIGHTS_INSTRUMENTATIONKEY" value="你的资源检测密钥" />，该配置优先级高于独立config文件。
• 验证自动HTTP拦截：安装包后会自动在web.config中注册HTTP模块Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule，该模块会挂载到ASP.NET请求管道上，自动采集所有.aspx、.ashx、静态资源等请求的耗时、状态码、服务端异常、请求参数等日志，不需要在每个页面单独写埋点代码。
• Master Page场景下的客户端统计适配：不需要逐个修改内容页，直接打开站点公共根Master Page文件，在<head>标签结束前插入Application Insights客户端JavaScript SDK代码片段即可，所有继承该Master Page的内容页都会自动加载统计脚本，自动上报页面浏览量、用户停留时长、客户端异常、前端加载性能等使用数据。如果站点存在多套Master Page，在每套Master Page的相同位置插入同一段JS代码即可。JS代码片段可以直接从你的Application Insights资源门户的「客户端监控」配置页复制，替换成你自己的资源连接字符串就能用。
• 数据验证：本地启动站点后，可通过Visual Studio自带的Application Insights搜索工具查看本地调试时的上报数据，确认请求、页面浏览事件正常上报后，部署到生产环境等待5-10分钟即可在Azure门户看到现成的请求监控看板、页面访问排行、用户留存等统计视图。

常见兼容问题处理 #

• 请确保项目使用的.NET Framework版本≥4.5，且将Microsoft.ApplicationInsights.Web升级到最新稳定版，旧版本存在WebForms PostBack回发场景下的请求漏统计问题。
• 如果部署到IIS后发现请求数据不上报，检查web.config中Application Insights的HTTP模块是否同时注册到了集成模式的<system.webServer><modules>节点下，不要只注册到经典模式的<system.web><httpModules>节点。
• 需要自定义埋点时，服务端可直接初始化TelemetryClient实例调用TrackEvent、TrackMetric等方法上报自定义业务数据；客户端侧可直接调用全局appInsights实例的对应上报方法，不需要额外初始化。

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