Behandeln von Problemen beim Aktivieren des Application Insights-Momentaufnahmedebuggers oder Anzeigen von Momentaufnahmen

Wenn Sie den Application Insights-Momentaufnahmedebugger für Ihre Anwendung aktiviert haben, aber keine Momentaufnahmen für Ausnahmen angezeigt werden, können Sie diese Anweisungen zur Problembehandlung verwenden.

Es kann viele verschiedene Gründe geben, warum keine Momentaufnahmen generiert werden. Sie können zunächst die Integritätsprüfung für Momentaufnahmen ausführen, um einige der möglichen Ursachen zu ermitteln.

Nicht unterstützte Szenarien

In den folgenden Szenarios wird Snapshot Collector nicht unterstützt:

Stellen Sie sicher, dass Sie den richtigen Endpunkt für den Momentaufnahmedebugger verwenden.

Derzeit sind Azure Government und Microsoft Azure operated by 21Vianet die einzigen Regionen, für die Endpunktänderungen erforderlich sind.

Für App Service und Anwendungen, die das Application Insights SDK verwenden, müssen Sie die Verbindungszeichenfolge mithilfe den unterstützten Überschreibungen für den Momentaufnahmedebugger aktualisieren, wie unten gezeigt:

Weitere Informationen zu anderen Verbindungsüberschreibungen finden Sie in der Application Insights-Dokumentation.

Für Funktions-Apps müssen Sie die Datei host.json mithilfe der unterstützten Überschreibungen wie unten aktualisieren:

Im Folgenden finden Sie ein Beispiel für die Datei host.json, die mit dem Agent-Endpunkt der US Government-Cloud aktualisiert wurde:

{
  "version": "2.0",
  "logging": {
    "applicationInsights": {
      "samplingExcludedTypes": "Request",
      "samplingSettings": {
        "isEnabled": true
      },
      "snapshotConfiguration": {
        "isEnabled": true,
        "agentEndpoint": "https://snapshot.monitor.azure.us"
      }
    }
  }
}

Verwenden der Integritätsprüfung für Momentaufnahmen

Einige verbreitete Probleme führen dazu, dass „Debugmomentaufnahme öffnen“ nicht angezeigt wird. Beispiele wären etwa die Verwendung eines veralteten Snapshot Collectors, das Erreichen des täglichen Uploadlimits oder ein zeitaufwendiger Uploadvorgang für die Momentaufnahme. Verwenden Sie die Integritätsprüfung für Momentaufnahmen, um verbreitete Probleme zu behandeln.

Der Ausnahmenbereich der End-to-End-Überwachungsansicht enthält einen Link, über den Sie zur Integritätsprüfung für Momentaufnahmen gelangen.

Die interaktive, chatähnliche Oberfläche sucht nach verbreiteten Problemen und unterstützt Sie bei der Behebung.

Sollte sich das Problem dadurch nicht beheben lassen, lesen Sie die folgenden Schritte zur manuellen Problembehandlung:

Überprüfen des Instrumentierungsschlüssels

Vergewissern Sie sich, dass Sie in Ihrer veröffentlichten Anwendung den richtigen Instrumentierungsschlüssel verwenden. Der Instrumentierungsschlüssel wird in der Regel aus der Datei ApplicationInsights.config gelesen. Vergewissern Sie sich, dass der Wert dem Instrumentierungsschlüssel für die im Portal angezeigte Application Insights-Ressource entspricht.

Überprüfen der TLS/SSL-Clienteinstellungen (ASP.NET)

Wenn Sie auf einer VM über eine ASP.NET-Anwendung verfügen, die in Azure App Service oder IIS gehostet wird, kann Ihre Anwendung aufgrund eines fehlenden SSL-Sicherheitsprotokolls möglicherweise keine Verbindung mit dem Dienst „Momentaufnahmedebugger“ herstellen.

Der Endpunkt von Momentaufnahmedebugger erfordert die TLS-Version 1.2. Der Satz von SSL-Sicherheitsprotokollen ist eine der Eigenheiten, die durch den httpRuntime targetFramework-Wert im system.web-Abschnitt von web.config aktiviert wird. Wenn httpRuntime targetFramework die Version 4.5.2 oder niedriger aufweist, dann ist TLS 1.2 standardmäßig nicht enthalten.

<system.web>
   ...
   <httpRuntime targetFramework="4.7.2" />
   ...
</system.web>

Mehraufwandszenarios beim Momentaufnahmedebugger

Der Momentaufnahmedebugger ist für die Verwendung in Produktionsumgebungen vorgesehen. Zu den Standardeinstellungen gehören Ratenbegrenzungen, um die Auswirkungen auf Ihre Anwendungen zu minimieren.

Es kann jedoch zu geringem CPU-, Arbeitsspeicher- und E/A-Mehraufwand im Zusammenhang mit dem Momentaufnahmedebugger kommen, wie z. B. in den folgenden Szenarios:

Wenn eine Ausnahme in Ihrer Anwendung ausgelöst wird:

• Das Erstellen einer Signatur für den Problemtyp und die Entscheidung, ob eine Momentaufnahme erstellt werden soll, entsteht ein sehr geringer CPU- und Arbeitsspeichermehraufwand.
• Wenn die Deoptimierung aktiviert ist, gibt es einen Mehraufwand für das erneute Ausführen von JIT für die Methode, die die Ausnahme ausgelöst hat. Dies wird beim nächsten Ausführen dieser Methode passieren. Je nach Größe der Methode kann dies zwischen 1 ms und 100 ms CPU-Zeit sein.

Wenn der Ausnahmehandler angibt, eine Momentaufnahme zu erstellen:

• Das Erstellen der Prozessmomentaufnahme dauert etwa eine halbe Sekunde (P50 = 0,3 s, P90 = 1,2 s, P95 = 1,9 s), während der der Thread, der die Ausnahme ausgelöst hat, angehalten wird. Andere Threads werden nicht blockiert.

• Das Konvertieren der Prozessmomentaufnahme in einen Minidump und das Hochladen in Application Insights dauert mehrere Minuten.

  • Konvertieren: P50 = 63 s, P90 = 187 s, P95 = 275 s
  • Hochladen: P50 = 31 s, P90 = 75 s, P95 = 98 s

  Dies erfolgt in Snapshot Uploader und wird in einem separaten Prozess ausgeführt. Der Prozess „Snapshot Uploader“ wird unter der normalen CPU-Priorität ausgeführt und verwendet E/A mit niedriger Priorität.

  Der Minidump wird zuerst auf den Datenträger geschrieben. Der Speicherplatz des Datenträgers entspricht ungefähr dem Arbeitssatz des ursprünglichen Prozesses. Das Schreiben des Minidumps kann Seitenfehler auslösen, wenn der Speicher gelesen wird.

  Der Minidump wird während des Hochladens komprimiert, was sowohl CPU als auch Arbeitsspeicher im Snapshot Uploader-Prozess verbraucht. Der CPU-, Arbeitsspeicher- und Datenträgermehraufwand ist proportional zur Größe der Prozessmomentaufnahme. Snapshot Uploader verarbeitet Momentaufnahmen seriell.

Wenn TrackException aufgerufen wird:

Der Momentaufnahmedebugger überprüft, ob die Ausnahme neu ist oder ob eine Momentaufnahme dafür erstellt wurde. Dadurch entsteht ein sehr geringer CPU-Mehraufwand.

Vorschauversionen von .NET Core

Wenn Sie eine Vorschauversion von .NET Core verwenden oder Ihre Anwendung direkt oder indirekt über eine abhängige Assembly auf das Application Insights SDK verweist, befolgen Sie die Anweisungen zum Aktivieren des Momentaufnahmedebuggers für andere Umgebungen.

Überprüfen der Seite „Status“ der Websiteerweiterung für Diagnosedienste

Wenn der Momentaufnahmedebugger über den Bereich Application Insights im Portal aktiviert wurde, erfolgte die Aktivierung über die Websiteerweiterung für Diagnosedienste.

Sie können die Kudu-Verwaltungswebsite für App Service dazu verwenden, die Basis-URL dieser Statusseite abzurufen:

1. Öffnen Sie im Azure-Portal Ihre App Service-Anwendung.
2. Wählen Sie Erweiterte Tools aus, oder suchen Sie nach Kudu.
3. Klicken Sie auf Starten.
4. Nachdem Sie zur Kudu-Verwaltungswebsite navigiert sind, fügen Sie an die URL die Zeichenfolge /DiagnosticServices an und drücken dann die EINGABETASTE. Das Ergebnis sieht wie folgt aus: https://<kudu-url>/DiagnosticServices.

Upgraden auf die neueste Version des NuGet-Pakets

Abhängig von der Aktivierung des Momentaufnahmedebuggers gibt es folgende Optionen:

• Wenn der Momentaufnahmedebugger über den Application Insights-Bereich im Portal aktiviert wurde, sollte in Ihrer Anwendung bereits das aktuellste NuGet-Paket ausgeführt werden.

• Wurde der Momentaufnahmedebugger durch Einbinden des NuGet-Pakets Microsoft.ApplicationInsights.SnapshotCollector aktiviert, verwenden Sie den NuGet-Paket-Manager in Visual Studio, um sicherzustellen, dass Sie die neueste Version von Microsoft.ApplicationInsights.SnapshotCollector verwenden.

Informationen zu den neuesten Updates und Fehlerbehebungen finden Sie in den Versionshinweisen.

Überprüfen der Uploaderprotokolle

Nachdem eine Momentaufnahme erstellt wurde, wird eine Minidumpdatei (DMP) auf dem Datenträger erstellt. Diese Minidumpdatei wird durch einen separaten Uploaderprozess erstellt und zusammen mit allen dazugehörigen PDB-Dateien in den Speicher des Application Insights-Momentaufnahmedebuggers hochgeladen. Nachdem die Minidumpdatei erfolgreich hochgeladen wurde, wird sie vom Datenträger gelöscht. Die Protokolldateien für den Uploaderprozess bleiben auf dem Datenträger erhalten. In einer App Service-Umgebung finden Sie diese Protokolle unter D:\Home\LogFiles. Verwenden Sie die Verwaltungswebsite von Kudu für App Service, um nach diesen Protokolldateien zu suchen.

1. Öffnen Sie im Azure-Portal Ihre App Service-Anwendung.
2. Wählen Sie Erweiterte Tools aus, oder suchen Sie nach Kudu.
3. Klicken Sie auf Starten.
4. Wählen Sie in der Dropdownliste Debugging-Konsole die Option CMD aus.
5. Wählen Sie LogFiles aus.

Daraufhin sollte mindestens eine Datei mit einem Namen angezeigt werden, der mit Uploader_ oder SnapshotUploader_ beginnt und die Erweiterung .log aufweist. Wählen Sie das entsprechende Symbol aus, um Protokolldateien herunterzuladen oder in einem Browser zu öffnen. Der Dateiname enthält ein eindeutiges Suffix, mit dem die App Service-Instanz identifiziert wird. Wenn Ihre App Service-Instanz auf mehreren Computern gehostet wird, werden separate Protokolldateien für jeden Computer erstellt. Wenn der Uploader eine neue Minidumpdatei erkennt, wird diese in der Protokolldatei erfasst. Hier ist ein Beispiel für eine erfolgreiche Momentaufnahme und einen Upload angegeben:

SnapshotUploader.exe Information: 0 : Received Fork request ID 139e411a23934dc0b9ea08a626db16c5 from process 6368 (Low pri)
    DateTime=2018-03-09T01:42:41.8571711Z
SnapshotUploader.exe Information: 0 : Creating minidump from Fork request ID 139e411a23934dc0b9ea08a626db16c5 from process 6368 (Low pri)
    DateTime=2018-03-09T01:42:41.8571711Z
SnapshotUploader.exe Information: 0 : Dump placeholder file created: 139e411a23934dc0b9ea08a626db16c5.dm_
    DateTime=2018-03-09T01:42:41.8728496Z
SnapshotUploader.exe Information: 0 : Dump available 139e411a23934dc0b9ea08a626db16c5.dmp
    DateTime=2018-03-09T01:42:45.7525022Z
SnapshotUploader.exe Information: 0 : Successfully wrote minidump to D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp
    DateTime=2018-03-09T01:42:45.7681360Z
SnapshotUploader.exe Information: 0 : Uploading D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp, 214.42 MB (uncompressed)
    DateTime=2018-03-09T01:42:45.7681360Z
SnapshotUploader.exe Information: 0 : Upload successful. Compressed size 86.56 MB
    DateTime=2018-03-09T01:42:59.6184651Z
SnapshotUploader.exe Information: 0 : Extracting PDB info from D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp.
    DateTime=2018-03-09T01:42:59.6184651Z
SnapshotUploader.exe Information: 0 : Matched 2 PDB(s) with local files.
    DateTime=2018-03-09T01:42:59.6809606Z
SnapshotUploader.exe Information: 0 : Stamp does not want any of our matched PDBs.
    DateTime=2018-03-09T01:42:59.8059929Z
SnapshotUploader.exe Information: 0 : Deleted D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\139e411a23934dc0b9ea08a626db16c5.dmp
    DateTime=2018-03-09T01:42:59.8530649Z

Der Uploader sucht alle 15 Minuten nach neuen PDB-Dateien. Hier sehen Sie ein Beispiel:

SnapshotUploader.exe Information: 0 : PDB rescan requested.
    DateTime=2018-03-09T01:47:19.4457768Z
SnapshotUploader.exe Information: 0 : Scanning D:\home\site\wwwroot for local PDBs.
    DateTime=2018-03-09T01:47:19.4457768Z
SnapshotUploader.exe Information: 0 : Local PDB scan complete. Found 2 PDB(s).
    DateTime=2018-03-09T01:47:19.4614027Z
SnapshotUploader.exe Information: 0 : Deleted PDB scan marker : D:\local\Temp\Dumps\c12a605e73c44346a984e00000000000\6368.pdbscan
    DateTime=2018-03-09T01:47:19.4614027Z

Bei Anwendungen, die nicht in App Service gehostet werden, befinden sich die Uploaderprotokolle im selben Ordner wie die Minidumpdateien: %TEMP%\Dumps\<ikey> (<ikey> steht hierbei für Ihren Instrumentierungsschlüssel).

Problembehandlung bei Cloud Services

In Cloud Services ist der standardmäßige temporäre Ordner möglicherweise zu klein, um die Minidump-Dateien zu speichern, was dazu führt, dass Momentaufnahmen verloren gehen.

Der erforderliche Speicherplatz hängt vom gesamten Arbeitssatz Ihrer Anwendung und der Anzahl gleichzeitiger Momentaufnahmen ab.

Der Arbeitssatz einer 32-Bit-ASP.NET-Webrolle liegt in der Regel zwischen 200 MB und 500 MB. Lassen Sie mindestens zwei gleichzeitige Momentaufnahmen zu.

Wenn Ihre Anwendung beispielsweise 1 GB des gesamten Arbeitssatzes verwendet, sollten Sie sicherstellen, dass ein Speicherplatz von mindestens 2 GB zum Speichern von Momentaufnahmen zur Verfügung steht.

Führen Sie die folgenden Schritte aus, um Ihre Clouddienstrolle mit einer dedizierten lokalen Ressource für Momentaufnahmen zu konfigurieren.

1. Fügen Sie Ihrem Clouddienst eine neue lokale Ressource hinzu, indem Sie die Clouddienst-Definitionsdatei (.csdef) bearbeiten. Im folgenden Beispiel wird eine Ressource namens SnapshotStore mit einer Größe von 5 GB definiert.

   <LocalResources>
     <LocalStorage name="SnapshotStore" cleanOnRoleRecycle="false" sizeInMB="5120" />
   </LocalResources>
   

2. Ändern Sie den Startcode Ihrer Rolle, um eine Umgebungsvariable hinzuzufügen, die auf die lokale Ressource SnapshotStore zeigt. Für Workerrollen sollte der Code der OnStart-Methode Ihrer Rolle hinzugefügt werden:

   public override bool OnStart()
   {
       Environment.SetEnvironmentVariable("SNAPSHOTSTORE", RoleEnvironment.GetLocalResource("SnapshotStore").RootPath);
       return base.OnStart();
   }
   

   Für Webrollen (ASP.NET) sollte der Code der Application_Start-Methode Ihrer Webanwendung hinzugefügt werden:

   using Microsoft.WindowsAzure.ServiceRuntime;
   using System;
   namespace MyWebRoleApp
   {
       public class MyMvcApplication : System.Web.HttpApplication
       {
          protected void Application_Start()
          {
             Environment.SetEnvironmentVariable("SNAPSHOTSTORE", RoleEnvironment.GetLocalResource("SnapshotStore").RootPath);
             // TODO: The rest of your application startup code
          }
       }
   }
   

3. Aktualisieren Sie die Datei ApplicationInsights.config Ihrer Rolle, um den von SnapshotCollector verwendeten Speicherort des temporären Ordners zu überschreiben.

   <TelemetryProcessors>
    <Add Type="Microsoft.ApplicationInsights.SnapshotCollector.SnapshotCollectorTelemetryProcessor, Microsoft.ApplicationInsights.SnapshotCollector">
      <!-- Use the SnapshotStore local resource for snapshots -->
      <TempFolder>%SNAPSHOTSTORE%</TempFolder>
      <!-- Other SnapshotCollector configuration options -->
    </Add>
   </TelemetryProcessors>
   

Überschreiben des Momentaufnahmeordners

Wenn der Snapshot Collector gestartet wird, versucht er, einen Ordner auf dem Datenträger zu finden, der für die Ausführung des Snapshot Uploader-Prozesses geeignet ist. Der ausgewählte Ordner wird als Momentaufnahmeordner bezeichnet.

Der Snapshot Collector überprüft einige bekannte Speicherorte und stellt dabei sicher, dass er über die Berechtigungen zum Kopieren der Binärdateien für den Snapshot Uploader verfügt. Folgende Umgebungsvariablen werden verwendet:

• Fabric_Folder_App_Temp
• LOCALAPPDATA
• APPDATA
• TEMP

Kann kein geeigneter Ordner gefunden werden, meldet Snapshot Collector einen Fehler, dass kein geeigneter Momentaufnahmeordner gefunden wurde.

Bei einem fehlerhaften Kopiervorgang meldet Snapshot Collector den Fehler ShadowCopyFailed.

Wenn der Uploader nicht gestartet werden kann, meldet Snapshot Collector den Fehler UploaderCannotStartFromShadowCopy. Der Text der Meldung enthält häufig System.UnauthorizedAccessException. Dieser Fehler tritt gewöhnlich auf, wenn die Anwendung unter einem Konto mit eingeschränkten Berechtigungen ausgeführt wird. Das Konto verfügt über die Berechtigung zum Schreiben in den Momentaufnahmeordner, aber es hat keine Berechtigung zum Ausführen von Code.

Da diese Fehler in der Regel während des Starts auftreten, folgt darauf meist der Fehler ExceptionDuringConnect, der aussagt, dass der Uploader nicht gestartet werden konnte.

Um diese Fehler zu umgehen, können Sie den Momentaufnahmeordner manuell über die Konfigurationsoption ShadowCopyFolder angeben. Sie können beispielsweise ApplicationInsights.config verwenden:

<TelemetryProcessors>
 <Add Type="Microsoft.ApplicationInsights.SnapshotCollector.SnapshotCollectorTelemetryProcessor, Microsoft.ApplicationInsights.SnapshotCollector">
   <!-- Override the default shadow copy folder. -->
   <ShadowCopyFolder>D:\SnapshotUploader</ShadowCopyFolder>
   <!-- Other SnapshotCollector configuration options -->
 </Add>
</TelemetryProcessors>

Oder Sie können appsettings.json mit einer .NET Core-Anwendung verwenden:

{
  "ApplicationInsights": {
    "InstrumentationKey": "<your instrumentation key>"
  },
  "SnapshotCollectorConfiguration": {
    "ShadowCopyFolder": "D:\\SnapshotUploader"
  }
}

Suchen nach Ausnahmen mit Momentaufnahmen über die Application Insights-Suche

Wenn eine Momentaufnahme erstellt wird, wird die auslösende Ausnahme mit einer Momentaufnahme-ID gekennzeichnet. Diese Momentaufnahme-ID ist als benutzerdefinierte Eigenschaft enthalten, wenn die Ausnahme an Application Insights gemeldet wird. In Application Insights können Sie über die Suche nach sämtlichen Datensätzen mit der benutzerdefinierten Eigenschaft ai.snapshot.id suchen.

1. Navigieren Sie im Azure-Portal zu Ihrer Application Insights-Ressource.
2. Klicken Sie auf Suchen.
3. Geben Sie in das Textfeld „Suchen“ ai.snapshot.id ein, und drücken Sie die Eingabetaste.

Wenn bei dieser Suche keine Ergebnisse zurückgegeben werden, wurden Application Insights im ausgewählten Zeitraum keine Momentaufnahmen gemeldet.

Um über die Uploaderprotokolle nach einer bestimmten Momentaufnahme-ID zu suchen, geben Sie die jeweilige ID in das Suchfeld ein. Wenn Sie für eine Momentaufnahme, die Ihres Wissens nach hochgeladen wurde, keine Datensätze finden können, gehen Sie folgendermaßen vor:

1. Vergewissern Sie sich, dass Sie die Suche in der richtigen Application Insights-Ressource durchführen, indem Sie den Instrumentierungsschlüssel überprüfen.

2. Passen Sie mithilfe des Zeitstempels aus dem Uploaderprotokoll den Filter „Zeitbereich“ an, um den jeweiligen Zeitbereich bei der Suche zu berücksichtigen.

Wenn trotzdem keine Ausnahme mit dieser Momentaufnahme-ID angezeigt wird, wurde Application Insights der Ausnahmedatensatz nicht gemeldet. Diese Situation kann vorkommen, wenn Ihre Anwendung abgestürzt ist, nachdem die Momentaufnahme erfasst wurde, jedoch bevor der Ausnahmedatensatz gemeldet wurde. Überprüfen Sie in diesem Fall die App Service-Protokolle unter Diagnose and solve problems, um festzustellen, ob unerwartete Neustarts oder Ausnahmefehler vorliegen.

Bearbeiten von Netzwerkproxy- oder Firewallregeln

Wenn Ihre Anwendung über einen Proxy oder über eine Firewall mit dem Internet verbunden ist, müssen Sie unter Umständen die Regeln aktualisieren, damit sie mit dem Momentaufnahmedebugger-Dienst kommunizieren kann.

Die vom Application Insights-Momentaufnahmedebugger verwendeten IP-Adressen sind im Azure Monitor-Diensttag enthalten. Weitere Informationen finden Sie in der Dokumentation zu Diensttags.

Fallen bei der Verwendung von Momentaufnahmen Abrechnungskosten an?

Es fallen keine Gebühren für Ihr Momentaufnahmedebugger-Abonnement an. Die gesammelten Momentaufnahmedateien werden getrennt von den Telemetriedaten gespeichert, die von den Application Insights SDKs erfasst werden, und es fallen keine Gebühren für die Erfassung oder Speicherung von Momentaufnahmen an.