Wenn ein veröffentlichtes Google Workspace-Add-on einen Fehler zurückgibt, gibt die Add-on-Schnittstelle eine allgemeine Meldung zurück: „Bei der Ausführung des Add-ons ist ein Fehler aufgetreten.“ Diese Fehler werden jedoch im Cloud Log-Explorer protokolliert.
In dieser Anleitung wird beschrieben, wie Sie Add-on-Fehlerlogs in Cloud Log Explorer abfragen, sodass Sie Folgendes tun können:
- Prüfen, ob Nutzer Fehler bemerken
- Sehen Sie, wie oft und welche Fehler am häufigsten vorkommen.
- Lesen Sie beschreibende Fehlermeldungen, die Ihnen bei der Fehlerbehebung helfen.
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 die API aktivieren.
- Veröffentlichen Sie das Add-on im Google Workspace Marketplace. Informationen zum Veröffentlichen eines Add-ons auf dem Marketplace finden Sie unter App veröffentlichen.
Logs zu Add-on-Abfragen
So rufen Sie Protokolle für ein Add-on ab:
- Öffnen Sie die Google Cloud Console.
- Klicken Sie neben „Google Cloud Platform“ auf den Drop-down-Pfeil und wählen Sie das Add-on-Projekt aus.
- Klicken Sie links oben auf das Dreistrich-Menü > Logging. Der Log-Explorer wird geöffnet.
Geben Sie im Abfrage-Builder für Add-on-Fehlerlogs die folgende Abfrage ein:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Klicken Sie auf Abfrage ausführen, um die letzten Fehler anzusehen. Sie können auch auf Logs streamen klicken, um die aufgetretenen Fehler zu sehen. Add-ons-Fehlerlogs werden im Bereich „Abfrageergebnisse“ angezeigt.
Weitere Informationen zum Cloud Log-Explorer und zum Schreiben von Abfragen finden Sie unter:
Fehler-Logging aktivieren oder deaktivieren
Das Fehler-Logging ist standardmäßig aktiviert. Wenn 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",.
Wissenswertes
Beachten Sie bei der Arbeit mit Add-on-Fehlerlogs in Cloud Log Explorer folgende Überlegungen:
- Add-ons protokollieren nur Fehler im Log-Explorer. Andere Logtypen werden nicht aufgezeichnet.
- Fehlermeldungen werden immer auf Englisch verfasst.
- Für Cloud Logging fallen Kosten an. Weitere Informationen zu den Preisen für Cloud Logging finden Sie unter Preise für die Operations-Suite von Google Cloud.