Dzienniki błędów zapytań w Google Workspace Add-ons

Gdy opublikowany dodatek do Google Workspace zwraca błąd, interfejs dodatku wyświetla ogólny komunikat „Coś poszło nie tak podczas uruchamiania dodatku”. Te błędy są jednak logowane w eksploratorze logów Cloud.

Uwaga: w przypadku Apps Script, jeśli dodatek jest wdrażany jako test, błędy są zgłaszane zarówno w Eksploratorze logów w chmurze, jak i w interfejsie dodatku.

Na przykład wdrożenie testowe dodatku może wyświetlać w interfejsie komunikat o błędzie podobny do tego: TypeError: card.INVALIDFUNCTIONNAME is not a function [line: 33, function: getContextualAddOn, file: GetContextualAddOn].

Komunikaty o błędach, takie jak ten, są przydatne, ale dodatkowe informacje znajdziesz w Eksploratorze logów. Zalecamy sprawdzenie logów błędów, aby uzyskać więcej informacji. Więcej informacji o testowaniu wdrożeń dodatków znajdziesz w artykule Testowanie i debugowanie dodatków do Google Workspace.

Z tego przewodnika dowiesz się, jak wysyłać zapytania o logi błędów dodatków w Eksploratorze logów Cloud, aby:

• Sprawdzaj, czy użytkownicy napotykają błędy.
• Sprawdź, jak często występują błędy i które z nich pojawiają się najczęściej.
• czytać opisowe komunikaty o błędach, które pomagają je naprawić;

Wymagania wstępne

Zanim wyślesz zapytanie dotyczące dzienników błędów dodatku:

• włączyć „Cloud Logging API” w projekcie Google Cloud dodatku; Aby włączyć interfejs API, zapoznaj się z artykułem Tworzenie projektu w chmurze 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 dodatków

Aby uzyskać dzienniki dodatku:

1. Otwórz konsolę Google Cloud.
2. Obok opcji „Google Cloud Platform” kliknij strzałkę w dół  i wybierz projekt dodatku.
3. W lewym górnym rogu kliknij Menu  > Logowanie. Otworzy się eksplorator logów.

4. Aby wyświetlić dzienniki błędów dodatku, w konstruktorze zapytań wpisz to zapytanie:

   severity>=ERROR
   protoPayload.serviceName="gsuiteaddons.googleapis.com"
   

5. Aby zobaczyć ostatnie błędy, kliknij Uruchom zapytanie. Aby wyświetlać błędy na bieżąco, kliknij Odtwórz logi. Dzienniki błędów dodatków pojawiają się w panelu „Wyniki zapytania”.

Więcej informacji o eksploratorze logów Cloud i pisaniu zapytań znajdziesz w tych artykułach:

• Korzystanie z eksploratora logów
• Tworzenie zapytań

Włączanie i wyłączanie rejestrowania błędów

Domyślnie rejestrowanie błędów jest włączone. Gdy rejestrowanie błędów jest włączone, plik manifestu zawiera:

"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ć rejestrowanie błędów, zastąp "exceptionLogging": "NONE" ciągiem "exceptionLogging": "STACKDRIVER",.

Uwagi

Podczas pracy z logami błędów dodatków w eksploratorze logów Cloud Logs pamiętaj o tych kwestiach:

• 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.
• Cloud Logging wiąże się z kosztami. Więcej informacji o cenach Cloud Logging znajdziesz w cenniku Google Cloud Observability.