Error Reporting – Übersicht

In Error Reporting werden Fehler aus Ihren laufenden Cloud-Diensten zusammengefasst. Diese Fehler werden entweder von der Error Reporting API gemeldet oder als Fehler erkannt, wenn bei der Fehlermeldung Logeinträge auf häufige Textmuster wie Stack-Traces geprüft werden. Error Reporting gruppiert Fehler, von denen angenommen wird, dass sie dieselbe Ursache haben.

Error Reporting wird automatisch aktiviert.

Error Reporting zeigt bis zu 1.000 Fehlerbeispiele pro Stunde. Ist dieses Limit erreicht, wird eine Schätzung der Anzahl angezeigt. Wenn zu viele Ereignisse erfasst werden, kann Error Reporting 100 Fehlerbeispiele pro Stunde anzeigen und die Anzahl danach hochrechnen.

Wann werden Logeinträge von Error Reporting analysiert?

Error Reporting ist ein globaler Dienst, der auf Cloud Logging basiert. Logeinträge können analysiert werden, wenn alle folgenden Bedingungen erfüllt sind:

  • Assured Workloads sind deaktiviert. Weitere Informationen finden Sie unter Assured Workloads-Übersicht.
  • Vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) sind in allen Protokoll-Buckets deaktiviert, in denen der Protokolleintrag gespeichert wird. Informationen zum Ermitteln der CMEK-Konfiguration für einen Log-Bucket finden Sie unter Aktivierung von Schlüsseln prüfen.
  • Der Log-Bucket erfüllt eine der folgenden Bedingungen:
    • Der Log-Bucket wird im selben Projekt gespeichert, in dem die Logeinträge stammen.
    • Die Logeinträge wurden an ein Projekt weitergeleitet und dann in einem zugehörigen Log-Bucket gespeichert.
Wenn Sie Ihre Protokolleinträge in Protokoll-Buckets mit aktivierter CMEK speichern, können Sie die Fehlerberichte weiterhin verwenden. Sie müssen jedoch die Clientbibliotheken für Error Reporting oder die Error Reporting API verwenden. Weitere Informationen finden Sie unter Error Reporting API – Übersicht und Error Reporting API – Clientbibliotheken.

Informationen zu Fehlergruppierungen

Bei der Auswertung von Logeinträgen durch Error Reporting werden Logeinträge mit den folgenden Bedingungen ignoriert:

  • In einer App-Engine-Standardumgebung werden Fehler mit einem geringeren Schweregrad als ERROR ignoriert.
  • Stapelframes, die keinem Nutzer gehören, werden ignoriert (z. B. wenn diese zu einer öffentlichen Bibliothek gehören).
  • Sequenzen, die sich für mehr als einen Stack-Frame wiederholen, werden durch ein einzelnes Vorkommen für diese Sequenz ersetzt.
  • Methoden und Symbole des Compilers werden entfernt.

Bei Error Reporting werden Fehler dann anhand der folgenden Regeln gruppiert:

  • Ausnahmen werden gruppiert, wenn die Ausnahme gleich und die Stacks ähnlich sind.
  • Der Stacktrace wird für Ausnahmen, die in der Regel nicht in Zusammenhang mit der Quelle stehen, ignoriert.
  • Fehler ohne Ausnahme-Stack werden gruppiert, wenn Sie vom gleichen Logeintrag erstellt wurden, angenähert vom Ort der Quelle, aus der sie gemeldet wurden (reportLocation).

Konkret werden die folgenden Gruppierungsregeln in dieser Reihenfolge angewendet:

Fehlertyp Gruppiert nach
Fehler durch ein allgemeines Problem in der Umgebung.

Zum Beispiel spezielle App Engine-Probleme:

com.google.apphosting.runtime.HardDeadlineExceededError
 
com.google.appengine.api.datastore.DatastoreTimeoutException

Java-Probleme:

java.util.concurrent.CancellationException
 Gruppiert nach Ausnahmetyp
Fehler mit einem Stacktrace. Im Fall von verschachtelten Ausnahmen wird die innerste Ausnahme berücksichtigt.

Beispiel:

runtime error: index out of range
package1.func1()
      file1:20
package2.func2()
      file2:33
 Gruppiert nach Ausnahmetyp und den 5 meistgenutzten Frames
Fehler ohne Stacktrace, aber mit einer Meldung.

Beispiel:

runtime error: index out of range
    func1()
 Gruppiert nach Meldung und Funktionsname (falls vorhanden). nur die ersten 3 Literal-Tokens der Nachricht werden berücksichtigt. Im Beispiel links sind dies runtime, error und index.

Regionalität der Daten

Wenn Sie Assured Workloads für den Datenspeicherort oder die Anforderungen der Impact Level 4 (IL4) einrichten, wird die Fehlermeldung in Google Cloud automatisch deaktiviert.

In Cloud Logging können Sie Ihre Logs regionalisieren, indem Sie sie an einen bestimmten Speicherort weiterleiten. Auf der Seite Fehlergruppen werden Fehlergruppen in Error Reporting basierend auf der Region des Log-Buckets organisiert und angezeigt, der die Logeinträge enthält. Eine unter us-central-1 aufgeführte Fehlergruppe enthält beispielsweise nur Fehlerprotokolle, die zu einem Protokoll-Bucket in us-central-1 gehören. Globale Fehlergruppen enthalten nur Fehlerprotokolle, die zu einem Protokoll-Bucket in der Region global gehören.

Wenn Sie die Region der Fehlergruppen filtern möchten, die auf der Seite Fehlergruppen angezeigt werden, wählen Sie einen Wert aus dem Menü Region aus. Der Standardwert für dieses Menü ist global.

Im Menü „Region“ auf der Seite „Fehlergruppen“.

Nächste Schritte