Investigar falhas, desempenho e transações com o Application Insights

O Application Insights coleta telemetria de seu aplicativo para ajudar a diagnosticar falhas e investigar transações lentas. Ele inclui quatro ferramentas essenciais:

• Falhas – rastreia erros, exceções e falhas, oferecendo insights claros para resolução rápida de problemas e estabilidade aprimorada.

• Desempenho – Identifica rapidamente e ajuda a resolver gargalos de aplicativo exibindo tempos de resposta e contagens de operações.

• Pesquisa de transações – permite que os usuários localizem e examinem itens de telemetria individuais, como exibições de página, exceções e eventos personalizados.

• Diagnóstico de transação – ajuda a identificar rapidamente problemas em componentes por meio de uma visão abrangente dos detalhes da transação de ponta a ponta.

Juntas, essas ferramentas garantem a integridade e a eficiência contínuas dos aplicativos Web. Você pode usá-los para identificar problemas ou aprimoramentos que teriam mais impacto sobre os usuários.

Visão geral

Filtrar telemetria

Filtros padrão

Todas as experiências permitem filtrar a telemetria por intervalo de tempo. Além disso, cada experiência vem com seu próprio filtro padrão:

Adicionar filtros

Você pode filtrar eventos pelos valores de suas propriedades. As propriedades disponíveis dependem dos tipos de evento ou telemetria que você selecionou. Para adicionar um filtro:

1. Selecione para adicionar um filtro.

   

2. No menu suspenso à esquerda, selecione uma propriedade.

3. Na lista suspensa central, selecione um dos seguintes operadores: =, !=, contains ou not contains.

4. Na lista suspensa à direita, selecione todos os valores de propriedade que você deseja usar como filtro.

   Observação

   Observe que as contagens à direita dos valores de filtro mostram quantas ocorrências existem no atual conjunto filtrado.

5. Para adicionar outro filtro, selecione novamente.

Como pesquisar telemetria

Usar dados de análise

Todos os dados coletados pelo Application Insights são armazenados no Log Analytics. Ele oferece uma linguagem de consulta avançada para analisar as solicitações que geraram a exceção que você está investigando.

1. No modo de exibição de desempenho, de falhas ou de pesquisa de transações, selecione Exibir em Logs na barra de navegação superior e escolha uma consulta no menu suspenso.

   

2. Esta ação leva você à exibição Logs, onde é possível modificar ainda mais a consulta ou selecionar outra na barra lateral.

   

Investigar telemetria

Analisar o desempenho e as falhas do lado do cliente

Se você instrumentar suas páginas da Web com o Application Insights, poderá obter visibilidade sobre exibições de página, operações de navegador e dependências. Coletar esses dados do navegador requer a adição de um script às páginas da Web.

1. Depois de adicionar o script, você pode acessar exibições de página e suas métricas de desempenho associadas selecionando a alternância navegador na exibição Desempenho ou Falhas .

   

   Essa exibição fornece um resumo visual de várias telemetrias do aplicativo da perspectiva do navegador.

2. Para operações de navegador, a exibição de detalhes da transação de ponta a ponta mostra as Propriedades de Exibição de Página do cliente solicitando a página, incluindo o tipo de navegador e sua localização. Essas informações podem ajudar a determinar se há problemas de desempenho relacionados a determinados tipos de clientes.

   

Experiência de diagnóstico de transação

A experiência de diagnóstico de transação , também chamada de exibição de detalhes da transação de ponta a ponta , mostra um gráfico de Gantt da transação, que lista todos os eventos com sua duração e código de resposta.

Essa experiência de diagnóstico correlaciona automaticamente a telemetria do lado do servidor de todos os componentes monitorados do Application Insights em uma única exibição e dá suporte a vários recursos. O Application Insights detecta o relacionamento subjacente e permite diagnosticar facilmente o componente, a dependência ou a exceção do aplicativo que causou uma desaceleração ou falha na transação.

Selecionar um evento específico revela suas propriedades, incluindo informações adicionais, como o comando subjacente ou a pilha de chamadas.

Essa exibição tem quatro partes principais:

Anotações de versão

As anotações sobre a versão marcam implantações e outros eventos importantes nos gráficos do Application Insights, permitindo a correlação de alterações com desempenho, falhas e uso.

Anotações automáticas com Azure Pipelines

Azure Pipelines cria uma anotação sobre a versão durante a implantação quando todas as condições a seguir forem verdadeiras:

Configurar anotações em um pipeline usando um script embutido

Se você não usar as tarefas da seção anterior, adicione um script embutido na fase de implantação.

1. Abra um pipeline existente ou crie outro e selecione uma tarefa em Fases.

2. Adicione uma nova tarefa CLI do Azure.

3. Selecione a Assinatura do Azure. Defina Tipo de Script como PowerShell e Local do Script como Embutido.

4. Adicione o script do PowerShell da etapa 2 em Criar anotações sobre a versão com a CLI do Azure a Script Embutido.

5. Adicionar argumentos de script. Substitua os espaços reservados nos colchetes angulares.

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

   O exemplo a seguir mostra metadados que você pode definir no argumento opcional releaseProperties usando variáveis de build e de versão. Clique em Salvar.

   -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)" }
   

Criar anotações de versão com a CLI do Azure

Use o seguinte script do PowerShell para criar uma anotação sobre a versão de qualquer processo, sem Azure DevOps.

1. Entre na CLI do Azure.

2. Salve o seguinte script como 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
   

Chame o script e passe valores para os parâmetros. O -releaseProperties parâmetro é opcional.

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

Exibir anotações

O Application Insights exibe anotações sobre a versão nas seguintes experiências:

• Desempenho e Falhas
• Uso
• Pastas de Trabalho (para qualquer visualização de série temporal)

As anotações são visualizadas como marcadores na parte superior dos gráficos.

Para habilitar anotações em uma pasta de trabalho, abra as Configurações Avançadas e selecione Mostrar anotações. Selecione qualquer marcador de anotação para abrir os detalhes da versão, como solicitante, ramificação do controle do código-fonte, pipeline de lançamento e ambiente.

Perguntas frequentes

Esta seção fornece respostas para perguntas comuns.

Pesquisa de transação

Diagnóstico de transação

Próximas etapas

• Saiba mais sobre como usar o Mapa do Aplicativo para detectar gargalos de desempenho e hotspots de falha em todos os componentes do seu aplicativo.
• Saiba mais sobre como usar a exibição Disponibilidade para configurar testes recorrentes, a fim de monitorar a disponibilidade e a capacidade de resposta do aplicativo.
• Saiba como usar o Log Analytics e gravar consultas complexas para obter insights mais profundos dos dados de telemetria.
• Saiba como enviar logs e telemetria personalizada ao Application Insights para monitoramento mais abrangente.
• Para obter uma introdução ao monitoramento de tempo de atividade e capacidade de resposta, consulte a visão geral da disponibilidade.