Error Reporting – Übersicht

Error Reporting aggregiert und gruppiert Anwendungsfehlerereignisse nach ihrer Ursache, damit Sie Probleme in Ihren Cloud-Diensten leichter identifizieren, priorisieren und beheben können. Ein Fehlerereignis stellt ein einzelnes Vorkommen eines Anwendungsfehlers dar und erfasst den Zeitstempel, den Ausführungskontext und die Fehlermeldung.

Error Reporting ist automatisch aktiviert und beginnt mit der Erkennung von Fehlern, ohne dass eine manuelle Einrichtung erforderlich ist. Fehlerereignisse werden direkt von der Error Reporting API erfasst oder durch Scannen von Logeinträgen nach Stacktraces und häufigen Fehlermustern abgeleitet.

Zur Leistungsoptimierung werden in Error Reporting bis zu 1.000 Fehler pro Stunde erfasst. Wenn dieser Grenzwert erreicht wird, werden die Anzahl geschätzt. Wenn das Ereignisvolumen die Kapazität übersteigt, werden in Error Reporting bis zu 100 Fehler pro Stunde erfasst und die angezeigten Anzahl werden weiterhin hochgerechnet.

Wann Logeinträge von Error Reporting analysiert werden

Error Reporting ist ein globaler Dienst, der auf Cloud Logging aufbaut und Logeinträge analysieren kann, wenn alle folgenden Bedingungen erfüllt sind:

  • Assured Workloads ist deaktiviert. Weitere Informationen finden Sie unter Übersicht über Assured Workloads.
  • Kundenverwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) sind für alle Log-Buckets deaktiviert, in denen der Logeintrag gespeichert ist. Error Reporting kann Logeinträge nicht in Log-Buckets speichern, für die CMEK aktiviert ist. Informationen zum Ermitteln der CMEK-Konfiguration für einen Log-Bucket finden Sie unter Schlüsselaktivierung prüfen.
  • Der Log-Bucket erfüllt eine der folgenden Bedingungen:
    • Der Log-Bucket wird im selben Projekt gespeichert, aus dem die Logeinträge stammen.
    • Die Logeinträge wurden an ein Projekt weitergeleitet und dieses Projekt hat die Logeinträge dann in einem eigenen Log-Bucket gespeichert.

So werden Fehlerereignisse gruppiert

Wenn Error Reporting Logeinträge auswertet, um Fehlerereignisse zu identifizieren, werden die folgenden Daten ignoriert:

  • Logeinträge, die von der App Engine-Standardumgebung geschrieben wurden und einen Schweregrad unter ERROR haben.
  • Stapelframes, die nicht dem Nutzer gehören, z. B. solche, die zu öffentlichen Bibliotheken gehören.

Wenn ein Logeintrag gescannt wird, nimmt Error Reporting die folgenden Änderungen vor, bevor Fehlerereignisse abgeleitet werden:

  • 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.

Error Reporting wendet diese Regeln in der angegebenen Reihenfolge an, um Fehlerereignisse zu gruppieren:

Fehlerereignis Gruppiert nach
Fehlerereignisse, die durch ein allgemeines Problem in der Umgebung verursacht werden.

Beispiele für App Engine-spezifische Probleme:

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

Java-Probleme:

java.util.concurrent.CancellationException
 Gruppiert nach Ausnahmetyp
Fehlerereignisse 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 fünf meistgenutzten Frames
Fehlerereignisse ohne Stacktrace, aber mit einer Meldung.

Beispiel:

runtime error: index out of range
    func1()

In diesem Beispiel werden die folgenden Tokens berücksichtigt: runtime, error und index.

 Gruppiert nach Meldung und Funktionsname (falls vorhanden). Nur die ersten drei Literal-Tokens der Nachricht werden berücksichtigt.

Regionalität der Daten

Wenn Sie Assured Workloads für den Datenstandort oder die Anforderungen von Impact Level 4 (IL4) einrichten, wird Google Cloud Error Reporting automatisch deaktiviert.

In Cloud Logging können Sie Ihre Logs regionalisieren, indem Sie sie an einen bestimmten Standort weiterleiten. Auf der Seite Fehlergruppen werden Fehlergruppen in Error Reporting nach der Region des Log-Buckets organisiert und angezeigt, der die Logeinträge enthält. Eine unter us-central1 aufgeführte Fehlergruppe enthält beispielsweise nur Fehlerlogs, die Teil eines Log-Buckets in us-central1 sind. Globale Fehlergruppen enthalten nur Fehlerlogs, die Teil eines Log-Buckets in der Region global sind.

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

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

Nächste Schritte