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

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

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

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

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

  1. В Google Cloud нажмите Меню > Дополнительные продукты > Ведение журналов > Обозреватель журналов .

    Перейти в обозреватель журналов

  2. При необходимости, чтобы отобразить построитель запросов, включите параметр «Показать запрос» .

  3. Для журналов ошибок приложения Chat введите следующий запрос:

    severity=ERROR
    resource.type="chat.googleapis.com/Project"
    
  4. Чтобы просмотреть недавние ошибки, нажмите «Выполнить запрос» . Или, чтобы просмотреть ошибки по мере их возникновения, нажмите «Потоковые журналы» . Журналы ошибок приложения чата отображаются на панели «Результаты запроса».

Дополнительные сведения о 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 .

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