SkyAPM.Agent.AspNetCore在IIS环境下的监控配置指南

背景介绍

SkyAPM.Agent.AspNetCore是一款用于.NET Core应用程序性能监控的探针工具，能够将应用程序的运行数据发送到SkyWalking APM系统进行分析。在实际部署中，开发者经常需要将.NET Core应用部署到IIS服务器上运行，这时就需要特别注意监控探针的配置问题。

常见问题现象

许多开发者在使用SkyAPM.Agent.AspNetCore 2.1.0版本时发现，当应用程序在本地运行时监控数据正常，但一旦部署到IIS环境中，SkyWalking 9.3就无法接收到任何监控数据。更令人困惑的是，SkyAPM.Agent.AspNetCore的日志文件也没有生成，这使得问题排查变得困难。

问题原因分析

这个问题的根本原因是IIS环境下缺少必要的环境变量配置。在IIS中运行的.NET Core应用需要通过特定的方式加载SkyAPM探针，而默认情况下这些配置不会自动生效。

解决方案

方法一：通过IIS配置编辑器设置环境变量

1. 打开IIS管理器
2. 选择目标网站或应用程序池
3. 在右侧操作面板中找到"配置编辑器"
4. 导航到system.webServer/aspNetCore节点
5. 添加环境变量：
   • 名称：ASPNETCORE_HOSTINGSTARTUPASSEMBLIES
   • 值：SkyAPM.Agent.AspNetCore

这种方法最为可靠，也是官方推荐的做法。通过IIS配置编辑器设置的环境变量能够确保在应用程序启动时正确加载SkyAPM探针。

方法二：修改web.config文件（不推荐）

虽然理论上可以通过修改web.config文件来添加环境变量，但这种方式在实际应用中经常会出现问题。如示例中所示，直接在web.config中添加environmentVariables节点可能导致应用程序无法启动，返回500错误。

配置验证

配置完成后，可以通过以下方式验证是否生效：

1. 检查应用程序是否能够正常访问
2. 查看SkyWalking UI是否有数据上报
3. 检查SkyAPM.Agent.AspNetCore的日志文件是否生成

最佳实践建议

1. 对于生产环境，始终使用IIS配置编辑器来设置环境变量
2. 在部署前，先在测试环境验证监控配置
3. 定期检查SkyAPM探针的日志，确保监控数据正常上报
4. 考虑将环境变量配置纳入部署脚本，实现自动化配置

总结

在IIS环境下使用SkyAPM.Agent.AspNetCore进行应用程序性能监控时，正确的环境变量配置是关键。通过IIS配置编辑器设置ASPNETCORE_HOSTINGSTARTUPASSEMBLIES环境变量是最可靠的方法，能够确保探针正确加载并开始收集监控数据。避免直接在web.config中配置环境变量，以防止应用程序启动失败的问题。