Registros de errores de consulta de las apps de Google Chat

En esta guía, se describe cómo consultar los registros de errores de la app de Chat en el Explorador de registros de Google Cloud. Consultar registros en:

  • Saber si los usuarios encuentran errores
  • Consulta con qué frecuencia ocurren los errores y cuáles son los más frecuentes.
  • Leer mensajes de error descriptivos y registrar datos que te ayuden a corregir los errores

Requisitos previos

Registros de errores de consultas

  1. En el menú de navegación de la consola de Google Cloud, haz clic en Menú > Más productos > Logging > Explorador de registros.

    Ir al Explorador de registros

  2. Si es necesario, para mostrar el compilador de consultas, activa Mostrar consulta.

  3. Para los registros de errores de la app de Chat, ingresa la siguiente búsqueda:

    severity=ERROR
resource.type="chat.googleapis.com/Project"

  4. Para ver los errores recientes, haz clic en Ejecutar consulta. O bien, para ver los errores a medida que ocurren, haz clic en Registros de transmisión. Los registros de errores de la app de Chat aparecen en el panel "Resultados de la consulta".

Para obtener más información sobre el Explorador de registros de Google Cloud y cómo escribir consultas, consulta estas guías en la documentación del Explorador de registros:

Cómo leer un mensaje de error de un registro

Después de consultar un registro de errores, puedes ver registros individuales que constan de una carga útil JSON que describe el registro. En el caso de los errores de la app de Chat, el objeto JSON incluye el mensaje de error en jsonPayload.error.message. Por ejemplo, en el siguiente registro de muestra, el mensaje de error indica que no se pudo ejecutar una función de 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"
}

Consideraciones

A medida que trabajas con los registros de errores de la app de Chat en el Explorador de registros de Google Cloud, ten en cuenta estas consideraciones:

  • En el caso de las apps de Google Chat, el Explorador de registros actualmente incluye registros con los siguientes niveles de gravedad, que ayudan a solucionar problemas de una app que no funciona correctamente:

    • ERROR

    Los registros de los servicios relacionados también pueden ayudar a depurar una app de Chat. Por ejemplo, si una app de Chat se implementa con Google Cloud Functions, se recomienda consultar el Explorador de registros para ver los registros de Cloud Functions también.

  • Los mensajes de error siempre se escriben en inglés.

  • Cloud Logging genera costos. Para obtener más información sobre los precios de Cloud Logging, consulta Precios de Google Cloud's operations suite.

Después de consultar los registros de errores, si encuentras errores, consulta las siguientes guías para obtener ayuda para corregirlos: