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.
Hinweise
- 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.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Error Reporting API aktivieren.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Error Reporting API aktivieren.
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.
-
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. -
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. -
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 eine neue Instanz über die Google Cloud Console erstellen, können Sie dies im Abschnitt Identität und API-Zugriff des Bereichs Instanz erstellen 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 bei jedem ausgewählten Dienstkonto darauf, dass ihm in der Google Cloud Console im Bereich IAM und Verwaltung 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
Wählen Sie in der Google Cloud Console Error Reporting aus oder klicken Sie auf die folgende Schaltfläche und wählen Sie ein Projekt aus:
Weitere Informationen finden Sie unter Fehler anzeigen.