Problembehandlung mit Azure-Diagnose

Dieser Artikel enthält Informationen zur Problembehandlung, die für die Verwendung der Azure-Diagnose relevant sind. Weitere Informationen zur Diagnose finden Sie unter Überblick über Azure-Diagnose.

Logische Komponenten

Die Komponenten sind:

• Startprogramm für Diagnose-Plug-In (DiagnosticsPluginLauncher.exe): Startet die Diagnoseerweiterung. Er dient als Prozess für den Einstiegspunkt.
• Diagnose-Plug-In (DiagnosticsPlugin.exe): Dient zum Konfigurieren, Starten und Verwalten der Lebensdauer des Monitoring Agent. Dies ist der Hauptprozess, der vom Startprogramm gestartet wird.
• Monitoring Agent (MonAgent*.exe-Prozesse): Dient zum Überwachen, Sammeln und Übertragen der Diagnosedaten.

Protokoll-/Artefaktpfade

Im Folgenden sind Pfade zu einigen wichtigen Protokollen und Artefakten angegeben. Wir verweisen im weiteren Verlauf des Artikels immer wieder auf diese Informationen.

Azure Cloud Services

Virtuelle Computer

Metrikdaten werden nicht im Azure-Portal angezeigt

Bei der Diagnose werden Metrikdaten bereitgestellt, die im Azure-Portal angezeigt werden können. Falls Sie Probleme beim Anzeigen der Daten im Portal haben, können Sie die Tabelle WADMetrics\* im Diagnosespeicherkonto überprüfen, um festzustellen, ob die entsprechenden Metrikdatensätze vorhanden sind, und um sicherzustellen, dass der Ressourcenanbieter „Microsoft.Insights“ registriert ist.

Hier ist der PartitionKey der Tabelle die Ressourcen-ID, der virtuelle Computer oder die VM-Skalierungsgruppe. RowKey ist der Metrikname. Er wird auch als Name des Leistungsindikators bezeichnet.

Wenn die Ressourcen-ID falsch ist, sollten Sie unter Diagnosekonfiguration>Metriken>ResourceId überprüfen, ob die Ressourcen-ID richtig festgelegt ist.

Wenn keine Daten für die spezifische Metrik vorhanden sind, sollten Sie unter Diagnosekonfiguration>PerformanceCounter überprüfen, ob die Metrik (Leistungsindikator) vorhanden ist. Die folgenden Leistungsindikatoren sind standardmäßig aktiviert:

• \Processor(_Total)% Processor Time
• \Memory\Verfügbare Bytes
• \ASP.NET-Anwendungen(Insgesamt)\Anforderungen/Sek.
• \ASP.NET-Anwendungen(Insgesamt)\Fehler gesamt/Sek.
• \ASP.NET\Anforderungen in Warteschlange
• \ASP.NET\Zurückgewiesene Anforderungen
• \Processor(w3wp)% Prozessorzeit
• \Prozess(w3wp)\Private Bytes
• \Process(WaIISHost)% Prozessorzeit
• \Prozess(WaIISHost)\Private Bytes
• \Process(WaWorkerHost)% Prozessorzeit
• \Prozess(WaWorkerHost)\Private Bytes
• \Arbeitsspeicher\Seitenfehler/Sek.
• .NET CLR-Speicher(Global)% Zeit in GC
• \Logischer Datenträger(C:)\Auf den Datenträger geschriebene Bytes/s
• \Logischer Datenträger(C:)\Vom Datenträger gelesene Bytes/s
• \Logischer Datenträger(D:)\Auf den Datenträger geschriebene Bytes/s
• \Logischer Datenträger(D:)\Vom Datenträger gelesene Bytes/s

Wenn die Konfiguration richtig festgelegt ist und die Metrikdaten trotzdem nicht angezeigt werden, können Sie sich als Hilfe bei der Problembehandlung an die folgenden Richtlinien halten.

Die Azure-Diagnose wird nicht gestartet.

Informationen dazu, warum die Diagnose nicht gestartet wurde, finden Sie in den Dateien DiagnosticsPluginLauncher.log und DiagnosticsPlugin.log am zuvor angegebenen Speicherort der Protokolldateien.

Die Angabe Monitoring Agent not reporting success after launch in diesen Protokollen bedeutet, dass beim Starten von MonAgentHost.exe ein Fehler aufgetreten ist. Sehen Sie sich die Protokolle an dem Speicherort an, der im obigen Abschnitt „Virtuelle Computer“ für MonAgentHost angegeben ist.

Die letzte Zeile der Protokolldateien enthält den Exitcode.

DiagnosticsPluginLauncher.exe Information: 0 : [4/16/2016 6:24:15 AM] DiagnosticPlugin exited with code 0

Wenn Sie einen negativen Exitcode finden, hilft Ihnen die Exitcode-Tabelle im Abschnitt Referenzen weiter.

Diagnosedaten werden nicht in Azure Storage protokolliert.

Ermitteln Sie, ob keine oder nur einige Daten angezeigt werden.

Diagnoseinfrastrukturprotokolle

Bei der Diagnose werden alle Fehler in Diagnoseinfrastrukturprotokollen protokolliert. Stellen Sie sicher, dass Sie die Erfassung von Diagnoseinfrastrukturprotokollen in Ihrer Konfiguration aktiviert haben. Anschließend können Sie schnell nach allen relevanten Fehlern suchen, die unter Ihrem konfigurierten Speicherkonto in der Tabelle DiagnosticInfrastructureLogsTable angezeigt werden.

Es werden keine Daten angezeigt.

Die häufigste Ursache dafür, dass keine Ereignisdaten angezeigt werden, ist die fehlerhafte Definition der Speicherkontoinformationen.

Lösung: Korrigieren Sie die Diagnostics-Konfiguration, und installieren Sie Diagnostics erneut.

Wenn das Speicherkonto richtig konfiguriert wurde, sollten Sie den Remotezugriff auf den Computer durchführen und überprüfen, ob DiagnosticsPlugin.exe und MonAgentCore.exe ausgeführt werden. Wenn diese Dateien nicht ausgeführt werden, führen Sie die Schritte unter Die Azure-Diagnose wird nicht gestartet. aus.

Wenn die Prozesse ausgeführt werden, können Sie zu Lokale Erfassung von Daten navigieren und die angegebene Anleitung befolgen.

Wenn weiterhin ein Problem vorliegt, versuchen Sie Folgendes:

1. Deinstallieren Sie den Agent.
2. Löschen Sie das Verzeichnis C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics.
3. Installieren Sie den Agent erneut.

Ein Teil der Daten fehlt

Wenn Sie nicht alle Daten erhalten, sondern nur einige, bedeutet dies, dass die Pipeline für die Datensammlung bzw. -übertragung richtig eingerichtet ist. Mit den Informationen in den folgenden Unterabschnitten können Sie die Ursache des Problems eingrenzen:

Konfiguration der Sammlung

Die Diagnosekonfiguration enthält eine Anleitung zum Sammeln von Daten eines bestimmten Typs. Überprüfen Sie Ihre Konfiguration, um sicherzustellen, dass Sie nur nach den für die Sammlung konfigurierten Daten suchen.

Generierung von Daten durch den Host

• Leistungsindikatoren: Öffnen Sie perfmon, und überprüfen Sie den Leistungsindikator.
• Ablaufverfolgungsprotokolle: Führen Sie den Remotezugriff auf die VM durch, und fügen Sie der Konfigurationsdatei der App TextWriterTraceListener hinzu. Informationen zum Einrichten des Textlisteners finden Sie unter Vorgehensweise: Erstellen und Initialisieren von Ablaufverfolgungslistenern. Stellen Sie sicher, dass für das <trace>-Element <trace autoflush="true"> festgelegt ist. Wenn Sie nicht sehen, dass Ablaufverfolgungsprotokolle generiert werden, helfen Ihnen die Informationen im Abschnitt „Weitere Informationen zu fehlenden Ablaufverfolgungsprotokollen“ weiter.
• ETW-Ablaufverfolgungen (Event Tracing for Windows, Ereignisablaufverfolgung für Windows): Führen Sie den Remotezugriff auf den virtuellen Computer durch, und installieren Sie das PerfView-Tool. Führen Sie in PerfView Folgendes aus: File>User Command>Listen etwprovider1>etwprovider2 (Datei > Benutzerbefehl > Lauschen etwprovider1 > etwprovider2) usw. Beim Befehl Listen (Lauschen) wird die Groß-/Kleinschreibung beachtet, und die kommagetrennte Liste mit ETW-Anbietern darf keine Leerstellen enthalten. Falls der Befehl nicht ausgeführt werden kann, wählen Sie im PerfView-Tool unten rechts die Schaltfläche Log aus, um anzuzeigen, was ausgeführt werden sollte und wie das Ergebnis lautet. Es wird ein neues Fenster angezeigt, wenn die Eingabe korrekt ist. In wenigen Sekunden werden ETW-Ablaufverfolgungen angezeigt.
• Ereignisprotokolle: Führen Sie den Remotezugriff auf die VM durch. Öffnen Sie die Ereignisanzeige, und vergewissern Sie sich, dass die Ereignisse vorhanden sind.

Lokale Erfassung von Daten

Stellen Sie als Nächstes sicher, dass die Daten lokal erfasst werden. Die Daten werden lokal in TSF-Dateien im lokalen Speicher für Diagnosedaten gespeichert. Verschiedene Arten von Protokollen werden in unterschiedlichen TSF-Dateien erfasst. Die Namen ähneln den Tabellennamen in Azure Storage.

Leistungsindikatoren werden beispielsweise in PerformanceCountersTable.tsf erfasst. Ereignisprotokolle werden in WindowsEventLogsTable.tsf gesammelt. Nutzen Sie die Anleitung im Abschnitt Extraktion von lokalen Protokollen, um die lokalen Sammlungsdateien zu öffnen, und vergewissern Sie sich, dass die Erfassung auf dem Datenträger erfolgt.

Wenn Sie nicht erkennen können, dass Protokolle lokal erfasst werden, und bereits überprüft haben, dass der Host Daten generiert, liegt vermutlich ein Konfigurationsproblem vor. Überprüfen Sie die Konfigurationseinstellungen sorgfältig.

Überprüfen Sie auch die Konfiguration, die für die MonitoringAgent-Datei MaConfig.xml generiert wurde. Stellen Sie sicher, dass ein Abschnitt vorhanden ist, in dem die relevante Protokollquelle beschrieben wird. Vergewissern Sie sich anschließend, dass diese bei der Übersetzung zwischen der Diagnosekonfiguration und der Monitoring Agent-Konfiguration nicht verloren geht.

Übertragung von Daten

Führen Sie die folgenden Schritte aus, wenn Sie sich davon überzeugt haben, dass Daten zwar lokal erfasst werden, in Ihrem Speicherkonto aber immer noch nicht angezeigt werden:

• Vergewissern Sie sich, dass Sie ein richtiges Speicherkonto angegeben und für das jeweilige Speicherkonto keinen Rollover für Schlüssel durchgeführt haben. Bei Azure Cloud Services aktualisieren Benutzer manchmal useDevelopmentStorage=true nicht.
• Stellen Sie sicher, dass das bereitgestellte Speicherkonto korrekt ist. Vergewissern Sie sich, dass keine Netzwerkeinschränkungen vorhanden sind, die verhindern, dass die Komponenten öffentliche Speicherendpunkte erreichen. Eine Möglichkeit besteht hierbei darin, den Remotezugriff auf den Computer durchzuführen und selbst Daten in dasselbe Speicherkonto zu schreiben.
• Abschließend können Sie sich ansehen, welche Fehler vom Monitoring Agent gemeldet werden. Der Monitoring Agent schreibt seine Protokolle in die Datei maeventtable.tsf, die sich im lokalen Speicher für Diagnosedaten befindet. Befolgen Sie die Anleitung im Abschnitt Extraktion von lokalen Protokollen, um diese Datei zu öffnen. Versuchen Sie anschließend zu ermitteln, ob errors vorhanden sind, bei denen es um das Lesen von lokalen Dateien bzw. das Schreiben in den Speicher geht.

Erfassen und Archivieren von Protokollen

Wenn Sie sich ggf. an den Support wenden möchten, werden Sie als Erstes vermutlich gebeten, Protokolle auf Ihrem Computer zu erfassen. Sie können Zeit sparen, indem Sie dies vorab selbst durchführen. Führen Sie das Hilfsprogramm CollectGuestLogs.exe unter dem Pfad des Hilfsprogramms für die Protokollsammlung aus. Es wird eine ZIP-Datei mit allen relevanten Azure-Protokollen in demselben Ordner generiert.

Tabellen mit Diagnosedaten nicht gefunden

Die Tabellen in Azure Storage, die ETW-Ereignisse enthalten, werden anhand des folgenden Codes benannt:

        if (String.IsNullOrEmpty(eventDestination)) {
            if (e == "DefaultEvents")
                tableName = "WADDefault" + MD5(provider);
            else
                tableName = "WADEvent" + MD5(provider) + eventId;
        }
        else
            tableName = "WAD" + eventDestination;

Hier sehen Sie ein Beispiel:

        <EtwEventSourceProviderConfiguration provider="prov1">
          <Event id="1" />
          <Event id="2" eventDestination="dest1" />
          <DefaultEvents />
        </EtwEventSourceProviderConfiguration>
        <EtwEventSourceProviderConfiguration provider="prov2">
          <DefaultEvents eventDestination="dest2" />
        </EtwEventSourceProviderConfiguration>

"EtwEventSourceProviderConfiguration": [
    {
        "provider": "prov1",
        "Event": [
            {
                "id": 1
            },
            {
                "id": 2,
                "eventDestination": "dest1"
            }
        ],
        "DefaultEvents": {
            "eventDestination": "DefaultEventDestination",
            "sinks": ""
        }
    },
    {
        "provider": "prov2",
        "DefaultEvents": {
            "eventDestination": "dest2"
        }
    }
]

Mit diesem Code werden vier Tabellen generiert:

References

Weitere Informationen finden Sie in den folgenden Referenzen:

Überprüfen der Konfiguration der Diagnoseerweiterung

Am einfachsten können Sie Ihre Erweiterungskonfiguration über den Azure-Ressourcen-Explorer überprüfen. Navigieren Sie zum virtuellen Computer oder Clouddienst mit der Diagnoseerweiterung (IaaSDiagnostics/PaaDiagnostics).

Greifen Sie alternativ dazu über Remotedesktop auf den Computer zu, und sehen Sie sich die Datei für die Diagnosekonfiguration an, die im Abschnitt zum Protokollartefaktpfad beschrieben ist.

Suchen Sie jeweils nach Microsoft.Azure.Diagnostics und dann nach dem Feld xmlCfg oder WadCfg.

Wenn Sie auf einem virtuellen Computer suchen und das Feld WadCfg vorhanden ist, bedeutet dies, dass die Konfiguration im JSON-Format vorliegt. Wenn das Feld xmlCfg vorhanden ist, bedeutet dies, dass die Konfigurationsdatei im XML-Format vorliegt und Base64-codiert ist. Sie müssen sie decodieren, um die von der Diagnose geladenen XML-Daten anzuzeigen.

Wenn Sie für die Clouddienstrolle die Konfiguration vom Datenträger auswählen, sind die Daten Base64-codiert. Sie müssen sie decodieren, um die von der Diagnose geladenen XML-Daten anzuzeigen.

Azure-Diagnose-Plug-In – Exitcodes

Das Plug-In gibt die folgenden Exitcodes zurück:

Extraktion von lokalen Protokollen

Der Überwachungs-Agent sammelt Protokolle und Artefakte in Form von .tsf-Dateien. Die .tsf-Datei ist nicht lesbar, aber Sie können sie wie folgt in eine .csv-Datei konvertieren:

<Azure diagnostics extension package>\Monitor\x64\table2csv.exe <relevantLogFile>.tsf

Eine neue Datei mit dem Namen <relevantLogFile>.csv wird unter demselben Pfad wie die entsprechende .tsf-Datei erstellt.

Weitere Informationen zu fehlenden Ablaufverfolgungsprotokollen

• Stellen Sie sicher, dass das DiagnosticMonitorTraceListener-Element in „web.config“ oder „app.config“ konfiguriert wurde. In Clouddienstprojekten ist es standardmäßig konfiguriert. Einige Kunden kommentieren das Element aber aus, und dies führt dazu, dass die Überwachungsanweisungen von der Diagnose nicht gesammelt werden.
• Falls die Protokolle nicht mit der OnStart- oder Run-Methode geschrieben werden, sollten Sie sicherstellen, dass das DiagnosticMonitorTraceListener-Element in „app.config“ enthalten ist. Standardmäßig ist es in der Datei „web.config“ enthalten, aber dies gilt nur für Code, der in w3wp.exe ausgeführt wird. Sie benötigen es in „app.config“, um Ablaufverfolgungen zu erfassen, die in WaIISHost.exe ausgeführt werden.
• Vergewissern Sie sich, dass Sie Diagnostics.Trace.TraceXXX anstelle von Diagnostics.Debug.WriteXXX verwenden. Die Debuganweisungen werden aus einem Versionsbuild entfernt.
• Stellen Sie sicher, dass der kompilierte Code über die Diagnostics.Trace-Zeilen verfügt. Verwenden Sie Reflector, ildasm oder ILSpy für die Überprüfung. Diagnostics.Trace-Befehle werden aus der kompilierten Binärdatei entfernt, sofern Sie nicht das Symbol für die bedingte TRACE-Kompilierung verwenden. Dieses häufige Problem tritt auf, wenn Sie MSBuild zum Erstellen eines Projekts verwenden.

Bekannte Probleme und Lösungen

Für die folgenden bekannten Probleme gibt es Abhilfemaßnahmen.

.NET 4.5-Abhängigkeit

Die Azure-Diagnoseerweiterung für Windows verfügt über eine Laufzeitabhängigkeit von .NET 4.5 Framework oder höher. Zum Zeitpunkt der Abfassung dieses Artikels ist für alle Computer, die für Azure Cloud Services bereitgestellt werden, sowie für alle Images, die auf virtuellen Azure-Computern basieren, .NET 4.5 oder höher installiert.

Es kann trotzdem zu einer Situation kommen, in der Sie versuchen, die Azure-Diagnoseerweiterung für Windows auf einem Computer auszuführen, der nicht über .NET 4.5 oder höher verfügt. Dies passiert, wenn Sie Ihren Computer aus einem alten Image oder einer alten Momentaufnahme erstellen oder einen eigenen benutzerdefinierten Datenträger verwenden.

Bei diesem Problem tritt im Allgemeinen der Exitcode 255 auf, wenn Sie DiagnosticsPluginLauncher.exe ausführen. Fehler aufgrund des folgenden Ausnahmefehlers:

System.IO.FileLoadException: Could not load file or assembly 'System.Threading.Tasks, Version=1.5.11.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies

Lösung: Installieren Sie .NET 4.5 oder höher auf Ihrem Computer.

Daten von Leistungsindikatoren sind im Speicher verfügbar, werden aber nicht im Portal angezeigt.

Auf der Portaloberfläche auf den virtuellen Computern werden bestimmte Leistungsindikatoren standardmäßig angezeigt. Überprüfen Sie Folgendes, wenn die Leistungsindikatoren nicht angezeigt werden und Sie sicher sind, dass die Daten generiert werden, weil sie im Speicher verfügbar sind:

• Haben die Daten im Speicher englische Indikatornamen? Wenn die Indikatornamen nicht auf Englisch sind, können sie vom Portalmetrikdiagramm nicht erkannt werden.

  • Lösung: Ändern Sie die Sprache des Computers für Systemkonten in Englisch. Wählen Sie hierzu Systemsteuerung>Region>Verwaltung>Einstellungen kopieren. Deaktivieren Sie als Nächstes die Option Willkommensseite und Systemkonten, damit die benutzerdefinierte Sprache nicht auf das Systemkonto angewendet wird.

• Wenn Sie in den Namen Ihrer Leistungsindikatoren Platzhalter (*) verwenden, ist es für das Portal nicht möglich, den konfigurierten und erfassten Indikator zu korrelieren, wenn die Leistungsindikatoren an die Azure Storage-Senke gesendet werden.

  • Risikominderung: Um sicherzustellen, dass Sie Platzhalter verwenden können und das Portal zudem den (*) erweitert, leiten Sie Ihre Leistungsindikatoren an die „Azure Monitor“-Senke weiter.