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

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 pozwalają:

  • sprawdzić, czy użytkownicy napotykają błędy;
  • sprawdzić, jak często występują błędy i które z nich są najczęstsze;
  • odczytywać opisowe komunikaty o błędach i dane logów, które pomagają naprawić błędy.

Wymagania wstępne

  • Konto Google Workspace z dostępem do Google Chat.
  • Aplikacja do obsługi czatu. Aby utworzyć aplikację do obsługi czatu, postępuj zgodnie z instrukcjami w tym krótkim wprowadzeniu.
  • Włącz logowanie błędów w aplikacji do obsługi czatu.

Wysyłanie zapytań do logów błędów

  1. W Konsoli interfejsów API Google kliknij Menu > Więcej usług > Logowanie > Eksplorator logów.

    Otwórz Eksplorator logów

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

  3. W przypadku logów błędów aplikacji do obsługi czatu wpisz to zapytanie:

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

  4. Aby wyświetlić ostatnie błędy, kliknij Uruchom zapytanie. Aby wyświetlać błędy w miarę ich występowania, kliknij Przesyłaj logi strumieniowo. Logi błędów aplikacji do obsługi czatu pojawią się w panelu „Wyniki zapytania”.

Więcej informacji o eksploratorze logów Google Cloud i pisaniu zapytań znajdziesz w tych przewodnikach w dokumentacji eksploratora logów:

Odczytywanie komunikatu o błędzie z logu

Po wysłaniu zapytania do logu błędów możesz wyświetlić poszczególne logi, które składają się z ładunku JSON opisującego log. W przypadku błędów aplikacji do obsługi czatu kod JSON zawiera komunikat o błędzie w 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 do obsługi czatu w eksploratorze logów Google Cloud zwróć uwagę na te kwestie:

  • W przypadku aplikacji Google Chat eksplorator logów zawiera logi o tych poziomach ważności, które pomagają rozwiązywać problemy z nieprawidłowo działającą aplikacją:

    • ERROR

    Logi powiązanych usług mogą też pomóc w debugowaniu aplikacji do obsługi czatu. Jeśli na przykład wdrożysz aplikację do obsługi czatu za pomocą funkcji Google Cloud Run, sprawdź też logi funkcji Cloud Run w eksploratorze logów.

  • Komunikaty o błędach są zawsze pisane w języku angielskim.

  • Usługa Cloud Logging jest płatna. Więcej informacji o cenach usługi Cloud Logging znajdziesz w cenniku pakietu operacyjnego Google Cloud.

Jeśli po wysłaniu zapytania do logów błędów znajdziesz błędy, zapoznaj się z tymi przewodnikami, aby uzyskać pomoc w ich naprawieniu: