Fehler verwalten

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

Auf dieser Seite wird erläutert, wie Sie Fehler in Error Reporting verwalten können.

Erste Schritte

Rufen Sie in der Google Cloud Console Error Reporting auf, um die Fehler für die Dienste und Anwendungen in Ihrem Google Cloud-Projekt anzusehen:

Zur Seite „Fehlerberichte“

Das Error Reporting-Dashboard zeigt eine Liste mit einer Zusammenfassung jedes gefundenen Fehlers und der Häufigkeit des Auftretens an.

Grafik: Benutzeroberfläche mit der Fehlerliste.

Tipp: Behandeln Sie diese Liste wie einen E-Mail-Posteingang. Sie können die Liste pflegen, wenn Sie zugrunde liegende Fehler beheben und/oder erwartete und wiederkehrende Fehler ausblenden.

Weitere Informationen zum Anzeigen und Filtern Ihrer Error Reporting-Liste finden Sie unter Fehler anzeigen.

Informationen zu den zum Verwalten von Fehlern erforderlichen Berechtigungen finden Sie unter Zugriffssteuerung mit IAM.

Fehlerbeispiele

In einer Gruppe zusammengefasste Fehler sind sich in der Regel sehr ähnlich. Deshalb werden von Error Reporting nur 1.000 Beispiele beibehalten und die verbleibenden Informationen hochgerechnet. Sie können Ihre Logs nach BigQuery weiterleiten, damit künftig jedes Auftreten eines Fehlers gespeichert wird.

Für jedes Beispiel zeigt die Benutzeroberfläche die von Ihrer Anwendung an Error Reporting gesendeten Daten. In der App Engine-Standardumgebung sehen Sie nützliche Metadaten wie den User-Agent und die URL der Anfrage, die zum Fehler geführt hat. Wenn Sie eigene Fehlerberichte als Log-Einträge senden, überprüfen Sie die Liste der Felder, die Sie angeben können. Wenn Sie die Error Reporting API verwenden, lesen Sie die Informationen zum Objekt ReportedErrorEvent.

Weitere Einzelheiten finden Sie unter Informationen zu Fehlergruppierungen.

Lösungsstatus ändern

So ändern Sie den Lösungsstatus Ihrer Fehlergruppen zum Verwalten Ihres Workflows:

  1. Rufen Sie in der Google Cloud Console die Seite Vorgänge &Fehlerberichte auf:

    Zur Seite „Error Reporting“

  2. Für jede Fehlergruppe wird der Statuswert unter Resolution status (Lösungsstatus) angezeigt:

    Grafik: Benutzeroberfläche mit dem Fehlerlösungsstatus.

  3. Erweitern Sie im vorherigen Fenster die Spalte Lösungsstatus, um den Status einer Fehlergruppe zu ändern. Dies sind die möglichen Statuswerte:

    • Offen: Der Standard-Anfangsstatus aller Fehlergruppen. Jeder andere Status wird manuell eingestellt. Sie können den Status einer Fehlergruppe jederzeit auf Offen zurücksetzen.
    • Bestätigt: Ein Status zum Sichten von Fehlergruppen.
    • Behoben: Ein Status, der anzeigt, dass eine Gruppe von Fehlern behoben wurde und diese nicht mehr auftreten sollten. Wenn die Fehler einer als Behoben gekennzeichneten Gruppe später noch einmal auftreten, wird der Lösungsstatus von Error Reporting auf Offen zurückgesetzt.
    • Ausgeblendet: Ein Status zum Ausblenden einer Fehlergruppe aus der Liste. Weitere Informationen finden Sie unter Fehler ausblenden.

Fehler ausblenden

Wenn Sie Fehlergruppen aus der Error Reporting-Liste ausblenden möchten, ändern Sie deren Lösungsstatus in Ausgeblendet . Ausgeblendete Fehler werden auch dann nicht in der Liste angezeigt, wenn sie wieder auftreten.

Zum Aufrufen der ausgeblendeten Fehlergruppen (und um diese bei Bedarf wieder einzublenden) gehen Sie so vor:

  1. Klicken Sie auf Manage muted errors (Ausgeblendete Fehler verwalten):

    Grafik: Benutzeroberfläche mit dem Menü "Muted Errors" (Ausgeblendete Fehler).

  2. Mit dem Filter Lösungsstatus werden nur die Fehlergruppen Behoben und Ausgeblendet angezeigt.

    Grafik: Benutzeroberfläche mit der Option zum Ausblenden des Lösungsstatus.

Wenn Sie eine ausgeblendete Fehlergruppe wieder anzeigen möchten, heben Sie die Auswahl des entsprechenden Lösungsstatustyps in demselben Lösungsstatus-Fenster wieder auf.

Error Reporting sendet keine Benachrichtigungen, wenn der ausgeblendete Fehler wieder auftritt.

Fehler mit Problemen verknüpfen

Sie können Fehlergruppen mit Problemen verknüpfen. Bei Fehlergruppen, die nicht mit einem Problemlink verknüpft sind, wird das Symbol zum Hinzufügen angezeigt. Bei Fehlergruppen, die mit einem Problemlink verknüpft sind, wird ein Linksymbol angezeigt.

Klicken Sie neben den einzelnen Zeilen in Ihrer Liste auf das Linksymbol , um die mit einer Fehlergruppe verknüpften Probleme aufzurufen:

Benutzeroberfläche mit dem Linksymbol

Wenn die Fehlergruppe nicht mit einer Problem-URL verknüpft ist, wird durch Klicken auf das Symbol zum Hinzufügen ein Bereich Problem-URL mit diesem Fehler verknüpfen geöffnet, in dem Sie eine URL eingeben können.

Benutzeroberfläche mit dem Linksymbol

Benachrichtigungen einzurichten.

Sie können sich von Error Reporting benachrichtigen lassen, wenn neue Fehler auftreten oder Fehler wieder auftreten, die als Behoben gekennzeichnet wurden. Weitere Informationen und eine Anleitung zum Festlegen von Benachrichtigungen finden Sie unter Benachrichtigungen verwalten.

Fehler löschen

Mithilfe des gcloud-Tools oder der REST API können Sie alle Fehlerereignisse löschen, die für das jeweilige Cloud-Projekt gespeichert sind, und die Fehlerzahlen auf null zurücksetzen.

gcloud

Führen Sie folgenden Befehl aus, um alle Fehlerereignisse zu löschen:

gcloud beta error-reporting events delete

REST API

Verwenden Sie die Methode projects.deleteEvents der REST API, um alle Fehler zu löschen.

Wenn Sie Benachrichtigungen für das Cloud-Projekt abonniert und dann Fehler mit dem Status Behoben gelöscht haben, ändert sich der Lösungsstatus wieder in Offen und Error Reporting sendet eine Benachrichtigung, wenn die Fehler wieder auftreten.

Wenn Sie Fehler mit dem Status Offen oder Bestätigt gelöscht haben, sendet Error Reporting keine Benachrichtigung, wenn die Fehler wieder auftreten.