Error Reporting für .NET einrichten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Mithilfe des Google.Cloud.Diagnostics-Satzes von Bibliotheken können Sie Fehlerberichte von .NET-Anwendungen an Error Reporting senden.

Error Reporting ist in einige Google Cloud-Dienste wie App Engine, Compute Engine und Google Kubernetes Engine eingebunden. In Error Reporting sehen Sie die in Cloud Logging protokollierten Fehler der auf diesen Diensten ausgeführten Anwendungen. Weitere Informationen finden Sie auf dieser Seite im Abschnitt Auf der Google Cloud Platform ausführen.

Sie können Fehlerdaten auch mithilfe von Logging an Error Reporting senden. Informationen zu den Datenformatierungsanforderungen finden Sie unter Fehlermeldungen in Logging formatieren.

Hinweis

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  4. Error Reporting API aktivieren.

    Aktivieren Sie die API

  5. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  6. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  7. Error Reporting API aktivieren.

    Aktivieren Sie die API

Clientbibliothek installieren

Mit den Reihe von Google.Cloud.Diagnostics-Bibliotheken können Sie die von .NET-Anwendungen gemeldeten Fehler im Blick behalten und ansehen. Dabei ist es in den meisten Fällen unerheblich, wo die Anwendungen ausgeführt werden.

  1. Verwenden Sie für Anwendungen, die auf ASP.NET Core 3 oder höher ausgerichtet sind, die Bibliothek Google.Cloud.Diagnostics.AspNetCore3. Sie können diese Bibliothek über NuGet installieren.
  2. Verwenden Sie für Anwendungen, die auf ältere Versionen von ASP.NET Core abzielen, die Google.Cloud.Diagnostics.AspNetCore-Bibliothek. Sie können diese Bibliothek über NuGet installieren.
  3. Verwenden Sie für Anwendungen, die nicht auf ASP.NET Core-Frameworks abzielen, die Google.Cloud.Diagnostics.Common-Bibliothek. Sie können diese Bibliothek über NuGet installieren.

Weitere Informationen zur Installation finden Sie in der Dokumentation zur Google.Cloud.Diagnostics-Reihe von Bibliotheken. Probleme können Sie über die Problemverfolgung melden.

Clientbibliothek konfigurieren

Weitere Informationen und Beispiele finden Sie in den folgenden Ressourcen:

  • Google.Cloud.Diagnostics.AspNetCore3 Dokumentation
  • Google.Cloud.Diagnostics.AspNetCore Dokumentation
  • Google.Cloud.Diagnostics.Common Dokumentation
  • Fehler melden

    Weitere Informationen und Beispiele finden Sie in den folgenden Ressourcen:

  • Google.Cloud.Diagnostics.AspNetCore3 Dokumentation
  • Google.Cloud.Diagnostics.AspNetCore Dokumentation
  • Google.Cloud.Diagnostics.Common Dokumentation
  • In Google Cloud ausführen

    Für die Verwendung der Google.Cloud.Diagnostics-Gruppe von Bibliotheken ist die Rolle Error Reporting-Autor von Identity and Access Management erforderlich. Die meisten Computing-Plattformen von Google Cloud stellen diese Rolle standardmäßig zur Verfügung.

    Sie können Error Reporting für .NET in den folgenden Google Cloud-Umgebungen konfigurieren.

    Flexible App Engine-Umgebung

    In App Engine wird die Rolle Error Reporting-Autor standardmäßig zugewiesen.

    Die Google.Cloud.Diagnostics-Bibliotheken-Gruppe können verwendet werden, ohne dass Anmeldedaten explizit angegeben werden müssen.

    Error Reporting wird für Anwendungen in flexiblen App Engine-Umgebungen automatisch aktiviert. Es ist keine zusätzliche Einrichtung erforderlich. Von App Engine in stderr geschriebene Nachrichten werden analysiert und von Error Reporting angezeigt, falls sie einen Stacktrace enthalten.

    Eine Anleitung zum Aufrufen von Fehler- und Ausnahmedaten für Ihre Anwendung in der Google Cloud Console finden Sie unter Fehler anzeigen.

    Google Kubernetes Engine

    In GKE müssen Sie beim Erstellen des Clusters den Zugriffsbereich für cloud-platform wie im folgenden Beispielbefehl gezeigt festlegen:

    gcloud container clusters create example-cluster-name --scopes https://www.googleapis.com/auth/cloud-platform
    

    Compute Engine

    Wenn Sie Compute Engine-VM-Instanzen verwenden, fügen Sie der jeweiligen Instanz den Zugriffsbereich für cloud-platform hinzu. Wenn Sie über die Google Cloud Console eine neue Instanz erstellen, können Sie dies im Bereich Instanz erstellen unter Identität und API-Zugriff tun. Verwenden Sie das Compute Engine-Standarddienstkonto oder ein anderes Dienstkonto und wählen Sie im Abschnitt Identität und API-Zugriff die Option Uneingeschränkten Zugriff auf alle Cloud APIs zulassen aus. Achten Sie darauf, dass jedem ausgewählten Dienstkonto im Abschnitt IAM &Verwaltung der Google Cloud Console die Rolle „Error Reporting-Autor“ zugewiesen ist.

    Lokal und extern ausführen

    Um zu verwenden die Google.Cloud.Diagnostics-Bibliotheken-Gruppe außerhalb von Google Cloud, einschließlich der Ausführung der Bibliothek auf Ihrer eigenen Workstation, auf den Computern Ihres Rechenzentrums oder auf den VM-Instanzen einer anderen Cloudanbieter müssen Sie Ihre Google Cloud-Projekt-ID und die entsprechenden Dienstkonto-Anmeldedaten direkt für die Google.Cloud.Diagnostics-Gruppe von Bibliotheken bereitstellen.

    Sie können Anmeldeinformationen für Dienstkonten manuell erstellen und abrufen. Geben Sie dafür im Feld Rolle die Rolle Error Reporting-Autor an. Weitere Informationen zu den IAM-Rollen finden Sie in der Anleitung zur Zugriffssteuerung.

    Fehlerberichte ansehen

    Nach der Bereitstellung können Sie Fehlerberichte im Error Reporting-Dashboard der Google Cloud Console ansehen.

    Error Reporting-Dashboard aufrufen

    Weitere Informationen finden Sie unter Fehler anzeigen.