Gibt ein veröffentlichtes Google Workspace-Add-on einen Fehler zurück, Add-on-Schnittstelle eine allgemeine Meldung „Beim Ausführen des Add-ons ist ein Fehler aufgetreten.“ Diese Fehler sind jedoch im Cloud Log-Explorer protokolliert.
In diesem Leitfaden wird beschrieben, wie Sie Add-on-Fehlerlogs in Cloud Log-Explorer für folgende Aufgaben:
- Sie erfahren, ob bei Nutzern Fehler auftreten.
- Sehen Sie sich an, wie oft und welche Fehler am häufigsten auftreten.
- Lesen Sie beschreibende Fehlermeldungen, die Ihnen bei der Fehlerbehebung helfen.
Vorbereitung
Vor dem Abfragen von Add-on-Fehlerlogs:
- „Cloud Logging API“ aktivieren im Add-on Google Cloud-Projekt Informationen zum Aktivieren einer API finden Sie unter Erstellen Sie ein Cloud-Projekt und aktivieren Sie die API.
- Veröffentlichen Sie das Add-on im Google Workspace Marketplace. So veröffentlichen Sie ein Add-on auf der Marketplace, siehe Veröffentlichen Sie eine App.
Fehlerlogs für Abfrage-Add-ons
So rufen Sie Logs für ein Add-on ab:
- Öffnen Sie die Google Cloud Console.
- Neben „Google Cloud Platform“ klicken Sie auf den Abwärtspfeil und wählen Sie Add-on-Projekt zu erstellen.
- Klicke links oben auf das Dreistrich-Menü . > Logging. Der Log-Explorer wird geöffnet.
Geben Sie für Add-on-Fehlerlogs im Query Builder Folgendes ein: folgende Abfrage:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Klicken Sie auf Abfrage ausführen, um aktuelle Fehler zu sehen. Oder um Fehler in Echtzeit klicken Sie auf Stream Logs (Logs streamen). Add-on-Fehlerlogs werden in der „Abfrageergebnisse“ .
Weitere Informationen zum Cloud-Log-Explorer und zum Schreiben von Abfragen finden Sie unter Folgendes:
Fehler-Logging aktivieren oder deaktivieren
Das Fehler-Logging ist standardmäßig aktiviert. Wenn das Fehler-Logging aktiviert ist, Manifestdatei enthält Folgendes:
"exceptionLogging": "STACKDRIVER",
Um das Fehler-Logging zu deaktivieren, ersetzen Sie
"exceptionLogging": "STACKDRIVER", durch die folgende Zeile im
Manifestdatei:
// Disable error logging
"exceptionLogging": "NONE"
Ersetzen Sie "exceptionLogging": "NONE" durch
"exceptionLogging": "STACKDRIVER",.
Hinweise
Wenn Sie in Cloud Logs mit Add-on-Fehlerlogs arbeiten Explorer erhalten, beachten Sie die folgenden Überlegungen:
- Add-ons protokollieren nur Fehler im Log-Explorer. Andere Logtypen sind nicht aufgezeichnet.
- Fehlermeldungen werden immer auf Englisch verfasst.
- Für Cloud Logging fallen Kosten an. Weitere Informationen zu Cloud Logging finden Sie unter Google Cloud Observability – Preise.