使用 Application Insights 调查故障、性能和事务

Application Insights 从应用程序收集遥测数据，以帮助诊断故障并分析事务处理速度缓慢的原因。 它包括四个基本工具：

• 故障视图 - 跟踪错误、异常和故障，提供快速解决问题和增强稳定性的清晰见解。

• 性能视图 - 通过显示响应时间和作计数快速识别和帮助解决应用程序瓶颈。

• 搜索视图 - 允许用户查找和检查各个遥测项，例如页面视图、异常和自定义事件。

• 事务诊断 - 通过全面深入了解端到端事务详细信息，帮助快速识别组件中的问题。

这些工具共同确保 Web 应用程序的持续运行状况和效率。 你可以使用它们来确定对用户影响最大的问题或增强功能。

概述

筛选遥测数据

默认筛选器

所有体验都允许按时间范围筛选遥测数据。 此外，每个体验都有其自己的默认筛选器：

添加筛选器

可以按事件的属性值筛选事件。 可用属性取决于所选的事件或遥测类型。 添加过滤器：

1. 选择 以添加筛选器。

   

2. 从左侧下拉列表中选择一个属性。

3. 在中心下拉列表中，选择以下运算符之一：=、!=、或containsnot contains。

4. 从右侧下拉列表中，选择要筛选的所有属性值。

   注释

   请注意，筛选器值右侧的计数显示当前筛选集合中出现了多少项。

5. 若要添加另一个筛选器，请再次选择 。

搜索遥测

使用分析数据

Application Insights 收集的所有数据都存储在 Log Analytics 中。 它提供丰富的查询语言，用于分析生成正在调查的异常的请求。

1. 在性能视图、故障视图或搜索视图中，选择顶部导航栏中的在日志中查看，并从下拉菜单中选择一个查询。

   

2. 此作会将你转到 “日志 ”视图，可以在其中进一步修改查询或从边栏中选择其他查询。

   

调查遥测

分析客户端性能和故障

如果将 Application Insights 集成到您的网页中，则可以获取关于页面视图、浏览器操作和依赖项的洞察。 收集此浏览器数据需要 向网页添加脚本。

1. 添加脚本后，可以通过选择“性能”或“失败”视图上的“浏览器”开关来访问页面视图及其关联的性能指标。

   

   此视图从浏览器的角度提供应用程序的各种遥测数据的直观摘要。

   小窍门

   对于单页应用程序（SPA），请启用 enableAutoRouteTracking 路由更改，以便每个逻辑页创建自己的页面视图和操作。 否则，多个路由更改可以与单个操作相关联，某些页面视图持续时间可以显示为 0。

2. 对于浏览器操作，端到端事务详细信息视图显示客户端请求页面的页面视图属性，包括浏览器的类型及其位置。 此信息可以帮助确定是否存在与特定类型的客户端相关的性能问题。

   

交易诊断体验

事务诊断体验（也称为端到端事务详细信息视图）显示事务的甘特图，其中列出了所有事件及其持续时间和响应代码。

此诊断体验会自动将所有 Application Insights 监视组件中的服务器端遥测数据关联到单个视图中，并支持多个资源。 Application Insights 可检测基础关系，并可用于轻松诊断导致事务缓慢或失败的应用程序组件、依赖项或异常。

选择特定事件可显示其属性，包括基础命令或调用堆栈等其他信息。

此视图有四个关键部分：

版本注释

版本注释会标记 Application Insights 图表上的部署和其他重要事件，这样更改就会与性能、故障和使用情况相关联。

使用内联脚本在管道中配置注释

如果不使用上一部分中的任务，请在部署阶段添加内联脚本。

1. 打开现有管道或创建新管道，然后在“阶段”下选择任务。

2. 添加新的 Azure CLI 任务。

3. 选择 Azure 订阅。 将“脚本类型”设置为“PowerShell”，将“脚本位置”设置为“内联”。

4. 通过使用 Azure CLI 创建版本注释中的步骤 2 将 PowerShell 脚本添加到“内联脚本”。

5. 添加脚本参数。 替换尖括号中的占位符。

   -aiResourceId "<aiResourceId>" `
   -releaseName "<releaseName>" `
   -releaseProperties @{"ReleaseDescription"="<a description>";
       "TriggerBy"="<Your name>" }
   

   以下示例显示了可以使用 build 和 release 变量在可选的 releaseProperties 参数中设置的元数据。 选择“保存”。

   -releaseProperties @{
   "BuildNumber"="$(Build.BuildNumber)";
   "BuildRepositoryName"="$(Build.Repository.Name)";
   "BuildRepositoryProvider"="$(Build.Repository.Provider)";
   "ReleaseDefinitionName"="$(Build.DefinitionName)";
   "ReleaseDescription"="Triggered by $(Build.DefinitionName) $(Build.BuildNumber)";
   "ReleaseEnvironmentName"="$(Release.EnvironmentName)";
   "ReleaseId"="$(Release.ReleaseId)";
   "ReleaseName"="$(Release.ReleaseName)";
   "ReleaseRequestedFor"="$(Release.RequestedFor)";
   "ReleaseWebUrl"="$(Release.ReleaseWebUrl)";
   "SourceBranch"="$(Build.SourceBranch)";
   "TeamFoundationCollectionUri"="$(System.TeamFoundationCollectionUri)" }
   

使用 Azure CLI 创建发布注释

使用以下 PowerShell 脚本从任何进程创建版本注释，而无需使用 Azure DevOps。

1. 登录 Azure CLI。

2. 将以下脚本另存为 CreateReleaseAnnotation.ps1。

   param(
       [parameter(Mandatory = $true)][string]$aiResourceId,
       [parameter(Mandatory = $true)][string]$releaseName,
       [parameter(Mandatory = $false)]$releaseProperties = @()
   )
   
   # Function to ensure all Unicode characters in a JSON string are properly escaped
   function Convert-UnicodeToEscapeHex {
     param (
       [parameter(Mandatory = $true)][string]$JsonString
     )
     $JsonObject = ConvertFrom-Json -InputObject $JsonString
     foreach ($property in $JsonObject.PSObject.Properties) {
       $name = $property.Name
       $value = $property.Value
       if ($value -is [string]) {
         $value = [regex]::Unescape($value)
         $OutputString = ""
         foreach ($char in $value.ToCharArray()) {
           $dec = [int]$char
           if ($dec -gt 127) {
             $hex = [convert]::ToString($dec, 16)
             $hex = $hex.PadLeft(4, '0')
             $OutputString += "\u$hex"
           }
           else {
             $OutputString += $char
           }
         }
         $JsonObject.$name = $OutputString
       }
     }
     return ConvertTo-Json -InputObject $JsonObject -Compress
   }
   
   $annotation = @{
       Id = [GUID]::NewGuid();
       AnnotationName = $releaseName;
       EventTime = (Get-Date).ToUniversalTime().GetDateTimeFormats("s")[0];
       Category = "Deployment"; #Application Insights only displays annotations from the "Deployment" Category
       Properties = ConvertTo-Json $releaseProperties -Compress
   }
   
   $annotation = ConvertTo-Json $annotation -Compress
   $annotation = Convert-UnicodeToEscapeHex -JsonString $annotation
   
   $accessToken = (az account get-access-token | ConvertFrom-Json).accessToken
   $headers = @{
       "Authorization" = "Bearer $accessToken"
       "Accept"        = "application/json"
       "Content-Type"  = "application/json"
   }
   $params = @{
       Headers = $headers
       Method  = "Put"
       Uri     = "https://management.chinacloudapi.cn$($aiResourceId)/Annotations?api-version=2015-05-01"
       Body    = $annotation
   }
   Invoke-RestMethod @params
   

调用脚本并传递参数的值。 -releaseProperties 参数是可选的。

.\CreateReleaseAnnotation.ps1 `
 -aiResourceId "<aiResourceId>" `
 -releaseName "<releaseName>" `
 -releaseProperties @{"ReleaseDescription"="<a description>";
     "TriggerBy"="<Your name>" }

查看批注

Application Insights 在以下体验中显示版本注释：

• 性能和故障
• 用法
• 工作簿（适用于任何时序可视化效果）

批注将可视化为图表顶部的标记。

要在工作簿中启用注释，请打开“高级设置”，然后选择“显示注释”。 选择任何注释标记可打开发布详细信息，例如请求者、源代码管理分支、发布管道和环境。

常见问题

本部分提供常见问题的解答。

搜索视图

交易事务诊断

后续步骤

• 详细了解如何使用 应用程序映射 来发现应用程序的所有组件的性能瓶颈和故障热点。
• 详细了解如何使用 可用性视图 设置定期测试，以监视应用程序的可用性和响应能力。
• 了解如何使用 Log Analytics 并编写复杂的查询，以便从遥测数据中获得更深入的见解。
• 了解如何将 自定义遥测数据发送到 Application Insights ，以便进行更全面的监视。
• 有关监视运行时间和响应能力简介，请参阅 可用性概述。