Freigeben über

Verfolgen des Ablaufs in einer Cloud Services-Anwendung (klassisch) mit der Azure-Diagnose

  • Artikel

Wichtig

Cloud Services (klassisch) ist jetzt ab dem 1. September 2024 für alle Kunden veraltet. Alle vorhandenen ausgeführten Bereitstellungen werden beendet und von Microsoft heruntergefahren, und die Daten gehen ab Oktober 2024 dauerhaft verloren. In neuen Bereitstellungen sollte das neue auf Azure Resource Manager basierende Bereitstellungsmodell für Azure Cloud Services (erweiterter Support) verwendet werden.

Die Ablaufverfolgung bietet Ihnen eine Möglichkeit, Ihre Anwendung während der Ausführung zu überwachen. Sie können die Klassen System.Diagnostics.Trace, System.Diagnostics.Debug und System.Diagnostics.TraceSource verwenden, um Informationen zu Fehlern und zur Anwendungsausführung in Protokollen, Textdateien oder auf anderen Geräten zur späteren Analyse aufzuzeichnen. Weitere Informationen zur Ablaufverfolgung finden Sie unter Ablaufverfolgung und Instrumentation von Anwendungen.

Verwenden von Ablaufverfolgungsanweisungen und -schaltern

Implementieren Sie die Ablaufverfolgung in der Cloud Services-Anwendung durch Hinzufügen von DiagnosticMonitorTraceListener zur Anwendungskonfiguration und durch Aufrufe von „System.Diagnostics.Trace“ oder „System.Diagnostics.Debug“ in Ihrem Anwendungscode. Verwenden Sie die Konfigurationsdatei app.config für Workerrollen und web.config für Webrollen. Wenn Sie einen neuen gehosteten Dienst mit einer Visual Studio-Vorlage erstellen, wird die Azure-Diagnose dem Projekt automatisch hinzugefügt, und DiagnosticMonitorTraceListener wird in die entsprechende Konfigurationsdatei für die hinzugefügten Rollen aufgenommen.

Informationen zum Platzieren von Ablaufverfolgungsanweisungen finden Sie unter Vorgehensweise: Hinzufügen von Ablaufverfolgungsanweisungen zu Anwendungscode.

Durch die Platzierung von Ablaufverfolgungsschaltern in Ihrem Code können Sie steuern, ob und in welchem Umfang Ablaufverfolgung durchgeführt wird. Durch die Ablaufverfolgung können Sie den Status der Anwendung in einer Produktionsumgebung überwachen. Das Überwachen des Anwendungsstatus ist besonders wichtig in einer Geschäftsanwendung, die mehrere Komponenten auf mehreren Computern verwendet. Weitere Informationen finden Sie unter Vorgehensweise: Konfigurieren von Ablaufverfolgungsschaltern.

Konfigurieren des Ablaufverfolgungslisteners in einer Azure-Anwendung

Für „Trace“, „Debug“ und „TraceSource“ müssen Sie „Listener“ einrichten, die Meldungen sammeln und aufzeichnen, die gesendet werden. Listener sammeln und speichern Ablaufverfolgungsmeldungen und leiten sie weiter. Sie leiten die Ablaufverfolgungsausgabe an ein entsprechendes Ziel weiter, beispielsweise ein Protokoll, ein Fenster oder eine Textdatei. Die Azure-Diagnose verwendet die DiagnosticMonitorTraceListener -Klasse.

Bevor Sie das folgende Verfahren ausführen, müssen Sie den Azure-Diagnosemonitor initialisieren. Informationen zum Initialisieren des Azure-Diagnosemonitors finden Sie unter Aktivieren der Diagnose in Microsoft Azure.

Hinweis

Die Konfiguration des Listeners wird automatisch hinzugefügt, wenn Sie die von Visual Studio bereitgestellten Vorlagen verwenden.

Hinzufügen eines Ablaufverfolgungslisteners

  1. Öffnen Sie die Datei „web.config“ oder „app.config“ für Ihre Rolle.

  2. Fügen Sie der Datei den folgenden Code hinzu. Geben Sie für das Version-Attribut die Versionsnummer der referenzierten Assembly an. Die Assemblyversion wird nicht unbedingt mit jedem Azure-SDK-Release geändert, es sei denn, es liegen Updates für sie vor.

    <system.diagnostics>
    <trace>
        <listeners>
            <add type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener,
              Microsoft.WindowsAzure.Diagnostics,
              Version=2.8.0.0,
              Culture=neutral,
              PublicKeyToken=31bf3856ad364e35"
              name="AzureDiagnostics">
                <filter type="" />
            </add>
        </listeners>
    </trace>
</system.diagnostics>

    Wichtig

    Stellen Sie sicher, dass ein Projektverweis auf die Assembly Microsoft.WindowsAzure.Diagnostics vorhanden ist. Aktualisieren Sie die Versionsnummer im obigen XML-Code auf die Version der referenzierten Microsoft.WindowsAzure.Diagnostics-Assembly.

  3. Speichern Sie die Konfigurationsdatei.

Weitere Informationen zu Listenern finden Sie unter Ablaufverfolgungslistener.

Nachdem Sie die Schritte zum Hinzufügen des Listeners abgeschlossen haben, können Sie Ihrem Code Ablaufverfolgungsanweisungen hinzufügen.

So fügen Sie dem Code eine Ablaufverfolgungsanweisung hinzu

  1. Öffnen Sie eine Quelldatei für die Anwendung. Beispielsweise die Datei „<RoleName>.cs“ für die Workerrolle oder die Webrolle.
  2. Fügen Sie die folgende using-Anweisung hinzu, wenn sie noch nicht vorhanden ist: 
        using System.Diagnostics;
  3. Fügen Sie Ablaufverfolgungsanweisungen überall ein, wo Sie Informationen über den Zustand der Anwendung erfassen möchten. Sie können verschiedene Methoden zum Formatieren der Ausgabe der Ablaufverfolgungsanweisung verwenden. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen von Ablaufverfolgungsanweisungen zu Anwendungscode.
  4. Speichern Sie die Quelldatei.