SkyAPM.Agent.AspNetCore在IIS环境下的配置问题解决方案

背景介绍

SkyAPM.Agent.AspNetCore是.NET Core应用接入SkyWalking分布式追踪系统的重要组件。在实际部署过程中，开发者可能会遇到本地开发环境运行正常，但部署到IIS后无法采集监控数据的问题。

问题现象

当使用SkyAPM.Agent.AspNetCore 2.1.0版本时，开发者发现：

1. 本地运行的.NET Core项目能够正常监控
2. 部署到IIS后，SkyWalking 9.3无法接收任何数据
3. SkyAPM.Agent.AspNetCore的日志文件未生成
4. 尝试在web.config中添加环境变量配置后，应用出现500错误

根本原因分析

这个问题主要源于IIS环境下环境变量的配置方式与本地开发环境不同。在IIS中，简单的web.config配置可能无法正确加载SkyAPM的启动程序集。

解决方案

通过IIS配置编辑器直接设置环境变量是更可靠的解决方案：

1. 打开IIS管理器
2. 选择目标应用程序
3. 打开"配置编辑器"
4. 导航到system.webServer/aspNetCore节点
5. 在"environmentVariables"集合中添加以下环境变量：
   • 名称：ASPNETCORE_HOSTINGSTARTUPASSEMBLIES
   • 值：SkyAPM.Agent.AspNetCore

配置验证

配置完成后，需要确认以下几点：

1. 应用能够正常启动且不再出现500错误
2. SkyAPM.Agent.AspNetCore开始生成日志文件
3. SkyWalking服务器能够接收到追踪数据

最佳实践建议

1. 对于生产环境，建议同时配置日志级别以便排查问题
2. 考虑在应用池的高级设置中设置"加载用户配置文件"为True
3. 确保IIS应用程序池账号有足够的权限访问SkyAPM相关文件

总结

在IIS环境下使用SkyAPM.Agent.AspNetCore时，正确的环境变量配置方式是通过IIS配置编辑器而非直接修改web.config文件。这种方法更加稳定可靠，能够确保.NET Core应用在IIS中正常集成SkyWalking的APM功能。