В этом руководстве описано, как запрашивать журналы ошибок приложения «Чат» в Google Cloud Logs Explorer . Запрос журналов осуществляется по адресу:
- Узнайте, сталкиваются ли пользователи с ошибками.
- Посмотрите, как часто возникают ошибки и какие из них встречаются чаще всего.
- Прочтите подробные сообщения об ошибках и данные журналов, которые помогут вам исправить ошибки.
Предварительные требования
- Учетная запись Google Workspace с доступом к Google Chat.
- Приложение для чата. Чтобы создать приложение для чата, следуйте этому краткому руководству .
- Включите ведение журнала ошибок для приложения «Чат».
Журналы ошибок запросов
В консоли Google API перейдите > Дополнительные продукты > Ведение журналов > Обозреватель журналов .
При необходимости, чтобы отобразить построитель запросов, включите параметр «Показать запрос» .
Для просмотра журналов ошибок приложения «Чат» введите следующий запрос:
severity=ERROR resource.type="chat.googleapis.com/Project"Чтобы просмотреть последние ошибки, нажмите «Выполнить запрос» . Или, чтобы просмотреть ошибки по мере их возникновения, нажмите «Журналы потока ». Журналы ошибок приложения чата отображаются в панели «Результаты запроса».
Чтобы узнать больше о Google Cloud Logs Explorer и написании запросов, ознакомьтесь с этими руководствами в документации Logs Explorer:
Прочитать сообщение об ошибке из журнала
После запроса к журналу ошибок вы можете просмотреть отдельные записи, которые представляют собой JSON-данные, описывающие сообщение об ошибке. Для ошибок приложения «Чат» 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"
}
Соображения
При работе с журналами ошибок приложения «Чат» в Google Cloud Logs Explorer обратите внимание на следующие моменты:
Для приложений Google Chat Logs Explorer содержит журналы со следующими уровнями серьезности, которые помогают устранить неполадки в работе приложения:
-
ERROR
Журналы связанных служб также могут помочь в отладке приложения чата. Например, если вы развертываете приложение чата с помощью функций Google Cloud Run , проверьте также журналы функций Cloud Run в Logs Explorer.
-
Сообщения об ошибках всегда пишутся на английском языке.
Ведение облачного логирования влечет за собой затраты. Для получения дополнительной информации о ценах на облачное логирование обратитесь к прайс-листу пакета услуг Google Cloud для операционной деятельности .
Связанные темы
Если после анализа журналов ошибок вы обнаружите ошибки, обратитесь к следующим руководствам для получения помощи в их устранении:
- Узнайте, как исправить ошибки приложения Google Chat, такие как «Приложение не отвечает», «API Google Chat доступен только пользователям Google Workspace» или «Пользователей можно исключить из рабочих пространств».
- Узнайте, как исправить ошибки в карточках, например, когда сообщения на карточках, диалоговые окна или предварительный просмотр ссылок не отображаются или работают должным образом.
- Научитесь отлаживать программы.