Jeśli opublikowany dodatek do Google Workspace zwraca błąd, interfejsu dodatku zwraca ogólny komunikat „Podczas uruchamiania dodatku coś poszło nie tak”. Błędy te są jednak użytkownik zalogował się w eksploratorze logów Cloud.
Ten przewodnik opisuje, jak wysyłać zapytania dotyczące logów błędów dodatku Eksplorator logów Cloud, dzięki czemu możesz:
- Dowiedz się, czy użytkownicy napotykają błędy.
- Sprawdź, jak często występują błędy i które najczęściej występują.
- Przeczytaj opisowe komunikaty o błędach, które pomogą Ci w naprawianiu błędów.
Wymagania wstępne
Zanim wyślesz zapytanie dotyczące logów błędów dodatku:
- Włącz „Cloud Logging API” w Projekt Google Cloud. 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 Rynek: patrz Opublikuj aplikację.
Logi błędów dodatku do zapytań
Aby pobrać logi dodatku:
- Otwórz konsolę Google Cloud.
- Obok „Google Cloud Platform” kliknij strzałkę w dół i wybierz projektu dodatku.
- W lewym górnym rogu kliknij Menu . > Logowanie. Otworzy się eksplorator logów.
W przypadku logów błędów dodatku w konstruktorze zapytań wpisz następujące zapytanie:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Aby wyświetlić ostatnie błędy, kliknij Uruchom zapytanie. Lub zobacz błędy w miarę kliknij Prześlij strumieniowo logi. Logi błędów dodatków są widoczne „Wyniki zapytania” panel.
Więcej informacji o Eksploratorze logów Cloud i tworzeniu zapytań znajdziesz w dokumentacji, która opisuje następujące:
Włączanie i wyłączanie logowania błędów
Domyślnie logowanie błędów jest włączone. Gdy logowanie błędów jest włączone, plik manifestu ma następujące elementy:
"exceptionLogging": "STACKDRIVER",
Aby wyłączyć logowanie błędów, zastąp
"exceptionLogging": "STACKDRIVER", z następującym wierszem w
plik manifestu:
// Disable error logging
"exceptionLogging": "NONE"
Aby ponownie włączyć logowanie błędów, zastąp "exceptionLogging": "NONE" wartością
"exceptionLogging": "STACKDRIVER",
Uwagi
Podczas pracy z logami błędów dodatków w logach Cloud Eksplorator, zwróć uwagę na te kwestie:
- Dodatki rejestrują błędy tylko w eksploratorze logów. Inne typy logów to niezarejestrowane.
- Komunikaty o błędach są zawsze napisane w języku angielskim.
- Usługa Cloud Logging wiąże się z naliczaniem opłat. Więcej informacji o Cloud Logging zapoznaj się z cennikiem Google Cloud Observability.