Gdy opublikowany dodatek do Google Workspace zwraca błąd, interfejs dodatku zwraca ogólny komunikat „Podczas wykonywania dodatku coś poszło nie tak”. Błędy te są jednak rejestrowane w eksploratorze logów Cloud.
Z tego przewodnika dowiesz się, jak tworzyć zapytania do logów błędów dodatków w eksploratorze logów Cloud. Dzięki temu możesz:
- Dowiedz się, czy użytkownicy napotykają błędy.
- Sprawdź, jak często występują błędy i które występują najczęściej.
- Zapoznaj się z opisowymi komunikatami o błędach, które pomogą Ci je naprawić.
Wymagania wstępne
Zanim wyślesz zapytanie do logów błędów dodatku:
- Włącz „Cloud Logging API” w projekcie Google Cloud dodatku. Aby włączyć interfejs API, przeczytaj artykuł Tworzenie projektu Cloud i włączanie interfejsu API.
- Opublikuj dodatek w Google Workspace Marketplace. Informacje o tym, jak opublikować dodatek w Marketplace, znajdziesz w sekcji Publikowanie aplikacji.
Wysyłanie zapytań o logi błędów dodatku
Aby pobrać dzienniki dodatku:
- Otwórz konsolę Google Cloud.
- Obok „Google Cloud Platform” kliknij strzałkę w dół i wybierz projekt dodatku.
- W lewym górnym rogu kliknij Menu > Logowanie. Otworzy się eksplorator logów.
Aby uzyskać logi błędów dodatków, w konstruktorze zapytań wpisz to zapytanie:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"
Aby zobaczyć ostatnie błędy, kliknij Uruchom zapytanie. Możesz też kliknąć Wyświetl strumieniowo logi, aby wyświetlić pojawiające się błędy. Logi błędów dodatków pojawią się w panelu „Wyniki zapytania”.
Więcej informacji o eksploratorze logów Cloud i tworzeniu zapytań znajdziesz tutaj:
Włącz lub wyłącz logowanie błędów
Domyślnie logowanie błędów jest włączone. Gdy logowanie błędów jest włączone, plik manifestu będzie zawierać te informacje:
"exceptionLogging": "STACKDRIVER",
Aby wyłączyć logowanie błędów, zastąp "exceptionLogging": "STACKDRIVER",
tym wierszem w pliku manifestu:
// Disable error logging
"exceptionLogging": "NONE"
Aby ponownie włączyć logowanie błędów, zastąp "exceptionLogging": "NONE"
ciągiem "exceptionLogging": "STACKDRIVER",
.
co należy wziąć pod uwagę
Podczas pracy z logami błędów dodatków w eksploratorze logów Cloud weź pod uwagę te kwestie:
- Dodatki rejestrują błędy tylko w eksploratorze logów. Inne typy logów nie są rejestrowane.
- Komunikaty o błędach są zawsze pisane w języku angielskim.
- Usługa Cloud Logging wiąże się z opłatami. Więcej informacji o opłatach za Cloud Logging znajdziesz w cenniku dostrzegalności Google Cloud.