Z tego przewodnika dowiesz się, jak tworzyć zapytania dotyczące logów błędów aplikacji Google Chat w Eksploratorze logów Google Cloud. Wyślij zapytania dotyczące dzienników do:
- Dowiedz się, czy użytkownicy napotykają błędy.
- Sprawdź, jak często występują błędy i które z nich występują najczęściej.
- Przeczytaj opisowe komunikaty o błędach i dane dziennika, które pomogą Ci w naprawianiu błędów.
Wymagania wstępne
- konto Google Workspace z dostępem do Google Chat,
- aplikację Google Chat, Aby utworzyć aplikację do obsługi czatu, zapoznaj się z krótkim wprowadzeniem.
- Włącz logowanie błędów w aplikacji Google Chat.
Logi błędów zapytań
W konsoli Google Cloud kliknij Menu. > Więcej produktów > Logowanie > Eksplorator logów.
Aby wyświetlić konstruktor zapytań, w razie potrzeby włącz opcję Pokaż zapytanie.
W przypadku dzienników błędów aplikacji do obsługi czatu wpisz to zapytanie:
severity=ERROR resource.type="chat.googleapis.com/Project"
Aby wyświetlić ostatnie błędy, kliknij Uruchom zapytanie. Aby zobaczyć błędy w miarę pojawiania się błędów, kliknij Prześlij strumieniowo logi. Logi błędów aplikacji do obsługi czatu pojawiają się w sekcji „Wyniki zapytania” panel.
Więcej informacji o eksploratorze logów Google Cloud i tworzeniu zapytań znajdziesz w tych przewodnikach w dokumentacji eksploratora logów:
Odczytywanie komunikatu o błędzie z dziennika
Po wykonaniu zapytania na logu błędów możesz wyświetlić poszczególne logi zawierające ładunek JSON opisujący dany dziennik. W przypadku błędów aplikacji do obsługi czatu plik JSON zawiera komunikat o błędzie jsonPayload.error.message
. Na przykład w tym przykładowym logu komunikat o błędzie informuje, że nie udało się wykonać funkcji Apps Script:
JSON
{
"insertId": "INSERT_ID",
"jsonPayload": {
"@type": "type.googleapis.com/google.chat.logging.v1.ChatAppLogEntry",
"error": {
"code": 9,
"message": "An Apps Script function failed to execute. To review AppsScript error logs, see \"Logging\" (https://developers.google.com/apps-script/guides/logging)."
},
"deployment": "DEPLOYMENT_ID"
},
"resource": {
"type": "chat.googleapis.com/Project",
"labels": {
"project_id": "PROJECT_ID"
}
},
"timestamp": "2022-12-06T05:24:18.697255Z",
"severity": "ERROR",
"logName": "projects/PROJECT_ID/logs/chat.googleapis.com%2Ferrors",
"receiveTimestamp": "2022-12-06T05:24:19.207936968Z"
}
Uwagi
Podczas pracy z logami błędów aplikacji Google Chat w Eksploratorze logów Google Cloud zwróć uwagę na te kwestie:
W przypadku aplikacji Google Chat eksplorator logów obejmuje obecnie dzienniki z następującymi poziomami ważności, które ułatwiają rozwiązywanie problemów z awarią aplikacji:
ERROR
Logi powiązanych usług również mogą ułatwić debugowanie aplikacji Google Chat. Jeśli na przykład aplikacja do obsługi czatu została wdrożona za pomocą Google Cloud Functions, sprawdzoną metodą jest sprawdzenie również logów Cloud Functions w eksploratorze logów.
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 na temat opłat za Cloud Logging znajdziesz w cenniku pakietu operacyjnego Google Cloud.
Powiązane artykuły
Jeśli po wysłaniu zapytania dotyczącego logów błędów znajdziesz błędy, zapoznaj się z tymi przewodnikami, które pomogą Ci je naprawić:
- Dowiedz się, jak naprawić błędy aplikacji Google Chat takie jak „Aplikacja nie odpowiada”, „Interfejs Google Chat API jest dostępny tylko dla użytkowników Google Workspace” lub „Użytkownicy mogą zostać wykluczeni z pokoi”.
- Dowiedz się, jak naprawić błędy kart, takie jak komunikaty kart, okna dialogowe lub podglądy linków, które nie renderują się lub nie działają zgodnie z oczekiwaniami.
- Dowiedz się, jak debugować