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

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

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

Предпосылки

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

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

    Перейти к Log Explorer

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

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

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

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

Прочитать сообщение об ошибке из журнала

После запроса к журналу ошибок вы можете просмотреть отдельные журналы, содержащие описание журнала в формате JSON. Для ошибок приложения Chat JSON включает сообщение об ошибке jsonPayload.error.message . Например, в следующем примере журнала сообщение об ошибке указывает на то, что функция скрипта приложения не была выполнена:

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 Functions , рекомендуется также проверить журналы Cloud Functions в Logs Explorer.

  • Сообщения об ошибках всегда пишутся на английском языке.

  • Ведение облачных журналов является платным. Подробнее о ценах на облачные журналы см. в разделе «Цены на операционные решения Google Cloud» .

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