Google Cloud te proporciona las herramientas para supervisar la confiabilidad de tus proyectos con Google Cloud Monitoring y depurar problemas con los registros de errores Google Cloud Logging. Cuando se produce una falla cuando se entregan los intents de usuario, las estadísticas de la canalización de Google Home registran esa falla en tus métricas y publica un registro de errores en los registros de tu proyecto.
Para solucionar los errores, debes seguir dos pasos:
- Supervisa el estado de tus proyectos con las métricas de la casa inteligente.
- Para investigar los problemas, consulta las descripciones detalladas de los errores en los registros de errores.
Supervisa errores
Puedes usar Google Cloud Monitoring dashboard para acceder a las métricas de tu proyecto. Hay algunos gráficos clave que son especialmente útiles para supervisar la calidad y la depuración:
- El gráfico de Tasa de éxito es el primero en el que se comienza cuando supervisas la confiabilidad de tus proyectos. Las caídas en este gráfico pueden indicar una interrupción para una parte o toda tu base de usuarios. Recomendamos supervisar detenidamente este gráfico para detectar cualquier irregularidad después de cada cambio o actualización de tu proyecto.
- El gráfico de Latencia del percentil 95 es un indicador importante del rendimiento de la Acción de tu casa inteligente para los usuarios. Las fluctuaciones repentinas en este gráfico pueden indicar que tus sistemas no pueden ponerse al día con las solicitudes. Se recomienda verificar este gráfico de forma periódica para ver cualquier comportamiento inesperado.
- Los gráficos de Desglose de errores son más útiles para solucionar problemas en tus integraciones. Por cada error destacado en el gráfico de porcentaje de éxito, se muestra un código de error en el desglose de errores. Puedes ver los errores marcados por Google Home platform y cómo solucionarlos en la siguiente tabla.
Códigos de error de la plataforma
Estos son algunos códigos de error comunes que puedes ver en los registros de tu proyecto para identificar los problemas detectados por Google Home platform. Consulta la siguiente tabla para obtener información sobre la solución de problemas.
| Código de error | Descripción |
|---|---|
BACKEND_FAILURE_URL_ERROR |
Google recibió un código de error HTTP 4xx distinto del 401 de tu
servicio.
Usa requestId en GCP Logging para verificar los registros del servicio de casa inteligente.
|
BACKEND_FAILURE_URL_TIMEOUT |
Se agotó el tiempo de espera de la solicitud de Google cuando se intentó comunicarse con tu servicio.
Verifica que tu servicio esté en línea, acepte conexiones y que no haya excedido la capacidad. Además, verifica que el dispositivo de destino esté encendido, en línea y sincronizado. |
BACKEND_FAILURE_URL_UNREACHABLE |
Google recibió un código de error HTTP 5xx de tu servicio.
Usa requestId en GCP Logging para verificar los registros del servicio de casa inteligente.
|
DEVICE_NOT_FOUND |
El dispositivo no existe en el servicio del socio.
Por lo general, esto indica una falla en la sincronización de datos o una condición de carrera. |
GAL_BAD_3P_RESPONSE |
Google no puede analizar la respuesta de tu servicio de vinculación de cuentas debido a formatos o valores no válidos en la carga útil.
Usa requestId en GCP Logging para verificar los registros de errores en tu servicio de vinculación de cuentas.
|
GAL_INTERNAL |
Se produjo un error interno de Google cuando Google intentó recuperar un token de acceso.
Si ves un aumento en la tasa de este error en GCP Logging, comunícate con nosotros para obtener más información. |
GAL_INVALID_ARGUMENT |
Se produjo un error interno de Google cuando Google intentó recuperar un token de acceso.
Si ves un aumento en la tasa de este error en GCP Logging, comunícate con nosotros para obtener más información. |
GAL_NOT_FOUND |
Los tokens de acceso y de actualización del usuario almacenados en Google se invalidan y ya no se pueden actualizar. El usuario debe volver a vincular su cuenta para seguir usando tu servicio.
Si ves un aumento en la tasa de este error en GCP Logging, comunícate con nosotros para obtener más información. |
GAL_PERMISSION_DENIED |
Se produjo un error interno de Google cuando el uso compartido de tokens no está
autorizado.
Si ves un aumento en la tasa de este error en GCP Logging, comunícate con nosotros para obtener más información. |
GAL_REFRESH_IN_PROGRESS |
El token de acceso del usuario venció y ya se está realizando otro intento simultáneo de actualización.
Esto no es un problema y no se requiere ninguna acción. |
INVALID_AUTH_TOKEN |
Google recibió un código de error HTTP 401 de tu servicio.
El token de acceso no venció, pero tu servicio lo invalidó. Usa requestId en GCP Logging para verificar los registros del servicio de tu casa inteligente.
|
INVALID_JSON |
La respuesta JSON no se puede analizar ni comprender.
Revisa la estructura de tu respuesta JSON en busca de sintaxis no válida, como corchetes, comas faltantes o caracteres no válidos. |
OPEN_AUTH_FAILURE |
El token de acceso del usuario venció y Google no puede actualizarlo, o bien Google recibió un código de error HTTP 401 de tu servicio.
Si observas un aumento en la frecuencia de este código, comprueba si también hay un aumento en la frecuencia de errores relacionados con intents de casa inteligente o solicitudes de tokens de actualización. |
PARTNER_RESPONSE_INVALID_ERROR_CODE |
La respuesta indica un código de error no reconocido.
Si la respuesta a tu solicitud indica un error, asegúrate de usar una de nuestros códigos de error admitidos. |
PARTNER_RESPONSE_INVALID_PAYLOAD |
El campo payload de respuesta no se puede analizar como un objeto JSON.
Comprueba si el campo de carga útil en tu respuesta a la solicitud tiene corchetes coincidentes y si está estructurado de forma correcta como un campo JSON. |
PARTNER_RESPONSE_INVALID_STATUS |
La respuesta no indica un estado o indica uno incorrecto.
Las respuestas a las solicitudes de entrega de intents deben indicar un estado con SUCCESS, OFFLINE, ERROR, EXCEPTIONS. Puedes encontrar más información para
manejar errores y excepciones.
|
PARTNER_RESPONSE_MISSING_COMMANDS_AND_DEVICES |
Faltan uno o más intents en la solicitud en la respuesta.
Verifica que tu respuesta de ejecución esté estructurada correctamente y que los resultados de todos los intents de la solicitud estén presentes en tu respuesta. |
PARTNER_RESPONSE_MISSING_DEVICE |
Falta uno o más dispositivos presentes en la solicitud en la respuesta.
Verifica que tu respuesta de ejecución esté estructurada correctamente y que todos los IDs de dispositivo de la solicitud estén presentes en tu respuesta. |
PARTNER_RESPONSE_MISSING_PAYLOAD |
La respuesta no contiene un campo payload.
Asegúrate de incluir un campo de carga útil en la respuesta de tu solicitud. Puedes obtener más información para compilar correctamente una respuesta de ejecución. |
PARTNER_RESPONSE_NOT_OBJECT |
La respuesta no se puede analizar como un objeto JSON.
Revisa todos los campos de la respuesta a la solicitud para detectar caracteres no deseados, corchetes o errores de formato. Es posible que algunos caracteres Unicode no sean compatibles. Además, asegúrate de que tu respuesta esté estructurada de forma correcta como un objeto JSON. |
PROTOCOL_ERROR |
Se produjo un error al procesar la solicitud.
Usa requestId en Google Cloud Logging para verificar los registros del servicio de casa inteligente.
|
RESPONSE_TIMEOUT |
Se agotó el tiempo de espera de la solicitud mientras se esperaba la respuesta.
El período de tiempo de espera para enviar una respuesta es de 9 segundos desde el momento en que se envía la solicitud. Asegúrate de enviar una respuesta dentro de este período. |
RESPONSE_UNAVAILABLE |
No se recibe ninguna respuesta o la respuesta no indica un estado.
Las respuestas a las solicitudes de entrega de intents se deben estructurar de acuerdo con los documentos de casa inteligente y se debe indicar el estado. |
TRANSIENT_ERROR |
Un error transitorio es un error que se resolverá solo.
Por lo general, estos errores se manifiestan como una conexión con un dispositivo o servicio que se descarta. También ocurre si no se pueden abrir conexiones nuevas a un servidor. |
Registros de búsqueda
Una vez que te familiarices con la supervisión de tus integraciones mediante métricas, el siguiente paso es solucionar errores específicos mediante Cloud Logging. Un registro de errores es una entrada similar a JSON con campos que contienen información útil, como la hora, el código de error y los detalles sobre el intent de la casa inteligente de origen.
Hay varios sistemas dentro de Google Cloud que envían registros a tu proyecto en todo momento. Debes escribir consultas para filtrar tus registros y encontrar los que necesitas. Las consultas se pueden basar en un intervalo de tiempo, recurso, gravedad de registro o entradas personalizadas.
Puedes usar los botones de consulta como ayuda para crear tus filtros personalizados.
Para especificar un Intervalo de tiempo, haz clic en el botón de selección de intervalo de tiempo y elige una de las opciones proporcionadas. Esto filtrará los registros y mostrará los que se originen en el intervalo de tiempo seleccionado.
Para especificar un Resource, haz clic en el menú desplegable Resource y, luego, elige Google Assistant Action Project. Esto agrega un filtro a tu consulta para mostrar los registros que se originan en tu proyecto.
Usa el botón Gravedad para filtrar por Emergencia, Información, Depuración y otros niveles de registro de gravedad.
También puedes usar el campo Consulta en el Logs Explorer para ingresar entradas personalizadas. El motor de consultas que usa este campo admite consultas básicas, como la coincidencia de cadenas, y tipos de consultas más avanzados, incluidos los comparadores (<, >=, !=) y los operadores booleanos (AND, OR, NOT).
Por ejemplo, la entrada personalizada que aparece a continuación mostraría errores que se originan en un tipo de dispositivo LIGHT:
resource.type = "assistant_action_project" AND severity = ERROR AND jsonPayload.executionLog.executionResults.actionResults.device.deviceType = "LIGHT"
Visita la Biblioteca de consultas para encontrar más ejemplos de cómo consultar registros de manera eficaz.
Prueba de correcciones
Una vez que identifiques los errores y apliques actualizaciones para corregirlos, te recomendamos que pruebes las correcciones minuciosamente con Google Home Test Suite. Proporcionamos una guía del usuario sobre cómo usar Test Suite, en la que se explica cómo probar los cambios de manera efectiva.
Recursos de aprendizaje
En este documento, se proporcionan los pasos para solucionar errores en tu acción de casa inteligente. También puedes consultar nuestros codelabs para obtener más información sobre la depuración:
- Codelab de depuración de una casa inteligente: Guía de inicio rápido para depurar la integración en la nube de una casa inteligente.
- Codelab de depuración de Local Home: Guía de inicio rápido para depurar la integración local de casa inteligente.