Analizzare errori, prestazioni e transazioni con Application Insights

Application Insights raccoglie i dati di telemetria dall'applicazione per diagnosticare gli errori e analizzare le transazioni lente. Include quattro strumenti essenziali:

• Visualizzazione errori : tiene traccia degli errori, delle eccezioni e degli errori, offrendo informazioni chiare per risolvere rapidamente i problemi e migliorare la stabilità.

• Visualizzazione delle prestazioni : identifica e aiuta a risolvere i colli di bottiglia dell'applicazione visualizzando i tempi di risposta e i conteggi delle operazioni.

• Visualizzazione di ricerca : consente agli utenti di individuare ed esaminare singoli elementi di telemetria, ad esempio visualizzazioni pagina, eccezioni ed eventi personalizzati.

• Diagnostica delle transazioni : consente di identificare rapidamente i problemi nei componenti tramite informazioni dettagliate complete sui dettagli delle transazioni end-to-end.

Insieme, questi strumenti garantiscono l'integrità e l'efficienza in corso delle applicazioni Web. È possibile usarli per individuare problemi o miglioramenti che potrebbero avere l'impatto maggiore sugli utenti.

Informazioni generali

Filtrare i dati di telemetria

Filtri predefiniti

Tutte le esperienze consentono di filtrare i dati di telemetria in base all'intervallo di tempo. Inoltre, ogni esperienza include un proprio filtro predefinito:

Aggiungi filtri

È possibile filtrare gli eventi in base ai valori delle relative proprietà. Le proprietà disponibili dipendono dai tipi di evento o telemetria selezionati. Per aggiungere un filtro:

1. Selezionare per aggiungere un filtro.

   

2. Nell'elenco a discesa a sinistra selezionare una proprietà.

3. Nell'elenco a discesa centrale selezionare uno degli operatori seguenti: =, !=, containso not contains.

4. Nell'elenco a discesa a destra selezionare tutti i valori delle proprietà da filtrare.

   Annotazioni

   Si noti che il numero a destra dei valori di filtro mostra quante occorrenze sono incluse nel set filtrato corrente.

5. Per aggiungere un altro filtro, selezionare di nuovo .

Ricerca dei dati di telemetria

Usare i dati di analisi

Tutti i dati raccolti da Application Insights vengono archiviati in Log Analytics. Fornisce un linguaggio di query avanzato per analizzare le richieste che hanno generato l'eccezione che si sta analizzando.

1. Nella visualizzazione delle prestazioni, dei errori o della ricerca, selezionare Visualizza nei Log nella barra di navigazione superiore e scegliere una query dal menu a discesa.

   

2. Questa azione consente di passare alla visualizzazione Log , in cui è possibile modificare ulteriormente la query o selezionarne una diversa dalla barra laterale.

   

Analizzare i dati di telemetria

Analizzare le prestazioni e i fallimenti dal lato del client

Se si instrumenta le pagine Web con Application Insights, è possibile ottenere visibilità sulle visualizzazioni pagina, sulle operazioni del browser e sulle dipendenze. La raccolta di questi dati del browser richiede l'aggiunta di uno script alle pagine Web.

1. Dopo aver aggiunto lo script, è possibile accedere alle visualizzazioni pagina e alle metriche delle prestazioni associate selezionando l'interruttore Browser nella visualizzazione Prestazioni o Errori .

   

   Questa visualizzazione fornisce un riepilogo visivo di vari telemetri dell'applicazione dal punto di vista del browser.

2. Per le operazioni del browser, la vista dei dettagli della transazione end-to-end mostra le proprietà di visualizzazione della pagina del client che effettua la richiesta della pagina, incluso il tipo di browser e la relativa posizione. Queste informazioni consentono di determinare se sono presenti problemi di prestazioni correlati a determinati tipi di client.

   

Esperienza di diagnostica delle transazioni

L'esperienza di diagnostica delle transazioni, detta anche visualizzazione dettagli delle transazioni end-to-end, mostra un diagramma di Gantt della transazione, che elenca tutti gli eventi con la relativa durata e il codice di risposta.

Questa esperienza di diagnostica correla automaticamente i dati di telemetria lato server da tutti i componenti monitorati di Application Insights in una singola visualizzazione e supporta più risorse. Application Insights rileva la relazione sottostante e consente di diagnosticare facilmente il componente, la dipendenza o l'eccezione dell'applicazione che ha causato un errore o un rallentamento nella transazione.

La selezione di un evento specifico rivela le relative proprietà, incluse informazioni aggiuntive come il comando sottostante o lo stack di chiamate.

Questa vista si suddivide in quattro parti principali:

Annotazioni del rilascio

Le annotazioni sulle versioni contrassegnano le distribuzioni e altri eventi significativi nei grafici di Application Insights, consentendo la correlazione delle modifiche con prestazioni, errori e utilizzo.

Annotazioni automatiche con Azure Pipelines

Azure Pipelines crea un'annotazione sulla versione durante la distribuzione quando vengono soddisfatte tutte le condizioni seguenti:

Configurare le annotazioni in una pipeline usando uno script inline

Se non si usano le attività nella sezione precedente, aggiungere uno script inline nella fase di distribuzione.

1. Aprire una pipeline esistente o crearne una nuova e selezionare un'attività in Fasi.

2. Aggiungere una nuova attività dell'interfaccia della riga di comando di Azure.

3. Selezionare l’abbonamento di Azure. Impostare Tipo di script su PowerShell e impostare Percorso script su Inline.

4. Aggiungere lo script di PowerShell del passaggio 2 in Creare annotazioni sulla versione con l'interfaccia della riga di comando di Azure a Script inline.

5. Aggiungere argomenti dello script. Sostituire i segnaposto tra parentesi acute.

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

   L'esempio seguente mostra i metadati che è possibile impostare nell'argomento facoltativo releaseProperties usando le variabili di compilazione e rilascio. Seleziona Salva.

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

Creare annotazioni di versione con l'interfaccia della riga di comando di Azure

Usare lo script di PowerShell seguente per creare un'annotazione sulla versione da qualsiasi processo, senza Azure DevOps.

1. Accedere a Interfaccia della riga di comando di Azure.

2. Salvare lo script seguente come 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
   

Applicare lo script e trasmettere i valori per i parametri. Il -releaseProperties parametro è facoltativo.

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

Visualizzare le annotazioni

Application Insights visualizza le annotazioni sulle versioni nelle esperienze seguenti:

• Prestazioni ed errori
• Utilizzo
• Cartelle di lavoro (per qualsiasi visualizzazione di serie temporale)

Le annotazioni vengono visualizzate come marcatori nella parte superiore dei grafici.

Per abilitare le annotazioni in una cartella di lavoro, aprire Impostazioni avanzate e quindi selezionare Mostra annotazioni. Selezionare un marcatore di annotazione per aprire i dettagli della versione, ad esempio richiedente, ramo di controllo del codice sorgente, pipeline di versione e ambiente.

Domande frequenti

Questa sezione fornisce le risposte alle domande comuni.

Visualizzazione di ricerca

Diagnostica delle transazioni

Passaggi successivi

• Scopri di più sull'uso di Application Map per individuare i colli di bottiglia delle prestazioni e gli hotspot di errore in tutti i componenti dell'applicazione.
• Altre informazioni sull'uso della visualizzazione Disponibilità per configurare test ricorrenti per monitorare la disponibilità e la velocità di risposta per l'applicazione.
• Informazioni su come usare Log Analytics e scrivere query complesse per ottenere informazioni più approfondite dai dati di telemetria.
• Informazioni su come inviare log e dati di telemetria personalizzati ad Application Insights per un monitoraggio più completo.
• Per un'introduzione al monitoraggio del tempo di attività e della velocità di risposta, vedere Panoramica della disponibilità.