Fehler verwalten

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

Öffnen Sie zum Ansehen der Fehler die Seite Error Reporting in der Cloud Console. Es wird eine Liste der vor Kurzem aufgetretenen Fehlergruppen in der Reihenfolge ihrer Häufigkeit angezeigt:

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 Ansehen und Filtern von Fehlern in der Error Reporting-Liste finden Sie unter Fehler ansehen.

Informationen zu den zum Verwalten von Fehlern erforderlichen Berechtigungen finden Sie im Leitfaden zur Zugriffssteuerung.

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 exportieren, 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 Cloud Console die Seite Vorgänge > Error Reporting 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ü

  2. Die Seite Muted Errors (Ausgeblendete Fehler) wird angezeigt. Maximieren Sie in der oberen Navigationsleiste den Bereich Lösungsstatus. Wählen Sie die Lösungsstatustypen der Fehlergruppen aus, die nicht in der Liste angezeigt werden sollen.

    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.

Mit Problemen verknüpfen

Sie können Fehlergruppen mit Problemen verknüpfen.

Zum Einsehen oder Ändern der Probleme im Zusammenhang mit einer Fehlergruppe klicken Sie auf das Fehlerberichtssymbol neben der jeweiligen Zeile in der Liste:

Grafik: Benutzeroberfläche mit dem Fehlerberichtssymbol.

Wenn die Fehlergruppe noch nicht mit einer Problem-URL verknüpft ist, wird durch Klicken auf das Fehlerberichtssymbol der Bereich Problem-URL mit diesem Fehler verknüpfen geöffnet, in dem Sie die entsprechende URL eingeben können.

Ist eine Fehlergruppe bereits mit einer URL in Ihrem Problemverfolgungssystem verknüpft, wird durch Klicken auf das Fehlerberichtssymbol dieser Link in einem neuen Browsertab geöffnet.

Mitteilungen

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

Fehler löschen

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

gcloud

So löschen Sie alle Fehlerereignisse:

gcloud beta error-reporting events delete

REST API

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