Application Insights AI 辅助接入指南AI Agent 自动检测 .NET 应用类型并一键配置遥测【免费下载链接】ApplicationInsights-dotnetApplicationInsights-dotnet项目地址: https://gitcode.com/gh_mirrors/ap/ApplicationInsights-dotnetApplicationInsights-dotnet是 Application Insights 的 .NET SDK用于向 Azure Monitor 发送分布式追踪、指标与日志遥测数据。它内置了一个可移植的AI 技能包把它交给任意 AI Agent如 Cursor、Copilot、Claude Code、Codex说一句给我的应用接入 Application InsightsAgent 就会自动检测应用类型、判断现有遥测状态并一键引导完成配置让新手也能零踩坑上手应用性能监控。一、什么是 AI 辅助接入传统接入流程需要开发者自行判断我的项目是 ASP.NET Core 还是 Worker Service要不要迁移该用哪个包这套 AI 技能包把判断和执行都交给了 Agent。技能定义文件位于 SKILL.md 对应路径skills/applicationinsights-setup/SKILL.md配套的 20 份操作参考文档在skills/applicationinsights-setup/references/目录下覆盖了从新建到迁移的全部场景。它支持三大类任务任务类型适用场景 全新接入Greenfield从未接入过遥测的新项目 版本迁移Migration从 2.x 升级到 3.x自动扫描代码变更点➕ 功能增强Enhancement已有 3.x追加 EF Core、Redis、SQL、OTLP 等监控二、一键安装步骤30 秒把技能装进 AI Agent先获取源码仓库git clone https://gitcode.com/gh_mirrors/ap/ApplicationInsights-dotnet然后把技能文件夹复制到对应 Agent 的技能目录即可各 Agent 均原生支持 Agent Skills 标准会自动发现AI Agent安装命令Claude Codecp -r skills/applicationinsights-setup ~/.claude/skills/Cursorcp -r skills/applicationinsights-setup .cursor/skills/GitHub Copilotcp -r skills/applicationinsights-setup .github/skills/Codexcp -r skills/applicationinsights-setup .agents/skills/完整安装说明见仓库根目录的AGENTS.md。安装完成后直接在对话中输入自然语言指令即可Add Application Insights to my app给我的应用接入遥测Migrate from Application Insights 2.x to 3.x执行 2.x 到 3.x 迁移Add Redis monitoring to my app追加 Redis 监控三、AI Agent 如何自动检测应用类型这是整个技能包最聪明的地方——它先看代码再动手完全不会猜。第一步扫描.csproj文件判定应用类型检测信号判定结果SdkMicrosoft.NET.Sdk.WebASP.NET Core 应用SdkMicrosoft.NET.Sdk.WorkerWorker Service后台服务SdkMicrosoft.NET.SdkOutputTypeExe/OutputType控制台应用存在Web.config的system.web节旧格式项目经典 ASP.NET若工作区有多个非类库项目Agent 会先询问你要接入哪一个若一个 .NET 项目都没找到它会如实报告而不是瞎猜。第二步检测现有遥测状态自动分流Agent 会扫描包引用含packages.config旧格式与配置文件按下表路由检测结果Agent 的行动发现 3.x 版本包进入功能增强路径发现 2.x 版本包进入版本迁移路径仅发现 OpenTelemetry 包引导追加 Azure Monitor 导出器什么都没发现进入全新接入路径按应用类型加载对应指南如references/aspnetcore-greenfield.md第三步学习后行动——技能规范明确要求 Agent 在改动任何代码前先阅读对应的参考文档保证每一步都有据可依。✅四、四类应用都能一键覆盖技能包为每类应用都准备了对应的接入指南Agent 会自动选择ASP.NET Core自动注入请求、依赖调用、异常与 ILogger 日志采集Worker Service / 后台服务自动采集性能计数器CPU、内存、GC、异常与依赖调用并在停机时优雅刷新遥测经典 ASP.NET处理applicationinsights.config与Web.config的双配置文件改写控制台应用推荐 Generic Host 方式获得完整能力简单脚本则走TelemetryClient手动模式并提醒退出前必须 Flush这一易踩的坑一个容易混淆的细节控制台应用和技能包会统一推荐使用**连接字符串ConnectionString**而非旧版仪器键环境变量为APPLICATIONINSIGHTS_CONNECTION_STRING——Agent 会自动替你把关这个约定。五、从 2.x 迁移到 3.xAI 帮你把代码体检一遍3.x 基于 OpenTelemetry 重构InstrumentationKey、ITelemetryInitializer等一批旧 API 已被移除。别慌Agent 会按照references/analysis-template.md中的9 节体检模板逐项扫描你的代码库服务配置项哪些属性可保留、哪些必须删除自定义 TelemetryInitializer内置的无需迁移Agent 分得清自定义 TelemetryProcessorTelemetryClient中被移除的重载方法采样配置旧百分比采样 → 新的TracesPerSecond速率采样AAD 令牌认证、日志管道、旧扩展方法……扫描结束后给出结论如果没有需要改动的代码迁移就只是升级包版本否则逐项对照references/下的迁移文档如code-migration.md、initializer-migration.md修复。仓库根目录的MigrationGuidance.md和BreakingChanges.md提供了完整官方对照表可供人工复核。六、接入后自动获得什么以 ASP.NET Core 为例接入完成后无需再写任何采集代码遥测面板即刻拥有信号类型自动采集内容 请求所有入站 HTTP 请求的耗时与状态码 依赖出站 HTTP 调用、SQL 查询、Azure SDK 调用 异常未处理异常及完整堆栈 日志Information 级别及以上的 ILogger 输出 指标请求速率、响应时间、CPU、内存验证方法运行应用 → 发起几个请求 → 打开 Azure 门户的 Live Metrics实时反馈与 Transaction Search约 2–5 分钟延迟。七、常见问题快速排查看不到遥测数据检查APPLICATIONINSIGHTS_CONNECTION_STRING环境变量或appsettings.json中的连接字符串是否配置正确包版本冲突所有Microsoft.ApplicationInsights.*包必须保持同一主版本切勿混用 2.x 与 3.x迁移后编译报错多为旧 APIInstrumentationKey属性、TrackPageView等未替换对照references/code-migration.md处理WCF、OWIN、Azure Functions暂不支持自动接入Agent 会明确告知并指引到官方手动接入文档小结ApplicationInsights-dotnet 的 AI 辅助接入把识别应用类型 → 判断接入状态 → 选择正确方案 → 逐步落地整条链路交给了 AI Agent新手只需要一句自然语言指令。 把技能包放进你的 Cursor 或 Claude Code今天就能让 .NET 应用的性能监控数据出现在 Azure Monitor 中。【免费下载链接】ApplicationInsights-dotnetApplicationInsights-dotnet项目地址: https://gitcode.com/gh_mirrors/ap/ApplicationInsights-dotnet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Application Insights AI 辅助接入指南：AI Agent 自动检测 .NET 应用类型并一键配置遥测
Application Insights AI 辅助接入指南AI Agent 自动检测 .NET 应用类型并一键配置遥测【免费下载链接】ApplicationInsights-dotnetApplicationInsights-dotnet项目地址: https://gitcode.com/gh_mirrors/ap/ApplicationInsights-dotnetApplicationInsights-dotnet是 Application Insights 的 .NET SDK用于向 Azure Monitor 发送分布式追踪、指标与日志遥测数据。它内置了一个可移植的AI 技能包把它交给任意 AI Agent如 Cursor、Copilot、Claude Code、Codex说一句给我的应用接入 Application InsightsAgent 就会自动检测应用类型、判断现有遥测状态并一键引导完成配置让新手也能零踩坑上手应用性能监控。一、什么是 AI 辅助接入传统接入流程需要开发者自行判断我的项目是 ASP.NET Core 还是 Worker Service要不要迁移该用哪个包这套 AI 技能包把判断和执行都交给了 Agent。技能定义文件位于 SKILL.md 对应路径skills/applicationinsights-setup/SKILL.md配套的 20 份操作参考文档在skills/applicationinsights-setup/references/目录下覆盖了从新建到迁移的全部场景。它支持三大类任务任务类型适用场景 全新接入Greenfield从未接入过遥测的新项目 版本迁移Migration从 2.x 升级到 3.x自动扫描代码变更点➕ 功能增强Enhancement已有 3.x追加 EF Core、Redis、SQL、OTLP 等监控二、一键安装步骤30 秒把技能装进 AI Agent先获取源码仓库git clone https://gitcode.com/gh_mirrors/ap/ApplicationInsights-dotnet然后把技能文件夹复制到对应 Agent 的技能目录即可各 Agent 均原生支持 Agent Skills 标准会自动发现AI Agent安装命令Claude Codecp -r skills/applicationinsights-setup ~/.claude/skills/Cursorcp -r skills/applicationinsights-setup .cursor/skills/GitHub Copilotcp -r skills/applicationinsights-setup .github/skills/Codexcp -r skills/applicationinsights-setup .agents/skills/完整安装说明见仓库根目录的AGENTS.md。安装完成后直接在对话中输入自然语言指令即可Add Application Insights to my app给我的应用接入遥测Migrate from Application Insights 2.x to 3.x执行 2.x 到 3.x 迁移Add Redis monitoring to my app追加 Redis 监控三、AI Agent 如何自动检测应用类型这是整个技能包最聪明的地方——它先看代码再动手完全不会猜。第一步扫描.csproj文件判定应用类型检测信号判定结果SdkMicrosoft.NET.Sdk.WebASP.NET Core 应用SdkMicrosoft.NET.Sdk.WorkerWorker Service后台服务SdkMicrosoft.NET.SdkOutputTypeExe/OutputType控制台应用存在Web.config的system.web节旧格式项目经典 ASP.NET若工作区有多个非类库项目Agent 会先询问你要接入哪一个若一个 .NET 项目都没找到它会如实报告而不是瞎猜。第二步检测现有遥测状态自动分流Agent 会扫描包引用含packages.config旧格式与配置文件按下表路由检测结果Agent 的行动发现 3.x 版本包进入功能增强路径发现 2.x 版本包进入版本迁移路径仅发现 OpenTelemetry 包引导追加 Azure Monitor 导出器什么都没发现进入全新接入路径按应用类型加载对应指南如references/aspnetcore-greenfield.md第三步学习后行动——技能规范明确要求 Agent 在改动任何代码前先阅读对应的参考文档保证每一步都有据可依。✅四、四类应用都能一键覆盖技能包为每类应用都准备了对应的接入指南Agent 会自动选择ASP.NET Core自动注入请求、依赖调用、异常与 ILogger 日志采集Worker Service / 后台服务自动采集性能计数器CPU、内存、GC、异常与依赖调用并在停机时优雅刷新遥测经典 ASP.NET处理applicationinsights.config与Web.config的双配置文件改写控制台应用推荐 Generic Host 方式获得完整能力简单脚本则走TelemetryClient手动模式并提醒退出前必须 Flush这一易踩的坑一个容易混淆的细节控制台应用和技能包会统一推荐使用**连接字符串ConnectionString**而非旧版仪器键环境变量为APPLICATIONINSIGHTS_CONNECTION_STRING——Agent 会自动替你把关这个约定。五、从 2.x 迁移到 3.xAI 帮你把代码体检一遍3.x 基于 OpenTelemetry 重构InstrumentationKey、ITelemetryInitializer等一批旧 API 已被移除。别慌Agent 会按照references/analysis-template.md中的9 节体检模板逐项扫描你的代码库服务配置项哪些属性可保留、哪些必须删除自定义 TelemetryInitializer内置的无需迁移Agent 分得清自定义 TelemetryProcessorTelemetryClient中被移除的重载方法采样配置旧百分比采样 → 新的TracesPerSecond速率采样AAD 令牌认证、日志管道、旧扩展方法……扫描结束后给出结论如果没有需要改动的代码迁移就只是升级包版本否则逐项对照references/下的迁移文档如code-migration.md、initializer-migration.md修复。仓库根目录的MigrationGuidance.md和BreakingChanges.md提供了完整官方对照表可供人工复核。六、接入后自动获得什么以 ASP.NET Core 为例接入完成后无需再写任何采集代码遥测面板即刻拥有信号类型自动采集内容 请求所有入站 HTTP 请求的耗时与状态码 依赖出站 HTTP 调用、SQL 查询、Azure SDK 调用 异常未处理异常及完整堆栈 日志Information 级别及以上的 ILogger 输出 指标请求速率、响应时间、CPU、内存验证方法运行应用 → 发起几个请求 → 打开 Azure 门户的 Live Metrics实时反馈与 Transaction Search约 2–5 分钟延迟。七、常见问题快速排查看不到遥测数据检查APPLICATIONINSIGHTS_CONNECTION_STRING环境变量或appsettings.json中的连接字符串是否配置正确包版本冲突所有Microsoft.ApplicationInsights.*包必须保持同一主版本切勿混用 2.x 与 3.x迁移后编译报错多为旧 APIInstrumentationKey属性、TrackPageView等未替换对照references/code-migration.md处理WCF、OWIN、Azure Functions暂不支持自动接入Agent 会明确告知并指引到官方手动接入文档小结ApplicationInsights-dotnet 的 AI 辅助接入把识别应用类型 → 判断接入状态 → 选择正确方案 → 逐步落地整条链路交给了 AI Agent新手只需要一句自然语言指令。 把技能包放进你的 Cursor 或 Claude Code今天就能让 .NET 应用的性能监控数据出现在 Azure Monitor 中。【免费下载链接】ApplicationInsights-dotnetApplicationInsights-dotnet项目地址: https://gitcode.com/gh_mirrors/ap/ApplicationInsights-dotnet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考