# Azure.ResourceManager.ApplicationInsights (.NET) Azure 资源管理器 SDK，用于管理 Application Insights 资源以进行应用程序性能监控。 ## 安装 dotnet 添加包 Azure.ResourceManager.ApplicationInsights dotnet 添加包 Azure.Identity **当前版本**：v1.0.0 (GA) **API版本** : 2022-06-15 ## 环境变量 AZURE_SUBSCRIPTION_ID=<您的订阅 ID> AZURE_RESOURCE_GROUP=<您的资源组> AZURE_APPINSIGHTS_NAME=<您的应用见解组件> ## 身份验证使用 Azure.Identity；使用 Azure.ResourceManager；使用 Azure.ResourceManager.ApplicationInsights； ArmClient 客户端 = new ArmClient(new DefaultAzureCredential()); ## 资源层次结构订阅 └── 资源组 └── ApplicationInsightsComponent # App Insights 资源 ├── ApplicationInsightsComponentApiKey # 用于编程访问的 API 密钥 ├── ComponentLinkedStorageAccount # 数据导出的链接存储 └──（通过组件ID） ├── WebTest # 可用性测试 ├── 工作簿 # 分析工作簿 ├── WorkbookTemplate # 工作簿模板 └── MyWorkbook # 私人工作簿 ## 核心工作流程 ### 1\.创建 Application Insights 组件（基于工作区）使用 Azure.ResourceManager.ApplicationInsights；使用 Azure.ResourceManager.ApplicationInsights.Models； ResourceGroup资源资源组 = 等待客户端 .GetDefaultSubscriptionAsync() .结果 .GetResourceGroupAsync("我的资源组"); ApplicationInsightsComponentCollection 组件 = resourceGroup.GetApplicationInsightsComponents(); // 基于工作区的应用程序洞察（推荐） ApplicationInsightsComponentData 数据 = new ApplicationInsightsComponentData( AzureLocation.EastUS, ApplicationInsightsApplicationType.Web) { 种类=“网络”，工作空间资源 ID = 新资源标识符( “/subscriptions//resourceGroups//providers/Microsoft.OperationalInsights/workspaces/<工作空间名称>”）， IngestionMode = IngestionMode.LogAnalytics, PublicNetworkAccessForIngestion = PublicNetworkAccessType.Enabled, PublicNetworkAccessForQuery = PublicNetworkAccessType.Enabled, 保留天数 = 90, 采样百分比 = 100, 禁用IPMasking = false， ImmediatePurgeDataOn30Days = false, 标签= { { "环境", "生产" }, {“应用程序”，“mywebapp”} } }; ArmOperation 操作 = 等待组件 .CreateOrUpdateAsync(WaitUntil.Completed, "my-appinsights", data); ApplicationInsightsComponentResource 组件 = 操作.Value; Console.WriteLine($"已创建组件：{component.Data.Name}"); Console.WriteLine($"检测密钥：{component.Data.InstrumentationKey}"); Console.WriteLine($"连接字符串：{component.Data.ConnectionString}"); ### 2\.获取连接字符串和密钥 ApplicationInsightsComponentResource 组件 = 等待资源组 .GetApplicationInsightsComponentAsync("my-appinsights"); // 获取SDK配置的连接字符串字符串连接字符串=组件.数据.连接字符串; 字符串 InstrumentationKey = component.Data.InstrumentationKey; 字符串appId =组件.Data.AppId; Console.WriteLine($"连接字符串：{connectionString}"); Console.WriteLine($"检测密钥：{instrumentationKey}"); Console.WriteLine($"应用程序 ID: {appId}"); ### 3\.创建 API 密钥 ApplicationInsightsComponentResource 组件 = 等待资源组 .GetApplicationInsightsComponentAsync("my-appinsights"); ApplicationInsightsComponentApiKeyCollection apiKeys = component.GetApplicationInsightsComponentApiKeys(); // 用于读取遥测数据的 API 密钥 ApplicationInsightsApiKeyContent keyContent = 新的 ApplicationInsightsApiKeyContent { 名称=“读取遥测密钥”，链接读取属性 = { $"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/components/{component.Data.Name}/api", $"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/components/{component.Data.Name}/agentconfig" } }; ApplicationInsightsComponentApiKeyResource apiKey = 等待 apiKeys .CreateOrUpdateAsync(WaitUntil.Completed, keyContent); Console.WriteLine($"API 密钥名称：{apiKey.Data.Name}"); Console.WriteLine($"API 密钥：{apiKey.Data.ApiKey}"); // 只显示一次！ ### 4\.创建 Web 测试（可用性测试） WebTestCollection webTests = resourceGroup.GetWebTests(); // URL Ping 测试 WebTestData urlPingTest = new WebTestData(AzureLocation.EastUS) { 种类 = WebTestKind.Ping, SyntheticMonitorId = "webtest-ping-myapp", WebTestName = "主页可用性", 描述 =“检查主页是否可用”, 已启用 = true, 频率 = 300, // 5 分钟超时 = 120, // 2 分钟 WebTestKind = WebTestKind.Ping，重试启用 = true, 地点 = { new WebTestGeolocation { WebTestLocationId = "us-ca-sjc-azr" }, // 美国西部 new WebTestGeolocation { WebTestLocationId = "us-tx-sn1-azr" }, // 美国中南部 new WebTestGeolocation { WebTestLocationId = "us-il-ch1-azr" }, // 美国中北部 new WebTestGeolocation { WebTestLocationId = "emea-gb-db3-azr" }, // 英国南部 new WebTestGeolocation { WebTestLocationId = "apac-sg-sin-azr" } // 东南亚 }, 配置 = 新的 WebTestConfiguration { 网络测试=“”” <物品> <请求方法=“GET”版本=“1.1”网址=“https://myapp.example.com” ThinkTime =“0”超时=“120”ParseDependentRequests =“假” FollowRedirects=“True”RecordResult=“True”缓存=“False” ResponseTimeGoal =“0”编码=“utf-8”ExpectedHttpStatusCode =“200”/> ”“” }, 标签= { { $"隐藏链接:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/components/my-appinsights", "资源" } } }; ArmOperation 操作 = 等待 webTests .CreateOrUpdateAsync(WaitUntil.Completed, "webtest-homepage", urlPingTest); WebTestResource webTest = 操作.Value; Console.WriteLine($"Web 测试已创建：{webTest.Data.Name}"); ### 5\.创建多步骤 Web 测试 WebTestData multiStepTest = new WebTestData(AzureLocation.EastUS) { 种类 = WebTestKind.MultiStep, SyntheticMonitorId = "webtest-多步登录", WebTestName = "登录流程测试", 描述 =“测试登录功能”，已启用 = true, 频率 = 900, // 15 分钟超时 = 300, // 5 分钟 WebTestKind = WebTestKind.MultiStep, 重试启用 = true, 地点 = { 新的 WebTestGeolocation { WebTestLocationId = "us-ca-sjc-azr" } }, 配置 = 新的 WebTestConfiguration { 网络测试=“”” <物品> <请求方法=“GET”版本=“1.1”网址=“https://myapp.example.com/login” ThinkTime =“0”超时=“60”/> <请求方法=“POST”版本=“1.1”网址=“https://myapp.example.com/api/auth” ThinkTime =“0”超时=“60”> <标题> <标题名称=“内容类型”值=“application/json”/> {"用户名":"testuser","密码":"{{TestPassword}}"} ”“” }, 标签= { { $"隐藏链接:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/components/my-appinsights", "资源" } } }; 等待 webTests.CreateOrUpdateAsync(WaitUntil.Completed, "webtest-login-flow", multiStepTest); ### 6\.创建工作簿 WorkbookCollection 工作簿 = resourceGroup.GetWorkbooks(); WorkbookData workbookData = new WorkbookData(AzureLocation.EastUS) { DisplayName = "应用程序性能仪表板", 类别=“工作簿”，种类 = WorkbookSharedTypeKind.Shared, 序列化数据 = """ { “版本”：“笔记本/1.0”， “项目”：[ { “类型”：1， “内容”：{ "json": "# 应用程序性能\n\n此工作簿显示应用程序性能指标。" }, “名称”：“标题” }, { “类型”：3， “内容”：{ “版本”：“KqlItem/1.0”， "query": "请求\n|通过 bin(timestamp, 1h) 总结 count()\n|渲染时间表", “大小”：0， "title": "每小时请求数", “时间上下文”：{ “持续时间女士”：86400000 }, “查询类型”：0， “resourceType”：“microsoft.insights/组件” }, "name": "请求图表" } ], “已锁定”：假 } """, SourceId = 组件.Id, 标签= { { "环境", "生产" } } }; // 注意：工作簿 ID 应该是新的 GUID 字符串workbookId = Guid.NewGuid().ToString(); ArmOperation 操作 = 等待工作簿 .CreateOrUpdateAsync(WaitUntil.Completed, workbookId, workbookData); WorkbookResource 工作簿 = 操作.Value; Console.WriteLine($"工作簿已创建：{workbook.Data.DisplayName}"); ### 7\.链接存储帐户 ApplicationInsightsComponentResource 组件 = 等待资源组 .GetApplicationInsightsComponentAsync("my-appinsights"); ComponentLinkedStorageAccountCollection linkedStorage = component.GetComponentLinkedStorageAccounts(); ComponentLinkedStorageAccountData storageData = 新的 ComponentLinkedStorageAccountData { LinkedStorageAccount = 新资源标识符( “/subscriptions//resourceGroups//providers/Microsoft.Storage/storageAccounts/<存储帐户>”） }; ArmOperation 操作 = 等待 linkedStorage .CreateOrUpdateAsync(WaitUntil.Completed, StorageType.ServiceProfiler, storageData); ### 8\.列出和管理组件 // 列出资源组中的所有 Application Insights 组件等待 foreach（ApplicationInsightsComponentResource 组件中 ResourceGroup.GetApplicationInsightsComponents()) { Console.WriteLine($"组件：{组件.Data.Name}"); Console.WriteLine($" 应用 ID: {component.Data.AppId}"); Console.WriteLine($" 类型：{component.Data.ApplicationType}"); Console.WriteLine($" 摄取模式：{component.Data.IngestionMode}"); Console.WriteLine($" 保留期：{component.Data.RetentionInDays} 天"); } // 列出网络测试等待foreach（resourceGroup.GetWebTests（）中的WebTestResource webTest） { Console.WriteLine($"Web 测试：{webTest.Data.WebTestName}"); Console.WriteLine($" 已启用：{webTest.Data.IsEnabled}"); Console.WriteLine($"频率：{webTest.Data.Frequency}s"); } // 列出工作簿 wait foreach（resourceGroup.GetWorkbooks() 中的 WorkbookResource 工作簿） { Console.WriteLine($"工作簿：{workbook.Data.DisplayName}"); } ### 9\.更新组件 ApplicationInsightsComponentResource 组件 = 等待资源组 .GetApplicationInsightsComponentAsync("my-appinsights"); // 使用完整数据更新（PUT 操作） ApplicationInsightsComponentData updateData = 组件.Data; updateData.RetentionInDays = 180; updateData.SamplingPercentage = 50; updateData.Tags["已更新"] = "true"; ArmOperation 操作 = 等待资源组 .GetApplicationInsightsComponents() .CreateOrUpdateAsync(WaitUntil.Completed, "my-appinsights", updateData); ### 10\.删除资源 // 删除Application Insights组件 ApplicationInsightsComponentResource 组件 = 等待资源组 .GetApplicationInsightsComponentAsync("my-appinsights"); 等待组件.DeleteAsync(WaitUntil.Completed); // 删除网络测试 WebTestResource webTest =等待resourceGroup.GetWebTestAsync（“webtest-主页”）; 等待 webTest.DeleteAsync(WaitUntil.Completed); ## 按键类型参考类型 |目的 ---|--- `ApplicationInsightsComponentResource` |应用程序洞察组件 `ApplicationInsightsComponentData` |组件配置 `ApplicationInsightsComponentCollection` |组件集合 `ApplicationInsightsComponentApiKeyResource` |用于编程访问的 API 密钥 `WebTestResource` |可用性/网络测试 `WebTestData` |网页测试配置 `工作簿资源` |分析工作簿 `工作簿数据` |工作簿配置 `ComponentLinkedStorageAccountResource` |用于导出的链接存储 ## 应用程序类型类型 |枚举值 ---|--- 网页应用 | `网络` iOS 应用 | `iOS` Java 应用程序 | `Java` Node.js 应用 | `NodeJS` .NET 应用程序 | 「捷运」其他| `其他` ## 网络测试地点位置 ID |地区 ---|--- `us-ca-sjc-azr` |美国西部 `us-tx-sn1-azr` |美国中南部 `us-il-ch1-azr` |美国中北部 `us-va-ash-azr` |美国东部 `emea-gb-db3-azr` |英国南部 `emea-nl-ams-azr` |西欧 `emea-fr-pra-edge` |法国中部 `apac-sg-sin-azr` |东南亚 `apac-hk-hkn-azr` |东亚 `apac-jp-kaw-edge` |日本东 `latam-br-gru-edge` |巴西南部 `emea-au-syd-edge` |澳大利亚东部 ## 最佳实践 1. **使用基于工作区的** — 基于工作区的 App Insights 是当前标准 2. **链接到 Log Analytics** — 将数据存储在 Log Analytics 中以便更好地查询 3. **设置适当的保留** — 平衡成本与数据可用性 4. **使用采样** — 降低大批量应用的成本 5. **安全地存储连接字符串** — 使用 Key Vault 或托管身份 6. **启用多个测试位置** — 进行准确的可用性监控 7. **使用工作簿** — 用于自定义仪表板和分析 8. **设置警报** — 基于可用性测试和指标 9. **标记资源** — 用于成本分配和组织 10. **使用私有端点** - 用于安全数据摄取 ## 错误处理使用 Azure；尝试 { ArmOperation 操作 = 等待组件 .CreateOrUpdateAsync(WaitUntil.Completed, "my-appinsights", data); } 当（ex.Status == 409）时捕获（RequestFailedException ex） { Console.WriteLine("组件已经存在"); } 当（ex.Status == 400）时捕获（RequestFailedException ex） { Console.WriteLine($"无效配置：{ex.Message}"); } 捕获（RequestFailedException 前） { Console.WriteLine($"Azure 错误：{ex.Status} - {ex.Message}"); } ## SDK集成将连接字符串与 Application Insights SDK 结合使用： // ASP.NET Core 中的 Program.cs builder.Services.AddApplicationInsightsTelemetry（选项=> { options.ConnectionString = 配置["ApplicationInsights:ConnectionString"]; }); // 或者通过环境变量设置 // APPLICATIONINSIGHTS_CONNECTION_STRING=InstrumentationKey=...;IngestionEndpoint=... ## 相关SDK SDK |目的|安装 ---|---|--- `Azure.ResourceManager.ApplicationInsights` |资源管理（此 SDK）| `dotnet 添加包 Azure.ResourceManager.ApplicationInsights` `Microsoft.ApplicationInsights` |遥测SDK | `dotnet 添加包 Microsoft.ApplicationInsights` `Microsoft.ApplicationInsights.AspNetCore` | ASP.NET Core 集成 | `dotnet 添加包 Microsoft.ApplicationInsights.AspNetCore` `Azure.Monitor.OpenTelemetry.Exporter` |打开遥测导出 | `dotnet 添加包 Azure.Monitor.OpenTelemetry.Exporter` ## 参考链接资源 |网址 ---|--- NuGet 包 | API 参考 | 产品文档 | GitHub 来源 | ## 何时使用此技能适用于执行概述中描述的工作流程或操作。

Azure 管理 Applicationinsights Dotnet

包含技能