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

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

• Falhas - Rastreia erros, exceções e falhas, oferecendo informações claras para uma solução rápida de problemas e maior estabilidade.

• Desempenho - Identifica rapidamente e ajuda a resolver gargalos de aplicativos 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ções - Ajuda a identificar rapidamente problemas em componentes por meio de uma visão abrangente dos detalhes completos das transações.

Juntas, essas ferramentas garantem a integridade e a eficiência contínuas das aplicações web. Você pode usá-los para identificar problemas ou aprimoramentos que teriam mais impacto sobre os usuários.

Visão geral

Telemetria do filtro

Filtros predefinidos

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 nos valores de suas propriedades. As propriedades disponíveis dependem dos tipos de evento ou telemetria selecionados. Para adicionar um filtro:

1. Selecione para adicionar um filtro.

   

2. Na lista suspensa à 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 pretende filtrar.

   Observação

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

5. Para adicionar outro filtro, selecione novamente.

Telemetria de pesquisa

Usar dados analíticos

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

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

   

2. Essa ação leva você para a visualização Logs , onde você pode modificar ainda mais a consulta ou selecionar uma diferente na barra lateral.

   

Investigar telemetria

Analise 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 visualizações de página, operações do navegador e dependências. A recolha destes dados do navegador requer a adição de um script às suas páginas Web.

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

   

   Esta vista fornece um resumo visual de várias telemetrias da sua aplicação a partir da perspetiva do browser.

2. Para operações do navegador, a exibição de detalhes da transação de ponta a ponta mostra as Propriedades de Exibição de Página do cliente que solicita 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 tipos específicos de clientes.

   

Experiência de diagnóstico de transações

A experiência de diagnóstico de transações, também chamada de visualização de detalhes completos da transação, mostra um gráfico de Gantt da transação que lista todos os eventos com a 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 oferece suporte a vários recursos. O Application Insights deteta a relação subjacente e permite diagnosticar facilmente o componente, a dependência ou a exceção do aplicativo que causou uma lentidão ou falha na transação.

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

Esta vista tem quatro partes principais:

Anotações de versão

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

Anotações automáticas com o Azure Pipelines

O Azure Pipelines cria uma anotação de versão durante a implantação quando todas as seguintes condições 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 no estágio de implantação.

1. Abra um pipeline existente ou crie um novo e selecione uma tarefa em Estágios.

2. Adicione uma nova tarefa da CLI do Azure .

3. Selecione a assinatura do Azure. Defina Tipo de Script como PowerShell e Local do Script como Inline.

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

5. Adicione argumentos de script. Substitua espaços reservados entre 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 build e release. Selecione Guardar.

   -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 de versão de qualquer processo, sem o Azure DevOps.

1. Entre na CLI do Azure.

2. Salve o script a seguir 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>" }

Ver anotações

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

• Desempenho e falhas
• Utilização
• 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 Configurações Avançadas e selecione Mostrar anotações. Selecione qualquer marcador de anotação para abrir detalhes da versão, como solicitante, ramificação do controle do código-fonte, pipeline de liberação e ambiente.

Perguntas frequentes

Esta secção fornece respostas a perguntas comuns.

Pesquisa de transações

Diagnóstico de transações

Próximos passos

• Saiba mais sobre como usar o Mapa de Aplicativos para identificar gargalos de desempenho e pontos críticos de falha em todos os componentes do seu aplicativo.
• Saiba mais sobre como usar o modo de exibição Disponibilidade para configurar testes recorrentes para monitorar a disponibilidade e a capacidade de resposta do seu aplicativo.
• Saiba como usar o Log Analytics e escrever consultas complexas para obter informações mais detalhadas de seus dados de telemetria.
• Saiba como enviar logs e telemetria personalizada para o Application Insights para um monitoramento mais abrangente.
• Para obter uma introdução ao monitoramento do tempo de atividade e da capacidade de resposta, consulte a Visão geral da disponibilidade.