Logi błędów zapytań dotyczących aplikacji Google Chat

Z tego przewodnika dowiesz się, jak tworzyć zapytania dotyczące logów błędów aplikacji Google Chat w Eksploratorze logów Google Cloud. Wykonuj zapytania do logów, aby:

  • 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

Logi błędów zapytań

  1. W konsoli Google Cloud kliknij Menu > Więcej usług > Logowanie > Eksplorator logów.

    Otwórz eksplorator logów

  2. Aby wyświetlić konstruktor zapytań, w razie potrzeby włącz opcję Pokaż zapytanie.

  3. Aby wyświetlić dzienniki błędów aplikacji Chat, wpisz to zapytanie:

    severity=ERROR
resource.type="chat.googleapis.com/Project"

  4. 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 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 dzienniku 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 zawiera obecnie logi z tymi poziomami ważności, które pomagają w rozwiązywaniu problemów z nieprawidłowo działającą aplikacją:

    • 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 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.

Jeśli po przeanalizowaniu dzienników błędów znajdziesz błędy, zapoznaj się z tymi instrukcjami, aby je naprawić: