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. Consulta registros para:
- Descubre si los usuarios encuentran errores.
- Consulta la frecuencia con la que se producen errores y los más frecuentes.
- Lee mensajes de error descriptivos y registra datos que te ayudarán a corregir los errores.
Requisitos previos
- Una cuenta de Google Workspace con acceso a Google Chat
- Una app de Chat Para compilar una app de Chat, sigue esta guía de inicio rápido.
- Activa el registro de errores para la app de Chat.
Registros de errores de consulta
En la consola de Google Cloud, haz clic en Menú. > Más productos > Registro > Explorador de registros.
Si es necesario, activa Mostrar consulta para mostrar el compilador de consultas.
Para ver los registros de errores de la app de Chat, ingresa la siguiente consulta:
severity=ERROR resource.type="chat.googleapis.com/Project"
Para ver los errores recientes, haz clic en Ejecutar consulta. O bien, para ver los errores a medida que se producen, haz clic en Transmitir registros. Los registros de errores de la app de Chat aparecen en los “Resultados de la consulta” del panel de control.
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:
Lee un mensaje de error de un registro
Después de consultar un registro de errores, puedes ver registros individuales que consisten en una carga útil de JSON que describe el registro. En el caso de los errores de la app de Chat, el JSON incluye el mensaje de error que se encuentra 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
Cuando trabajes con 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, actualmente el Explorador de registros incluye registros con la siguiente gravedad que ayudan a solucionar problemas relacionados con apps que no funcionan correctamente:
ERROR
Los registros de 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 verificar también los registros del Explorador de registros para Cloud Functions.
Los mensajes de error siempre se escriben en inglés.
Cloud Logging genera un costo. Para obtener más información sobre los precios de Cloud Logging, consulta los precios de Google Cloud's operations suite.
Temas relacionados
Si encuentras errores después de consultar los registros de errores, consulta las siguientes guías para obtener ayuda sobre cómo corregir errores:
- Aprende a corregir errores de la app de Google Chat, como “La app no responde”, “La API de Google Chat solo está disponible para los usuarios de Google Workspace” o “Los usuarios pueden excluirse de los espacios”.
- Obtén más información para corregir errores de tarjetas, como los mensajes de tarjetas, los diálogos o las vistas previas de vínculos que no se renderizan o no funcionan según lo esperado.
- Obtén información para depurar.