Gdy opublikowany dodatek Google Workspace zwróci błąd, interfejs dodatku wyświetli ogólny komunikat „Coś poszło nie tak podczas uruchamiania dodatku”. Błędy te są jednak rejestrowane w Eksploratorze logów Cloud.
W tym przewodniku opisano, jak w Eksploratorze logów Cloud tworzyć zapytania dotyczące logów błędów w dodatku. Dzięki temu możesz:
- Dowiedz się, czy użytkownicy napotykają błędy.
- Zobacz, jak często występują błędy i które z nich są najczęstsze.
- Czytaj opisowe komunikaty o błędach, które pomogą Ci je naprawić.
Wymagania wstępne
Zanim prześlesz zapytanie do dzienników błędów dodatku:
- Włącz interfejs „Cloud Logging API” w projekcie Google Cloud dodatku. Aby włączyć interfejs API, zapoznaj się z artykułem Tworzenie projektu Cloud i włączanie interfejsu API.
- Opublikuj dodatek w Google Workspace Marketplace. Aby opublikować dodatek w Marketplace, zapoznaj się z artykułem Publikowanie aplikacji.
Wysyłanie zapytań do dzienników błędów dodatku
Aby uzyskać dzienniki dotyczące dodatku:
- Otwórz konsolę Google Cloud.
- Obok opcji „Google Cloud Platform” kliknij strzałkę w dół i wybierz projekt dodatku.
- W lewym górnym rogu kliknij Menu > Rejestrowanie. Otworzy się Eksplorator logów.
W przypadku dzienników błędów w dodatku w konstruktorze zapytań wpisz to zapytanie:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Aby wyświetlić ostatnie błędy, kliknij Uruchom zapytanie. Aby zobaczyć błędy w miarę ich występowania, kliknij Logi transmisji. Błędy dodatków są zapisywane w panelu „Wyniki zapytania”.
Więcej informacji o eksploratorze Cloud Logs i pisaniu zapytań znajdziesz w tych artykułach:
Włączanie i wyłączanie rejestrowania błędów
Domyślnie rejestrowanie błędów jest włączone. Gdy włączone jest rejestrowanie błędów, plik manifestu zawiera te informacje:
"exceptionLogging": "STACKDRIVER",
Aby wyłączyć rejestrowanie błędów, w pliku manifestu zastąp "exceptionLogging": "STACKDRIVER", tym wierszem:
// Disable error logging
"exceptionLogging": "NONE"
Aby ponownie włączyć rejestrowanie błędów, zastąp "exceptionLogging": "NONE" kodem "exceptionLogging": "STACKDRIVER",.
Uwagi
Podczas pracy z logami błędów dodatków w eksploratorze logów Cloud zwróć uwagę na te kwestie:
- Dodatki rejestrują tylko błędy w eksploratorze logów. Inne typy dzienników nie są rejestrowane.
- Komunikaty o błędach są zawsze pisane po angielsku.
- Korzystanie z usługi Cloud Logging wiąże się z kosztami. Więcej informacji o cenach Cloud Logging znajdziesz w cenniku Google Cloud Observability.