Fehlerdaten mithilfe von Error Reporting erfassen

In diesem Dokument sind die von Error Reporting unterstützten Umgebungen und Es enthält Links zu sprachspezifischen Leitfäden für Anwendungsentwickler. Wir empfehlen die Verwendung der sprachspezifischen Clientbibliotheken. oder auf automatisch erfassten Logeinträgen zurückgreifen. Sie können jedoch Fehlerdaten mit der Cloud Logging API oder der Error Reporting API schreiben Wenn Sie beispielsweise Cloud Run werden die in stderr geschriebenen Ausnahmen automatisch an Cloud Logging gesendet.

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 Übersicht über Assured Workloads.
• Vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) sind in allen Protokoll-Buckets deaktiviert, in denen der Protokolleintrag gespeichert wird. Informationen zur Ermitteln Sie die CMEK-Konfiguration für einen Log-Bucket, siehe Prüfen Sie die Aktivierung des Schlüssels.
• Der Log-Bucket erfüllt eine der folgenden Anforderungen:
  • 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 in der Übersicht über die Error Reporting API und in den Clientbibliotheken für Error Reporting.

Unterstützung für Virtual Private Cloud

Error Reporting ist eine unterstützte Virtual Private Cloud (VPC) Service.

Um das Risiko der Daten-Exfiltration zu verringern, erstellen Sie mit VPC Service Controls Dienstperimeter für Ihre von Google verwalteten Dienste. Informationen zu VPC Service Controls und zum Erstellen eines Dienstparameters finden Sie in der Dokumentation zu VPC Service Controls.

Umgebungen für die automatische Meldung von Fehlerdaten konfigurieren

Informationen zu umgebungsspezifischen Konfigurationsanforderungen finden Sie in den folgenden Anleitungen:

• Flexible App Engine-Umgebung
• App Engine-Standardumgebung
• Apps Script
• Cloud Run-Funktionen
• Cloud Run
• Compute Engine
• Google Kubernetes Engine
• Amazon EC2

Apps mithilfe von Clientbibliotheken analysieren

Informationen zum Konfigurieren Ihrer Anwendung zum Senden von Fehlerberichten finden Sie in den sprachspezifischen Konfigurationsanleitungen:

• Go-Apps
• Java-Anwendungen
• .NET-Apps
• Node.js-Apps
• Python-Apps
• PHP-Anwendungen
• Ruby-Apps

Fehlerdaten mit einer API schreiben

Sie können Fehlerereignisse in Ihrem Google Cloud-Projekt melden, indem Sie die Methode „Error Reporting API“ report oder die Methode „Cloud Logging API“ write ausführen.

• Wenn Sie eine API-Schlüssel-Authentifizierung benötigen, müssen Sie die Error Reporting API verwenden. Wenn Sie ein Fehlerereignis mit der Error Reporting API melden möchten, führen Sie die Methode report aus und formatieren Sie den Anfragetext der Methode als ReportedErrorEvent-Objekt.

  Wenn Sie die Error Reporting API verwenden, werden Logeinträge mit korrekt formatierten Fehlermeldungen automatisch generiert und in Cloud Logging geschrieben. Diese Logeinträge werden in ein Protokoll geschrieben, dessen logName so formatiert ist:

  projects/PROJECT_ID/clouderrorreporting.googleapis.com%2Freported_errors
  

  Da Logeinträge durch Aufrufe von report generiert werden, können Datenaufnahmekosten in Cloud Logging anfallen. Um zu steuern, welche Logeinträge aufgenommen werden, siehe Ausschlussfilter.

  Wenn Sie Fehlerereignisse mit der Error Reporting API melden, der Rest dieses Dokuments gilt nicht.

• Wenn Sie die Cloud Logging API verwenden möchten, müssen Sie den Parameter LogEntry-Objekt, das einen Stacktrace enthält oder ein ReportedErrorEvent-Objekt. Weitere Informationen zu den Formatierungsanforderungen finden Sie im Fehler in Protokollen formatieren