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

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

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

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

Журналы ошибок запросов

  1. В консоли Google API перейдите > Дополнительные продукты > Ведение журналов > Обозреватель журналов .

    Перейдите в Log Explorer

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

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

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

Чтобы узнать больше о 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 для операционной деятельности .

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