Untersuchen von Fehlern, Leistung und Transaktionen mit Application Insights

Application Insights sammelt Telemetrie aus Ihrer Anwendung, um Fehler zu diagnostizieren und langsame Transaktionen zu untersuchen. Es umfasst vier wesentliche Tools:

• Fehler – Verfolgt Fehlfunktionen, Ausnahmen und Störungen und bietet klare Analysen für schnelle Problemlösung und verbesserte Stabilität.

• Leistung – Identifiziert und hilft beim Beheben von Anwendungsengpässen, indem Reaktionszeiten und Betriebsanzahlen angezeigt werden.

• Transaktionssuche – Ermöglicht Benutzern das Suchen und Untersuchen einzelner Telemetrieelemente wie Seitenansichten, Ausnahmen und benutzerdefinierte Ereignisse.

• Transaktionsdiagnose – Hilft bei der schnellen Identifizierung von Problemen in Komponenten durch umfassende Einblicke in End-to-End-Transaktionsdetails.

Gemeinsam sorgen diese Tools für die kontinuierliche Integrität und Effizienz von Webanwendungen. Sie können sie verwenden, um Probleme oder Verbesserungen festzustellen, die die größte Wirkung auf die Benutzer hätten.

Überblick

Filtern von Telemetriedaten

Standardfilter

Mit allen Funktionen können Sie Telemetrie innerhalb eines Zeitrahmens filtern. Darüber hinaus verfügt jede Oberfläche über einen eigenen Standardfilter:

Hinzufügen von Filtern

Sie können Ereignisse anhand der Werte ihrer Eigenschaften filtern. Die verfügbaren Eigenschaften hängen von den ausgewählten Ereignis- oder Telemetrietypen ab. So fügen Sie einen Filter hinzu:

1. Wählen Sie aus, um einen Filter hinzuzufügen.

   

2. Wählen Sie in der linken Dropdownliste eine Eigenschaft aus.

3. Wählen Sie in der mittleren Dropdownliste einen der folgenden Operatoren aus: =, , !=, , containsoder not contains.

4. Wählen Sie in der rechten Dropdownliste alle Eigenschaftswerte aus, nach der Sie filtern möchten.

   Hinweis

   Beachten Sie, dass die Zahlen rechts neben den Filterwerten anzeigen, wie viele Vorkommen es in der aktuell gefilterten Gruppe gibt.

5. Wenn Sie einen anderen Filter hinzufügen möchten, wählen Sie das .

Suchtelemetrie

Verwenden von Analysedaten

Alle von Application Insights gesammelten Daten werden in Log Analytics gespeichert. Es stellt eine umfangreiche Abfragesprache bereit, um die Anforderungen zu analysieren, die die von Ihnen untersuchte Ausnahme generiert haben.

1. Wählen Sie in der oberen Navigationsleiste entweder in der Leistungs-, Fehler- oder Transaktionssuchansicht die Option "In Protokollen anzeigen " aus, und wählen Sie eine Abfrage aus dem Dropdownmenü aus.

   

2. Mit dieser Aktion gelangen Sie zur Protokollansicht , in der Sie die Abfrage weiter ändern oder eine andere von der Randleiste auswählen können.

   

Telemetriedaten untersuchen

Analysieren der clientseitigen Leistung und Fehler

Wenn Sie Ihre Webseiten mit Application Insights instrumentieren, können Sie Einblicke in Seitenansichten, Browservorgänge und Abhängigkeiten erhalten. Das Sammeln dieser Browserdaten erfordert das Hinzufügen eines Skripts zu Ihren Webseiten.

1. Nachdem Sie das Skript hinzugefügt haben, können Sie auf Seitenansichten und die zugehörigen Leistungsmetriken zugreifen, indem Sie in der Ansicht "Leistung" oder "Fehler" den Schalter "Browser" auswählen.

   

   Diese Ansicht bietet eine visuelle Zusammenfassung verschiedener Telemetriedaten Ihrer Anwendung aus der Perspektive des Browsers.

2. Bei Browservorgängen zeigt die End-to-End-Transaktionsdetails die Eigenschaften der Seitenansicht des Clients an, der die Seite anfordert, einschließlich des Browsertyps und dessen Standort. Anhand dieser Informationen kann ermittelt werden, ob Leistungsprobleme im Zusammenhang mit bestimmten Clienttypen auftreten.

   

Oberfläche zur Transaktionsdiagnose

Die Transaktionsdiagnoseansicht , die auch als End-to-End-Transaktionsdetails bezeichnet wird, zeigt ein Gantt-Diagramm der Transaktion an, das alle Ereignisse mit ihrer Dauer und dem Antwortcode auflistet.

Diese Diagnoseumgebung korreliert automatisch serverseitige Telemetrie aus allen überwachten Application Insights-Komponenten in einer einzigen Ansicht und unterstützt mehrere Ressourcen. Application Insights erkennt die zugrundeliegende Beziehung und ermöglicht Ihnen die komfortable Diagnose der Anwendungskomponente, Abhängigkeit oder Ausnahme, die zur langsamen Ausführung oder einem Fehler bei einer Transaktion geführt hat.

Wenn Sie ein bestimmtes Ereignis auswählen, werden seine Eigenschaften angezeigt, einschließlich zusätzlicher Informationen wie dem zugrunde liegenden Befehl oder Aufrufstapel.

Diese Ansicht enthält vier wichtige Teile:

Anmerkungen freigeben

Freigabeanmerkungen markieren Bereitstellungen und andere wichtige Ereignisse in Application Insights-Diagrammen und ermöglichen die Korrelation von Änderungen mit Leistung, Fehlern und Verwendung.

Automatische Anmerkungen mit Azure-Pipelines

Azure Pipelines erstellt während der Bereitstellung eine Freigabeanmerkung, wenn alle folgenden Bedingungen erfüllt sind:

Konfigurieren von Anmerkungen in einer Pipeline mithilfe eines Inlineskripts

Wenn Sie die Aufgaben im vorherigen Abschnitt nicht verwenden, fügen Sie in der Bereitstellungsphase ein Inlineskript hinzu.

1. Öffnen Sie eine vorhandene Pipeline, oder erstellen Sie eine neue, und wählen Sie unter "Phasen" eine Aufgabe aus.

2. Fügen Sie eine neue Azure CLI-Aufgabe hinzu.

3. Wählen Sie das Azure-Abonnement aus. Legen Sie den Skripttyp auf PowerShell fest, und legen Sie den Skriptspeicherort auf "Inline" fest.

4. Fügen Sie das PowerShell-Skript aus Schritt 2 in Create release annotations with the Azure CLI to Inline Script hinzu.

5. Fügen Sie Skriptargumente hinzu. Ersetzen Sie Platzhalter in winkeln Klammern.

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

   Das folgende Beispiel zeigt Metadaten, die Sie im optionalen releaseProperties Argument festlegen können, indem Sie Build- und Releasevariablen verwenden. Wählen Sie Speichern aus.

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

Erstellen von Releaseanmerkungen mit der Azure CLI

Verwenden Sie das folgende PowerShell-Skript, um eine Freigabeanmerkung aus einem beliebigen Prozess ohne Azure DevOps zu erstellen.

1. Melden Sie sich bei der Azure CLI an.

2. Speichern Sie das folgende Skript als 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
   

Rufen Sie das Skript auf und übergeben Sie Werte für die Parameter. Der Parameter -releaseProperties ist optional.

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

Anmerkungen anzeigen

Application Insights zeigt Freigabeanmerkungen in den folgenden Oberflächen an:

• Leistung und Fehler
• Verwendung
• Arbeitsmappen (für jede Zeitreihenvisualisierung)

Anmerkungen werden als Markierungen am oberen Rand von Diagrammen visualisiert.

Um Anmerkungen in einer Arbeitsmappe zu aktivieren, öffnen Sie erweiterte Einstellungen , und wählen Sie dann " Anmerkungen anzeigen" aus. Wählen Sie eine Anmerkungsmarkierung aus, um Versionsdetails wie Anforderer, Quellcodeverwaltungs-Verzweigung, Releasepipeline und Umgebung zu öffnen.

Häufig gestellte Fragen

Dieser Abschnitt enthält Antworten auf häufig gestellte Fragen.

Transaktionssuche

Transaktionsdiagnose

Nächste Schritte

• Erfahren Sie mehr über die Verwendung der Anwendungszuordnung, um Leistungsengpässe und Fehler-Hotspots in allen Komponenten Ihrer Anwendung zu erkennen.
• Erfahren Sie mehr über die Verwendung der Verfügbarkeitsansicht, um wiederkehrende Tests einzurichten, um die Verfügbarkeit und Reaktionsfähigkeit Ihrer Anwendung zu überwachen.
• Erfahren Sie , wie Sie Log Analytics verwenden und komplexe Abfragen schreiben , um tiefere Einblicke aus Ihren Telemetriedaten zu erhalten.
• Erfahren Sie, wie Sie Protokolle und benutzerdefinierte Telemetrie an Application Insights senden , um eine umfassendere Überwachung zu erhalten.
• Eine Einführung in die Überwachung der Betriebszeit und Reaktionsfähigkeit finden Sie in der Verfügbarkeitsübersicht.