Wenn ein veröffentlichtes Google Workspace-Add-on einen Fehler zurückgibt, wird in der Add-on-Benutzeroberfläche die generische Meldung „Beim Ausführen des Add-ons ist ein Fehler aufgetreten“ angezeigt. Diese Fehler werden jedoch im Log-Explorer der Cloud protokolliert.
In diesem Leitfaden erfahren Sie, wie Sie Add-on-Fehlerprotokolle im Cloud Logs Explorer abfragen, um Folgendes zu tun:
- Herausfinden, ob Nutzer Fehler feststellen
- Sie können sehen, wie oft Fehler auftreten und welche am häufigsten sind.
- Lesen Sie beschreibende Fehlermeldungen, die Ihnen bei der Behebung helfen.
Vorbereitung
Bevor Sie Add-on-Fehlerprotokolle 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.
- Das Add-on im Google Workspace Marketplace veröffentlichen Informationen zum Veröffentlichen eines Add-ons im Marketplace finden Sie unter App veröffentlichen.
Add-on-Fehlerlogs abfragen
So rufen Sie Protokolle für ein Add-on ab:
- Öffnen Sie die Google Cloud Console.
- Klicken Sie neben „Google Cloud-Plattform“ auf den Abwärtspfeil und wählen Sie das Add-on-Projekt aus.
- Klicken Sie links oben auf das Dreistrich-Menü > Protokollierung. Der Log-Explorer wird geöffnet.
Geben Sie für Add-on-Fehlerprotokolle im Query Builder die folgende Abfrage ein:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Klicken Sie auf Abfrage ausführen, um die letzten Fehler aufzurufen. Wenn Sie Fehler direkt sehen möchten, klicken Sie auf Stream-Protokolle. Add-on-Fehlerprotokolle werden im Bereich „Abfrageergebnisse“ angezeigt.
Weitere Informationen zum Cloud Logs Explorer und zum Erstellen von Abfragen finden Sie unter den folgenden Links:
Fehlerprotokollierung aktivieren oder deaktivieren
Die Fehlerprotokollierung ist standardmäßig aktiviert. Wenn die Fehlerprotokollierung aktiviert ist, enthält die Manifestdatei Folgendes:
"exceptionLogging": "STACKDRIVER",
Wenn Sie die Fehlerprotokollierung deaktivieren möchten, ersetzen Sie "exceptionLogging": "STACKDRIVER", in der Manifestdatei durch die folgende Zeile:
// Disable error logging
"exceptionLogging": "NONE"
Wenn Sie die Fehlerprotokollierung wieder aktivieren möchten, ersetzen Sie "exceptionLogging": "NONE" durch "exceptionLogging": "STACKDRIVER",.
Hinweise
Beachten Sie bei der Arbeit mit Add-on-Fehlerprotokollen im Cloud Logs Explorer Folgendes:
- Add-ons protokollieren nur Fehler im Log-Explorer. Andere Protokolltypen werden nicht aufgezeichnet.
- Fehlermeldungen sind immer auf Englisch.
- Für Cloud Logging fallen Kosten an. Weitere Informationen zu den Preisen für Cloud Logging finden Sie unter Preise für Google Cloud Observability.