Einrichten der Diagnose für Azure Cloud Services (erweiterter Support) und virtuelle Computer

Anmerkung

Dieser Artikel bezieht sich auf Azure Azure Cloud Services (erweiterter Support). Cloud Services (klassisch) wird ab dem 31. August 2024 eingestellt. Weitere Informationen finden Sie unter (Klassisches) Clouddienste-Bereitstellungsmodell wird am 31. August 2024 eingestellt. Für eine neue Entwicklung empfehlen wir, einen neueren Diensttyp zu verwenden, der für Ihren spezifischen Zweck entwickelt wurde, z. B. Azure App Service, Azure Functionsoder Azure Container Apps. Die neueste Liste der verfügbaren Dienste finden Sie unter Verzeichnis der Azure-Produkte.

Wenn Sie eine Problembehandlung für einen Azure Cloud Services -Dienst (erweiterter Support) oder einen virtuellen Computer durchführen müssen, können Sie Visual Studio verwenden, um die Azure-Diagnose einfacher einzurichten. Die Diagnose erfasst Systemdaten und Protokollierungsdaten auf den virtuellen Computern und Instanzen virtueller Computer, die Ihren Clouddienst ausführen. Diagnosedaten werden an ein von Ihnen ausgewähltes Speicherkonto übertragen. Weitere Informationen zur Diagnoseprotokollierung in Azure finden Sie unter Aktivieren der Diagnoseprotokollierung für Web Apps in Azure App Service.

In diesem Artikel zeigen wir Ihnen, wie Sie Visual Studio zum Aktivieren und Einrichten der Azure-Diagnose verwenden. Erfahren Sie, wie Sie Die Diagnose auf virtuellen Azure-Computern einrichten, wie Sie die zu sammelnden Diagnoseinformationen auswählen und wie Sie die Informationen nach der Erfassung anzeigen.

Zum Einrichten der Azure-Diagnose ändern Sie die Diagnoseeinstellungen im Dialogfeld Diagnosekonfiguration in Visual Studio. Die Einstellungen werden in einer Datei namens diagnostics.wadcfgxgespeichert. Sie können die Konfigurationsdatei auch direkt ändern. Wenn Sie die Datei manuell aktualisieren, werden die Konfigurationsänderungen wirksam, wenn Sie den Clouddienst das nächste Mal in Azure bereitstellen oder den Dienst im Emulator ausführen.

Warnung

In Visual Studio 2022 wurde der veraltete Azure Storage-Emulator durch den Azurite-Emulator beim Debuggen Ihrer Cloud Service-Projekte ersetzt. Dieser Azurite-Emulator funktioniert nicht mit dem Azure Diagnostics-Plug-In, das Unterstützung für Azure Diagnostics bereitstellt, wenn sie lokal ausgeführt und getestet wird. Wenn Sie das Plug-In für lokale Ausführungs- und Testszenarien benötigen, können Sie entweder die Verbindungszeichenfolge in der lokalen Dienstkonfiguration (.cscfg) auf ein Azure Storage-Konto aktualisieren (siehe Verwalten von Verbindungszeichenfolgen für Speicherkonten), oder laden Sie den vorherigen Azure Storage-Emulatorherunter. In der Visual Studio 17.10-Version wird das lokale Azure Diagnostics-Plug-In standardmäßig als veraltet markiert und deaktiviert, mit der Option, es in dieser Version zu aktivieren. Das Plug-In wurde in Visual Studio 17.11 entfernt. Dieses Plug-In wurde nur mit dem lokalen Azure Compute-Emulator verwendet und die Deaktivierung wirkt sich nicht auf die bereitgestellten Clouddienste aus, die die Azure Diagnostics-Erweiterung in Azure verwenden. Um das Diagnose-Plug-In in Visual Studio 17.10 zu aktivieren, fügen Sie die folgende Eigenschaft zu irgendeinem PropertyGroup in Ihrer Projektdatei hinzu: <EnableEmulatorDiagnosticsPlugin>True</EnableEmulatorDiagnosticsPlugin>.

Wie Visual Studio das Diagnosespeicherkonto bestimmt

• Wenn eine Diagnoseverbindungszeichenfolge in der .cscfg-Datei angegeben ist, verwendet Visual Studio sie zum Einrichten der Diagnoseerweiterung während der Veröffentlichung und beim Generieren der öffentlichen Konfigurations-XML-Dateien während des Verpackens.
• Wenn keine Diagnose-Verbindungszeichenfolge in der .cscfg-Datei angegebenen ist, verwendet Visual Studio wieder das Speicherkonto, das in der .wadcfgx-Datei angegeben ist, um die Diagnoseerweiterung für das Veröffentlichen einzurichten sowie für das Generieren der öffentlichen XML-Konfigurationsdateien während des Verpackens.
• Die Diagnoseverbindungszeichenfolge in der .cscfg-Datei hat Vorrang vor dem in der .wadcfgx-Datei angegebenen Speicherkonto. Wenn in der datei .cscfg eine Diagnoseverbindungszeichenfolge angegeben ist, verwendet Visual Studio diese Verbindungszeichenfolge und ignoriert das Speicherkonto in .wadcfgx.

Was bewirkt das Kontrollkästchen „Entwicklungsspeicher-Verbindungszeichenfolgen aktualisieren“?

Das Kontrollkästchen zur Aktualisierung von Entwicklungsspeicherverbindungszeichenfolgen für Diagnosen und Zwischenspeicherung mit den Anmeldeinformationen Ihres Microsoft Azure-Speicherkontos beim Veröffentlichen auf Microsoft Azure ist eine bequeme Möglichkeit, alle Verbindungszeichenfolgen für Entwicklungsspeicherkonten mit dem Azure Storage-Konto zu aktualisieren, das Sie während der Veröffentlichung angeben. Wenn Sie das Projekt in Azure bereitstellen, aktualisiert Visual Studio automatisch die Verbindungszeichenfolge für die Diagnose mit dem Speicherkonto, das Sie im Assistenten zum Veröffentlichen angegeben haben. Wenn jedoch ein echtes Speicherkonto als Diagnoseverbindungszeichenfolge angegeben wurde, wird dieses Konto stattdessen verwendet.

Einrichten von Diagnosedatenquellen

Nachdem Sie die Diagnosedatensammlung aktiviert haben, können Sie genau auswählen, welche Datenquellen Sie sammeln möchten und welche Informationen gesammelt werden. In den folgenden Abschnitten erfolgt eine Beschreibung der Registerkarten im Dialogfeld Diagnosekonfiguration sowie der einzelnen Konfigurationsoptionen.

Anwendungsprotokolle

Anwendungsprotokolle enthalten Diagnoseinformationen, die von einer Webanwendung erstellt werden. Wenn Sie Anwendungsprotokolle erfassen möchten, aktivieren Sie das Kontrollkästchen Übertragung von Anwendungsprotokollen aktivieren. Um das Intervall zwischen der Übertragung von Anwendungsprotokollen an Ihr Speicherkonto zu erhöhen oder zu verringern, ändern Sie den Transferzeitraum (min) Wert. Sie können auch die Menge der im Protokoll erfassten Informationen ändern, indem Sie die Protokollebene Wert festlegen. Sie können z. B. Ausführlich auswählen, um weitere Informationen zu erhalten, oder Kritisch, um nur kritische Fehler zu erfassen. Wenn Sie über einen bestimmten Diagnoseanbieter verfügen, der Anwendungsprotokolle ausgibt, können Sie die Protokolle erfassen, indem Sie die GUID (Globally Unique Identifier) des Anbieters im Feld Anbieter-GUID hinzufügen.

Weitere Informationen zu Anwendungsprotokollen finden Sie unter Aktivieren der Diagnoseprotokollierung für Web Apps in Azure App Service.

Windows-Ereignisprotokolle

Um Windows-Ereignisprotokolle zu erfassen, aktivieren Sie das Kontrollkästchen Übertragung von Windows-Ereignisprotokollen aktivieren. Um das Intervall zwischen der Übertragung von Ereignisprotokollen an Ihr Speicherkonto zu erhöhen oder zu verringern, ändern Sie den Übertragungszeitraum (min) Wert. Aktivieren Sie die Kontrollkästchen für die Ereignistypen, die Sie nachverfolgen möchten.

Wenn Sie eine benutzerdefinierte Datenquelle angeben möchten, geben Sie sie in das Textfeld <Datenquelle> Textfeld ein, und wählen Sie dann Hinzufügenaus. Die Datenquelle wird der Datei diagnostics.cfcfg hinzugefügt.

Leistungsindikatoren

Leistungsindikatoreninformationen können Ihnen helfen, Systemengpässe zu finden und die System- und Anwendungsleistung zu optimieren. Weitere Informationen finden Sie unter Erstellen und Verwenden von Leistungsindikatoren in einer Azure-Anwendung. Um Leistungszähler zu erfassen, aktivieren Sie das Kontrollkästchen Aktivieren der Übertragung von Leistungszählern. Um das Intervall zwischen der Übertragung von Ereignisprotokollen an Ihr Speicherkonto zu erhöhen oder zu verringern, ändern Sie den Übertragungszeitraum (min) Wert. Aktivieren Sie die Kontrollkästchen für die Leistungsindikatoren, die Sie nachverfolgen möchten.

Um einen nicht aufgeführten Leistungsindikator nachzuverfolgen, geben Sie den Leistungsindikator mithilfe der vorgeschlagenen Syntax ein. und klicken Sie dann auf Hinzufügen. Das Betriebssystem auf dem virtuellen Computer bestimmt, welche Leistungsindikatoren Sie nachverfolgen können. Weitere Informationen zur Syntax finden Sie unter Angeben eines Zählerpfads.

Infrastrukturprotokolle

Infrastrukturprotokolle enthalten Informationen zur Azure-Diagnoseinfrastruktur, zum RemoteAccess-Modul und zum RemoteForwarder-Modul. Um Informationen zu Infrastrukturprotokollen zu sammeln, aktivieren Sie das Kontrollkästchen Übertragung von Infrastrukturprotokollen aktivieren. Um das Intervall zwischen der Übertragung von Infrastrukturprotokollen an Ihr Speicherkonto zu erhöhen oder zu verringern, ändern Sie den Übertragungszeitraum (min) Wert.

Weitere Informationen finden Sie unter Sammeln von Protokollierungsdaten mithilfe von Azure Diagnostics.

Protokollverzeichnisse

Protokollverzeichnisse enthalten Daten aus Protokollverzeichnissen für IIS-Anforderungen (Internet Information Services), fehlgeschlagene Anforderungen oder Ordner, die Sie auswählen. Aktivieren Sie das Kontrollkästchen Protokollverzeichnisse erfassen, um die Übertragung von Protokollverzeichnissen zu ermöglichen. Um das Intervall zwischen der Übertragung von Protokollen in Ihr Speicherkonto zu erhöhen oder zu verringern, ändern Sie den Übertragungszeitraum (min) Wert.

Aktivieren Sie die Kontrollkästchen der Protokolle, die Sie erfassen möchten, z. B. IIS-Protokolle und Protokolle fehlgeschlagener Anfragen. Standardspeichercontainernamen werden bereitgestellt, aber Sie können die Namen ändern.

Sie können Protokolle aus jedem Beliebigen Ordner erfassen. Geben Sie den Pfad im Abschnitt Protokoll aus absolutem Verzeichnis an, und klicken Sie dann auf Verzeichnis hinzufügen. Die Protokolle werden in den angegebenen Containern erfasst.

ETW-Protokolle

Wenn Sie Ereignisablaufverfolgung für Windows (ETW) (ETW) verwenden und ETW-Protokolle erfassen möchten, aktivieren Sie das Kontrollkästchen Übertragung von ETW-Protokollen aktivieren. Um das Intervall zwischen der Übertragung von Protokollen in Ihr Speicherkonto zu erhöhen oder zu verringern, ändern Sie den Übertragungszeitraum (min) Wert.

Die Ereignisse werden aus Ereignisquellen und Ereignismanifesten erfasst, die Sie angeben. Um eine Ereignisquelle anzugeben, geben Sie im Abschnitt Ereignisquellen einen Namen ein, und wählen Sie dann Ereignisquelle hinzufügenaus. Ebenso können Sie im Abschnitt Ereignismanifeste ein Ereignismanifest angeben und dann Ereignismanifest hinzufügenauswählen.

Das ETW-Framework wird in ASP.NET über Klassen im System.Diagnostics.aspx-Namespace unterstützt. Der Microsoft.WindowsAzure.Diagnostics-Namespace, der von Standard System.Diagnostics.aspx klassen erbt und erweitert, ermöglicht die Verwendung von System.Diagnostics.aspx als Protokollierungsframework in der Azure-Umgebung. Weitere Informationen finden Sie unter Übernehmen der Steuerung der Protokollierung und Ablaufverfolgung in Microsoft Azure und Aktivieren der Diagnose in Azure Cloud Services (erweiterter Support) und virtuellen Computern.

Absturzabbilder

Wenn Sie Informationen darüber erfassen möchten, wann eine Rolleninstanz abstürzt, aktivieren Sie das Kontrollkästchen Übertragung von Absturzabbildern aktivieren. (Da die meisten Ausnahmen von ASP.NET verarbeitet werden, ist dies im Allgemeinen nur für Workerrollen von Nutzen.) Ändern Sie den Wert Verzeichniskontingent (%), um den Prozentsatz des Speicherplatzes zu erhöhen oder zu verringern, der für Absturzabbilder reserviert ist. Sie können den Speichercontainer ändern, in dem die Absturzabbilder gespeichert werden, und Sie können angeben, ob Sie ein vollständiges Abbild oder ein Miniabbild erfassen möchten.

Die derzeit nachverfolgten Prozesse werden im nächsten Screenshot aufgeführt. Aktivieren Sie die Kontrollkästchen für die Prozesse, die Sie erfassen möchten. Wenn Sie der Liste einen weiteren Prozess hinzufügen möchten, geben Sie den Prozessnamen ein, und wählen Sie dann Prozess hinzufügenaus.

Weitere Informationen finden Sie unter Steuern der Protokollierung und Ablaufverfolgung in Microsoft Azure.

Behandeln von Problemen mit Azure Cloud Services (erweiterter Support)

Wenn Probleme mit Ihren Clouddienstprojekten auftreten, z. B. eine Rolle, die in einem Status "beschäftigt" hängen bleibt, wiederholt wiederverwendet wird oder einen internen Serverfehler auslöst, gibt es Tools und Techniken, mit denen Sie das Problem diagnostizieren und beheben können. Spezifische Beispiele für häufige Probleme und Lösungen sowie eine Übersicht über die Konzepte und Tools, mit denen Sie diese Fehler diagnostizieren und beheben können, finden Sie unter Azure-Plattform als Dienst (PaaS) compute diagnostics data.

Fragen und Antworten

Was ist die Puffergröße und wie groß sollte sie sein?

In jeder Instanz des virtuellen Computers beschränken Kontingente, wie viele Diagnosedaten im lokalen Dateisystem gespeichert werden können. Darüber hinaus geben Sie eine Puffergröße für jeden verfügbaren Diagnosedatentyp an. Diese Puffergröße verhält sich wie ein einzelnes Kontingent für diesen Datentyp. Informationen zum Ermitteln des Gesamtkontingents und des verbleibenden Arbeitsspeichers finden Sie unten im Dialogfeld für den Diagnosedatentyp. Wenn Sie größere Puffer oder mehr Datentypen angeben, nähern Sie sich dem Gesamtkontingent. Sie können das Gesamtkontingent ändern, indem Sie die konfigurationsdatei diagnostics.wadcfgx ändern. Die Diagnosedaten werden auf demselben Dateisystem wie die Daten Ihrer Anwendung gespeichert. Wenn Ihre Anwendung einen großen Speicherplatz verwendet, sollten Sie das Gesamtdiagnosekontingent nicht erhöhen.

Was ist der Transferzeitraum, und wie lange sollte es sein?

Der Übertragungszeitraum ist die Zeitspanne, die zwischen Denkdatenerfassungen verstrichen ist. Nach jedem Übertragungszeitraum werden Daten aus dem lokalen Dateisystem auf einem virtuellen Computer in Tabellen in Ihrem Speicherkonto verschoben. Wenn die gesammelte Datenmenge das Kontingent vor Dem Ende eines Übertragungszeitraums überschreitet, werden ältere Daten verworfen. Wenn Sie Daten verlieren, da Ihre Daten die Puffergröße oder das Gesamtkontingent überschreiten, sollten Sie den Übertragungszeitraum verringern.

Welche Zeitzone gilt für die Zeitstempel?

Zeitstempel befinden sich in der lokalen Zeitzone des Rechenzentrums, in dem Ihr Clouddienst gehostet wird. Die folgenden drei Zeitstempelspalten in den Protokolltabellen werden verwendet:

• PreciseTimeStamp: Der ETW-Zeitstempel des Ereignisses. Das heißt, der Zeitpunkt, zu dem das Ereignis vom Client protokolliert wird.
• TIMESTAMP: Der Wert für PreciseTimeStamp wurde auf die Uploadfrequenzgrenze abgerundet. Wenn Ihre Uploadhäufigkeit beispielsweise 5 Minuten und die Ereigniszeit 00:17:12 beträgt, ist der Zeitstempel 00:15:00.
• Zeitstempel: Der Zeitstempel, zu dem die Entität in der Azure-Tabelle erstellt wurde.

Wie verwalte ich kosten beim Sammeln von Diagnoseinformationen?

Die Standardeinstellungen (Protokollebene auf Fehlerfestgelegt, und Übertragungszeitraum auf 1 Minutefestgelegt ) sind so konzipiert, dass die Kosten minimiert werden. Ihre Berechnungskosten erhöhen sich, wenn Sie mehr Diagnosedaten sammeln oder den Übertragungszeitraum verringern. Sammeln Sie nicht mehr Daten, als Sie benötigen, und vergessen Sie nicht, die Datensammlung zu deaktivieren, wenn Sie sie nicht mehr benötigen. Sie können sie jederzeit wieder aktivieren, auch zur Laufzeit, wie weiter oben in diesem Artikel beschrieben.

Wie kann ich Fehleranforderungsprotokolle aus IIS sammeln?

Standardmäßig zeichnet IIS keine Protokolle für fehlgeschlagene Anforderungen auf. Sie können IIS so einrichten, dass Fehleranforderungsprotokolle erfasst werden, indem Sie die web.config Datei für Ihre Webrolle bearbeiten.

Ich erhalte keine Ablaufverfolgungsinformationen von RoleEntryPoint-Methoden wie OnStart. Was ist los?

Die Methoden von RoleEntryPoint- werden im Kontext von WAIISHost.exeaufgerufen, nicht in IIS. Die Konfigurationsinformationen in web.config, die normalerweise die Ablaufverfolgung ermöglichen, gelten nicht. Um dieses Problem zu beheben, fügen Sie Ihrem Webrollenprojekt eine .config Datei hinzu, und benennen Sie die Datei so, dass sie der Ausgabeassembly entspricht, die den RoleEntryPoint- Code enthält. Im Standardwebrollenprojekt sollte der Name der .config Datei WAIISHost.exe.configwerden. Fügen Sie der Datei die folgenden Zeilen hinzu:

<system.diagnostics>
  <trace>
      <listeners>
          <add name "AzureDiagnostics" type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener">
              <filter type="" />
          </add>
      </listeners>
  </trace>
</system.diagnostics>

Legen Sie im Fenster Eigenschaften die Eigenschaft In Ausgabeverzeichnis kopieren auf Immer kopieren fest.

Verwandte Inhalte

Weitere Informationen zur Diagnoseprotokollierung in Azure finden Sie unter Aktivieren der Diagnose in Azure Cloud Services (erweiterter Support) und virtuellen Computern und Aktivieren der Diagnoseprotokollierung für Web Apps in Azure App Service.