Z tego przewodnika dowiesz się, jak wysyłać zapytania do logów błędów aplikacji do obsługi czatu w eksploratorze logów Google Cloud. Zapytania do logów:
- 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 i dane dziennika, które pomogą Ci je naprawić.
Wymagania wstępne
- Konto Google Workspace z dostępem do Google Chat.
- Aplikacja Google Chat. Aby utworzyć aplikację Google Chat, skorzystaj z tego krótkiego wprowadzenia.
- Włączanie rejestrowania błędów w aplikacji Google Chat.
Logi błędów zapytań
W konsoli Google Cloud kliknij Menu > Więcej usług > Logowanie > Eksplorator logów.
Aby wyświetlić konstruktor zapytań, w razie potrzeby włącz opcję Pokaż zapytanie.
Aby wyświetlić dzienniki błędów aplikacji Chat, 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ę ich występowania, kliknij Dzienniki strumienia. Logi błędów aplikacji do obsługi czatu pojawiają się w panelu „Wyniki zapytania”.
Aby dowiedzieć się więcej o eksploratorze logów Google Cloud i tworzenie zapytań, zapoznaj się z tymi przewodnikami w dokumentacji eksploratora logów:
Czytanie komunikatu o błędzie w logu
Po wysłaniu zapytania o dziennik błędów możesz wyświetlić poszczególne dzienniki, które składają się z ładunku JSON opisującego dziennik. W przypadku błędów aplikacji Google Chat plik JSON zawiera komunikat o błędzie w elemencie jsonPayload.error.message
. Na przykład w tym przykładowym dzienniku komunikat o błędzie informuje, że nie udało się wykonać funkcji w 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 do obsługi czatu w eksploratorze logów Google Cloud zwróć uwagę na te kwestie:
W przypadku aplikacji Google Chat eksplorator logów zawiera obecnie logi o tych poziomach ważności, które pomagają w rozwiązywaniu problemów z niedziałającą aplikacją:
ERROR
Logi powiązanych usług również mogą pomóc w debugowaniu aplikacji Google Chat. Jeśli na przykład aplikacja Google Chat jest wdrożona za pomocą Google Cloud Functions, zalecamy sprawdzenie w Eksploratorze logów również logów Cloud Functions.
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 pakietu operacyjnego Google Cloud.
Powiązane artykuły
Jeśli po przeanalizowaniu dzienników błędów znajdziesz błędy, zapoznaj się z tymi instrukcjami, aby je naprawić:
- Dowiedz się, jak naprawiać 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ą być wykluczani z pokoju”.
- Dowiedz się, jak naprawiać błędy kart, takie jak wiadomości na karcie, okna dialogowe lub podgląd linków, które nie działają zgodnie z oczekiwaniami.
- Dowiedz się, jak debugować