用途:为 .NET 应用配置、迁移或增强 Azure Monitor Application Insights。技能会先自动检测应用类型与现有插桩状态,再引导走正确的设置、迁移或增强路径。
主要能力:识别 SDK 风格与旧式 .csproj/.fsproj/.vbproj,区分 ASP.NET Core、Worker Service、控制台、类库、ASP.NET Classic 等类型;扫描包引用与配置文件判断是否已有插桩及版本;据此路由到新建、2.x 到 3.x 迁移或 3.x 增强指南。
使用方式:先读取相关概念或迁移参考文档再改代码。新建路径按应用类型读取对应参考;迁移路径先扫描代码库,再按发现(ITelemetryInitializer、ITelemetryProcessor、自定义采样、ILogger、TelemetryClient、依赖跟踪、AAD 认证、Live Metrics 等)读取相应迁移文档。增强路径按需添加 EF Core、Redis、SQL Client、HTTP、OTLP 导出器、采样、自定义处理器/活动/日志/指标等。
限制:仅覆盖 Application Insights 3.x SDK(Microsoft.ApplicationInsights.AspNetCore/.WorkerService/.Web);Azure Monitor OpenTelemetry Distro 属另一产品,不可混用。WCF、OWIN、Azure Functions 不支持自动设置。始终使用 ConnectionString 而非 InstrumentationKey,环境变量为 APPLICATIONINSIGHTS_CONNECTION_STRING;Classic ASP.NET 的连接字符串放在 ApplicationInsights.config。Classic ASP.NET 使用 Visual Studio 包管理器控制台 Install-Package,而非 dotnet add package。改动后需构建、运行并在 Azure 门户确认遥测。未找到项目文件时应报告未检测到 .NET 项目。