Эта страница переведена с помощью Cloud Translation API.

Запрос журналов ошибок для приложений Google Chat

В этом руководстве описывается, как запросить журналы ошибок приложения Chat в Google Cloud Logs Explorer . Запросить журналы:

Узнайте, сталкиваются ли пользователи с ошибками.
Посмотрите, как часто возникают ошибки и какие встречаются чаще всего.
Прочтите описательные сообщения об ошибках и данные журнала, которые помогут вам исправить ошибки.

Предварительные условия

Аккаунт Google Workspace с доступом к Google Chat.
Приложение для чата. Чтобы создать приложение Chat, следуйте этому краткому руководству .
Включите ведение журнала ошибок для приложения Chat.

Запрос журналов ошибок

В консоли Google Cloud нажмите Меню > продукты > Ведение журналов > Обозреватель журналов .
Перейти в обозреватель журналов
При необходимости, чтобы отобразить построитель запросов, включите параметр «Показать запрос» .
Для журналов ошибок приложения Chat введите следующий запрос:
```
severity=ERROR
resource.type="chat.googleapis.com/Project"
```
Чтобы просмотреть недавние ошибки, нажмите «Выполнить запрос» . Или, чтобы просмотреть ошибки по мере их возникновения, нажмите «Потоковые журналы» . Журналы ошибок приложения чата отображаются на панели «Результаты запроса».

Дополнительные сведения о Google Cloud Logs Explorer и написании запросов см. в следующих руководствах в документации Logs Explorer:

Чтение сообщения об ошибке из журнала

После запроса журнала ошибок вы можете просмотреть отдельные журналы, которые состоят из полезных данных JSON, описывающих журнал. Для ошибок приложения Chat JSON включает сообщение об ошибке по адресу jsonPayload.error.message . Например, в следующем образце журнала в сообщении об ошибке говорится, что не удалось выполнить функцию 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"
}

Соображения

Работая с журналами ошибок приложения Chat в Google Cloud Logs Explorer, обратите внимание на следующие моменты:

Для приложений Google Chat в настоящее время обозреватель журналов включает журналы со следующими уровнями серьезности, которые помогают устранить неполадки в неисправном приложении:
- ERROR
Журналы связанных служб также могут помочь в отладке приложения Chat. Например, если приложение чата развернуто с помощью Google Cloud Functions , рекомендуется также проверить журналы Logs Explorer в Logs Explorer.
Сообщения об ошибках всегда пишутся на английском языке.
Облачное ведение журнала требует затрат. Дополнительную информацию о ценах на ведение журналов в облаке см. в ценах на операционный пакет Google Cloud .

Связанные темы

Если после запроса журналов ошибок вы обнаружите ошибки, обратитесь к следующим руководствам, которые помогут исправить ошибки:

Узнайте, как исправить ошибки приложения Google Chat, такие как «Приложение не отвечает», «API Google Chat доступен только пользователям Google Workspace» или «Пользователей можно исключить из групп».
Узнайте, как исправить ошибки карточек, такие как сообщения карточек, диалоги или предварительный просмотр ссылок, которые не отображаются или не работают должным образом.
Узнайте, как отлаживать.

В этом руководстве описывается, как запросить журналы ошибок приложения Chat в Google Cloud Logs Explorer . Журналы запросов к:

Узнайте, сталкиваются ли пользователи с ошибками.
Посмотрите, как часто возникают ошибки и какие встречаются чаще всего.
Прочитайте описательные сообщения об ошибках и данные журнала, которые помогут вам исправить ошибки.