Sie haben zwei Möglichkeiten, Fehler von Ihren Google Kubernetes Engine-Anwendungen an Error Reporting zu senden:
Durch Logging in Cloud Logging: Wenn Sie Cloud Logging bereits verwenden, besteht die einzige zusätzliche Anforderung darin, dass Ihre Logeinträge von Error Reporting erkannt werden müssen. Weitere Informationen zu den Anforderungen an die Fehlerformatierung finden Sie unter Fehler in Cloud Logging formatieren.
Durch Verwendung der Error Reporting API: Ihre Anwendung kann HTTP-Anfragen über die REST API senden oder experimentelle Bibliotheken in mehreren Sprachen verwenden.
Logging zum Melden von Fehlern verwenden
Der Standard-Logging-Agent von GKE bietet eine verwaltete Lösung zum Bereitstellen und Verwalten von Agents, die Logs für Ihre Cluster an Cloud Logging senden. Die Struktur des Agents hängt von der Version des Cluster. Informationen zu diesem Agent finden Sie unter GKE-Logs verwalten
Für Error Reporting müssen Ausnahmen oder Stacktraces enthalten sein
in einem einzelnen Logeintrag. Die meisten Logging-Agents erkennen,
Mehrere Protokollzeilen (Stapelframes, die jeweils in einer neuen Zeile gedruckt werden) stehen für
einen Stacktrace und senden Sie ihn
als einzelnen Logeintrag an Cloud Logging.
Wenn der Agent nicht in der Lage ist,
mehrere Zeilen als einen Fehler zu rekonstruieren,
wählen Sie dann
projects.events.report
API-Endpunkt,
mit der Sie den Inhalt
eines Fehlers steuern können.
Error Reporting-API zum Beschreiben von Fehlern verwenden
Die Error Reporting API bietet einen report
-Endpunkt zum Schreiben von Fehlerinformationen in den Dienst.
Enable the Error Reporting API.
Mithilfe der REST API oder einer Clientbibliothek melden Sie Fehler an die API.
Beispiele
ASP.NET
Das ASP.NET NuGet-Paket meldet nicht abgefangene Ausnahmen von ASP.NET-Webanwendungen zu Error Reporting hinzufügen.
NuGet-Paket installieren
So installieren Sie das Stackdriver-ASP.NET-NuGet-Paket in Visual Studio:
- Klicken Sie mit der rechten Maustaste auf Ihre Lösung und wählen Sie NuGet-Pakete für Lösung verwalten aus.
- Wählen Sie das Kästchen Vorabversion einbeziehen aus.
- Suchen Sie nach dem Paket mit dem Namen
Google.Cloud.Diagnostics.AspNet
und installieren Sie es.
Nutzung
Nachdem Sie das Stackdriver-ASP.NET-NuGet-Paket installiert haben, können Sie die folgende Anweisung zu Ihrem Anwendungscode hinzufügen und Fehler an Stackdriver senden:
using Google.Cloud.Diagnostics.AspNet;
Fügen Sie der Methode Register
Ihrer Datei den folgenden HttpConfiguration
-Code hinzu:
.NET-Webanwendung (ersetzen Sie your-project-id
durch Ihre tatsächliche
Projekt-ID
um Ausnahmen zu melden:
Nachdem Sie diese Methode zu Ihrer ASP.NET-Anwendung hinzugefügt haben, können Sie alle Nicht abgefangene Ausnahmen, die beim Melden an Google Cloud auftreten in der Spalte Error Reporting der Google Cloud Console.
C#
Das folgende Beispiel befindet sich in der GoogleCloudPlatform/dotnet-docs-samples Repository. Geben Sie nach der Projekterstellung Ihre Projekt-ID an, um es zu verwenden:
C:\...\bin\Debug> set GOOGLE_PROJECT_ID=[YOUR_PROJECT_ID]
Ersetzen Sie [YOUR_PROJECT_ID]
durch den richtigen Wert aus dem
Google Cloud Console
Senden Sie dann Ausnahmedaten mit Code ähnlich dem folgenden:
Go
Java
Node.js
Ruby
Python
PHP
Fehlergruppen ansehen
Rufen Sie in der Google Cloud Console die Seite Error Reporting auf:
Sie können diese Seite auch über die Suchleiste finden.