Fehler beheben

Falls Ihre Anwendungsfehler nicht in Error Reporting angezeigt werden, und führen Sie dann die folgenden Schritte zur Fehlerbehebung aus.

Hinweise

  1. Prüfen, ob Error Reporting Ihre Logs analysieren kann

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

    • Die Logeinträge werden in einem Log-Bucket am Standort global gespeichert.
    • Vom Kunden verwaltete Verschlüsselungsschlüssel (CMEKs) sind für den Log-Bucket deaktiviert. Informationen zum Ermitteln der CMEK-Konfiguration für Log-Buckets, siehe Prüfen Sie die Aktivierung des Schlüssels.
    • Der Log-Bucket erfüllt eine der folgenden Anforderungen: <ph type="x-smartling-placeholder">
        </ph>
      • Der Log-Bucket wird in dem Projekt gespeichert, in dem die Logs gespeichert sind. entstand.
      • Die Logs wurden an ein Projekt weitergeleitet, das dann in diesem Projekt diese Logs in einem eigenen Log-Bucket gespeichert.

    Um zu sehen, ob Error Reporting Ihre Logs analysieren kann, überprüfen Sie, ob Sie Ihre Logs werden in Buckets in der Region global gespeichert, in der die Quelle und Google Cloud-Zielprojekte sind identisch.

    Führen Sie den folgenden Befehl aus, um eine Liste der von Ihnen konfigurierten Senken aufzurufen:

    gcloud logging sinks list
    

    Die Ausgabe des Befehls sieht in etwa so aus:

    NAME               DESTINATION                                                                                                FILTER
    _Default           logging.googleapis.com/projects/my-team-project/locations/global/buckets/_Default                          NOT LOG_ID("cloudaudit.googleapis.com/activity") AND NOT LOG_ID("externalaudit.googleapis.com/activity") AND NOT LOG_ID("cloudaudit.googleapis.com/system_event") AND NOT LOG_ID("externalaudit.googleapis.com/system_event") AND NOT LOG_ID("cloudaudit.googleapis.com/access_transparency") AND NOT LOG_ID("externalaudit.googleapis.com/access_transparency")
    _Required          logging.googleapis.com/projects/my-team-project/locations/global/buckets/_Required                         LOG_ID("cloudaudit.googleapis.com/activity") OR LOG_ID("externalaudit.googleapis.com/activity") OR LOG_ID("cloudaudit.googleapis.com/system_event") OR LOG_ID("externalaudit.googleapis.com/system_event") OR LOG_ID("cloudaudit.googleapis.com/access_transparency") OR LOG_ID("externalaudit.googleapis.com/access_transparency")
    logs-from-samples  logging.googleapis.com/projects/my-team-project/locations/global/buckets/sample-bucket                     (empty filter)
    regional_logs      logging.googleapis.com/projects/my-team-project/locations/europe-west1/buckets/bucket_for_regional_logs    (empty filter)
    test-logs          logging.googleapis.com/projects/team-b-project/locations/global/buckets/test-bucket                        (empty filter)
    

    In diesem Beispiel lautet das Google Cloud-Quellprojekt der Logs my-team-project. Deshalb gilt Folgendes:

    • Error Reporting kann die von _Default weitergeleiteten Logs analysieren, Senken _Required und logs-from-samples, da sie Logs weiterleiten an Buckets in der Region global innerhalb desselben Projekts.
    • Error Reporting kann die im Log-Bucket gespeicherten Logs nicht analysieren mit dem Namen test-logs, da die Senke in my-team-project die Logs weiterleitet. in einem Log-Bucket in einem anderen Projekt.
    • Error Reporting kann keine Logs analysieren, die von regional_logs weitergeleitet wurden Waschbecken da er Logs an einen regionalen Bucket in der Region europe-west1 weiterleitet.
  2. Stellen Sie sicher, dass Sie Die Google Cloud CLI ist installiert.

  3. Stellen Sie sicher, dass Sie Die beta-Komponente ist für die gcloud CLI aktiviert.

Beim Verwenden von Logs

Dieser Abschnitt bietet Unterstützung bei der Fehlerbehebung, wenn Ihre Fehlerdaten geschrieben werden an Cloud Logging-Buckets senden und Error Reporting um diese Log-Buckets automatisch zu analysieren.

Beispiel-Logeintrag generieren

Zum Bestätigen Ihrer Projekteinstellungen können Sie programmatisch einen Logeintrag generieren die von Error Reporting erfasst werden, mit dem folgenden gcloud Befehl:

gcloud logging write --payload-type=json test-errors-log \
  '{"serviceContext":
    {"service": "manual-testing"},
    "message": "Test Error\n at /test.js:42:42",
    "context": {"httpRequest":
      {"url": "/test","method": "GET","responseStatusCode": 500}}}'

Öffnen Sie dann Error Reporting und bestätigen Sie, dass der gerade erstellte Fehler angezeigt wird.

Format des Logeintrags bestätigen

Rufen Sie die Cloud Logging-Seite auf und suchen Sie nach einem Logeintrag, der von Ihrer Anwendung gesendete Ausnahmedaten enthält.

Vergewissern Sie sich, dass der Log-Eintrag dem erwarteten Format entspricht.

Beim Verwenden der Error Reporting-API

  1. Aktivieren Sie die erforderliche API.

    Aktivieren Sie die API

  2. Testfehler senden

    Versuchen Sie, manuell einen Fehler an den Dienst zu senden.

    Sie können einen Testfehler an Error Reporting mithilfe des folgenden gcloud-Befehls melden:

    gcloud beta error-reporting events report --service Manual --service-version test1 \
      --message "java.lang.TestError: msg
        at com.example.TestClass.test(TestClass.java:51)
        at com.example.AnotherClass(AnotherClass.java:25)"
    

    Sie können einen cURL-Befehl verwenden, um Ihre REST API-Aufrufe zu testen. Ersetzen Sie PROJECT_ID und API_KEY mit Ihren gültigen Werten, bevor Sie den folgenden Befehl senden:

    curl -X POST -H "Content-Type: application/json" \
      -d '{"message":"java.lang.TestError: msg\n\tat com.example.TestClass.test(TestClass.java:51)\n\tat com.example.AnotherClass(AnotherClass.java:25)","serviceContext":{"service":"manual-testing"}}' \
      https://clouderrorreporting.googleapis.com/v1beta1/projects/PROJECT_ID/events:report?key=API_KEY
    
  3. Gesendete Nutzlast bestätigen

    Achten Sie darauf, dass Ihre Anwendung Ausnahmedaten an die API im richtigen Format haben und die erforderlichen Attribute enthält.