Wenn ein veröffentlichtes Google Workspace-Add-on einen Fehler zurückgibt, gibt die Add-on-Oberfläche die allgemeine Meldung „Beim Ausführen des Add-ons ist ein Fehler aufgetreten“ aus. Diese Fehler werden jedoch im Cloud-Log-Explorer protokolliert.
In dieser Anleitung wird beschrieben, wie Sie Add-on-Fehlerlogs im Cloud Logs Explorer abfragen, um:
- Erfahren, ob bei Nutzern Fehler auftreten
- Sehen Sie sich an, wie häufig und welche Fehler am häufigsten auftreten.
- Lesen Sie beschreibende Fehlermeldungen, um sie zu beheben.
Voraussetzungen
Bevor Sie Add-on-Fehlerlogs abfragen:
- Aktivieren Sie die „Cloud Logging API“ im Google Cloud-Projekt des Add-ons. Informationen zum Aktivieren einer API finden Sie unter Cloud-Projekt erstellen und API aktivieren.
- Veröffentlichen Sie das Add-on im Google Workspace Marketplace. Informationen zum Veröffentlichen eines Add-ons im Marketplace finden Sie unter App veröffentlichen.
Fehlerlogs für Abfrage-Add-ons
So rufen Sie Logs für ein Add-on ab:
- Öffnen Sie die Google Cloud Console.
- Klicken Sie neben „Google Cloud Platform“ auf den Abwärtspfeil und wählen Sie das Add-on-Projekt aus.
- Klicken Sie links oben auf das Menü > Logging. Der Log-Explorer wird geöffnet.
Geben Sie für Add-on-Fehlerlogs im Query Builder die folgende Abfrage ein:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Klicken Sie auf Abfrage ausführen, um die letzten Fehler zu sehen. Sie können auch auf Logs streamen klicken, um auftretende Fehler anzusehen. Fehlerlogs zu Add-ons werden im Bereich „Abfrageergebnisse“ angezeigt.
Weitere Informationen zu Cloud Log-Explorer und zum Schreiben von Abfragen finden Sie hier:
Fehler-Logging aktivieren oder deaktivieren
Das Fehler-Logging ist standardmäßig aktiviert. Wenn das Fehler-Logging aktiviert ist, enthält die Manifestdatei Folgendes:
"exceptionLogging": "STACKDRIVER",
Wenn Sie das Fehler-Logging deaktivieren möchten, ersetzen Sie in der Manifestdatei "exceptionLogging": "STACKDRIVER", durch die folgende Zeile:
// Disable error logging
"exceptionLogging": "NONE"
Wenn Sie das Fehler-Logging wieder aktivieren möchten, ersetzen Sie "exceptionLogging": "NONE" durch "exceptionLogging": "STACKDRIVER",.
Hinweise
Beachten Sie bei der Arbeit mit Add-on-Fehlerlogs in Cloud Logs Explorer die folgenden Hinweise:
- Nur Add-ons protokollieren Fehler im Log-Explorer. Andere Logtypen werden nicht aufgezeichnet.
- Fehlermeldungen werden immer auf Englisch geschrieben.
- Für Cloud Logging fallen Kosten an. Weitere Informationen zu den Cloud Logging-Preisen finden Sie unter Google Cloud-Preise für die Beobachtbarkeit.