Изучение сбоев, производительности и транзакций с помощью Application Insights

Application Insights собирает данные телеметрии из приложения, чтобы помочь диагностировать ошибки и исследовать медленные транзакции. Он включает четыре основных средства:

• Сбои — отслеживает ошибки, исключения и ошибки, предлагая четкие аналитические сведения для быстрого решения проблем и повышенной стабильности.

• Производительность — быстро идентифицирует и помогает устранить узкие места приложения, отображая время отклика и количество операций.

• Поиск транзакций — позволяет пользователям находить и проверять отдельные элементы телеметрии, такие как представления страниц, исключения и пользовательские события.

• Диагностика транзакций — помогает быстро выявлять проблемы в компонентах с помощью комплексной информации о транзакциях.

Вместе эти средства обеспечивают постоянную работоспособность и эффективность веб-приложений. Их можно использовать для выявления проблем или улучшений, которые будут оказывать наибольшее влияние на пользователей.

Обзор

Фильтрация телеметрии

Фильтры по умолчанию

Все возможности позволяют фильтровать данные телеметрии по диапазону времени. Кроме того, каждый опыт поставляется с собственным фильтром по умолчанию.

Добавление фильтров

Можно фильтровать события по значениям их свойств. Доступные свойства зависят от выбранных типов событий или телеметрии. Чтобы добавить фильтр, выполните приведенные действия.

1. Щелкните , чтобы добавить фильтр.

   

2. В раскрывающемся списке слева выберите свойство.

3. В раскрывающемся списке центра выберите один из следующих операторов: =, !=, contains, или not contains.

4. В раскрывающемся списке справа выберите все значения свойств, которые нужно отфильтровать.

   Замечание

   Обратите внимание, что счетчики справа от значений фильтра показывают число вхождений в текущем отфильтрованном наборе.

5. Чтобы добавить другой фильтр, снова выберите .

Телеметрия поиска

Использование аналитических данных

Все данные, собранные Application Insights, хранятся в Log Analytics. Он предоставляет широкий язык запросов для анализа запросов, которые создали исключение, которое вы изучаете.

1. В представлении "Производительность,сбои" или "Поиск транзакций" выберите "Вид в журналах " в верхней панели навигации и выберите запрос в раскрывающемся меню.

   

2. Это действие отправляет вас в представление журналов , где можно дополнительно изменить запрос или выбрать другой из боковой панели.

   

Изучение телеметрии

Анализ производительности и сбоев на стороне клиента

Если вы инструментируйте веб-страницы с помощью Application Insights, вы можете получить представление о представлениях страниц, операциях браузера и зависимостях. Сбор данных браузера требует добавления скрипта на веб-страницы.

1. После добавления скрипта вы можете получить доступ к представлениям страниц и связанным с ними метрикам производительности, выбрав браузер , переключив переключатель в представлении "Производительность " или " Сбои ".

   

   Это представление содержит визуальную сводку по различным телеметриям приложения с точки зрения браузера.

2. Для операций браузера в представлении сведений о сквозных транзакциях показываются свойства просмотра страницы для клиента, запрашивающего страницу, включая тип браузера и его местоположение. Эти сведения могут помочь определить, существуют ли проблемы с производительностью, связанные с определенными типами клиентов.

   

Интерфейс диагностики транзакций

В режиме диагностики транзакций, также называемом представлением сведений о сквозных транзакциях , показана диаграмма Ганта транзакции, в которой перечислены все события с их длительностью и кодом ответа.

Этот интерфейс диагностики автоматически сопоставляет данные телеметрии на стороне сервера во всех отслеживаемых компонентах Application Insights в одном представлении и поддерживает несколько ресурсов. Application Insights определяет базовые связи и позволяет легко диагностировать компоненты приложения, зависимости или исключения, вызвавшие замедление или сбой выполнения транзакции.

Выбор определенного события показывает его свойства, включая дополнительные сведения, такие как базовая команда или стек вызовов.

Это представление состоит из четырех ключевых частей:

Заметки о выпуске

Заметки о выпуске помечают развертывания и другие важные события на диаграммах Application Insights, позволяя корреляции изменений с производительностью, сбоями и использованием.

Автоматические заметки с помощью Azure Pipelines

Azure Pipelines создает заметку о выпуске во время развертывания, если выполняются все следующие условия:

Настройка заметок в конвейере с помощью встроенного скрипта

Если вы не используете задачи в предыдущем разделе, добавьте встроенный сценарий на этапе развертывания.

1. Откройте существующий конвейер или создайте новую и выберите задачу в разделе "Этапы".

2. Добавьте новую задачу Azure CLI .

3. Выберите подписку Azure. Задайте для типа скрипта значениеPowerShell и задайте значение "Расположение скрипта" в качестве встроенного.

4. Добавьте сценарий PowerShell из шага 2 в заметках о выпуске с помощью Azure CLI в встроенный скрипт.

5. Добавьте аргументы скрипта. Замените заполнители в угловых скобках.

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

   В следующем примере показаны метаданные, которые можно задать в необязательном 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.azure.com$($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 для более полного мониторинга.
• Общие сведения о мониторинге времени простоя и реагирования см. в обзоре доступности.