Error Reporting – Übersicht

In Error Reporting werden Fehlerereignisse aus Ihren laufenden Cloud-Diensten zusammengefasst. Ein Fehlerereignis stellt ein einzelnes Auftreten eines Fehlers in Ihrer Anwendung dar. Die für jedes Ereignis gespeicherten Daten enthalten Informationen zum Fehler, z. B. den Zeitpunkt, zu dem er aufgetreten ist, den Kontext, in dem er aufgetreten ist, und die zurückgegebene Fehlermeldung.

Fehlerereignisse werden entweder von der Error Reporting API gemeldet oder von Error Reporting abgeleitet, wenn Logeinträge auf häufige Textmuster wie Stacktraces untersucht werden. Error Reporting gruppiert Fehlerereignisse, 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 wurden, kann Error Reporting 100 Fehlerbeispiele pro Stunde anzeigen und die Anzahl danach hochrechnen.

Wann Error Reporting Logeinträge analysiert

Error Reporting ist ein globaler Dienst, der auf Cloud Logging basiert 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 wird. In Error Reporting können keine Logeinträge in Log-Buckets mit aktiviertem CMEK gespeichert werden. Informationen dazu, wie Sie die CMEK-Konfiguration für einen Log-Bucket ermitteln, finden Sie unter Schlüsselaktivierung prüfen.
  • Der Log-Bucket erfüllt eine der folgenden Bedingungen:
    • Der Log-Bucket wird in demselben 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.

Gruppierung von Fehlerereignissen

Wenn Error Reporting Logeinträge auswertet, um Fehlerereignisse zu identifizieren, werden Logeinträge mit den folgenden Bedingungen ignoriert:

  • Logeinträge, die von der App Engine-Standardumgebung geschrieben wurden und einen Schweregrad unter ERROR haben.
  • Stapelframes, die keinem Nutzer gehören (z. B. wenn diese zu einer öffentlichen Bibliothek gehören).

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

  • Ersetzt alle sich wiederholenden Sequenzen von einem oder mehreren Stapelframes durch ein einzelnes Vorkommen dieser Sequenz.
  • Entfernt Methoden und Symbole des Compilers.

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

Ereignis vom Typ „Fehler“ Gruppiert nach
Fehlerereignisse, die durch ein allgemeines Problem in der Umgebung verursacht werden.

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
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 5 meistgenutzten Frames
Fehlerereignisse 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 Anforderungen an den Datenstandort oder Impact Level 4 (IL4) einrichten, wird Error Reporting in Google Cloud 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 anhand der Region des Log-Buckets, der die Logeinträge enthält, organisiert und angezeigt. Eine Fehlergruppe, die unter us-central-1 aufgeführt ist, enthält beispielsweise nur Fehlerlogs, die zu einem Log-Bucket in us-central-1 gehören. Globale Fehlergruppen enthalten nur Fehlerlogs, die zu einem Log-Bucket in der Region global gehören.

Wenn Sie die Region der auf der Seite Fehlergruppen angezeigten Fehlergruppen filtern möchten, wählen Sie einen Wert aus dem Menü Region aus. Das Standardmenü hat den Wert global.

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

Nächste Schritte