Google Cloud Te brinda las herramientas para supervisar la confiabilidad de tus proyectos con Google Cloud Monitoring y depurar problemas con Google Cloud Logging los registros de errores. Cada vez que se produce una falla cuando se cumplen las intenciones del usuario, la canalización de Google Home Analytics registra 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.
- Investiga los problemas revisando las descripciones detalladas de los errores en el 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 comienzas cuando supervisar la confiabilidad de tus proyectos. Las disminuciones en este gráfico pueden indicar una interrupción para una parte o toda tu base de usuarios. Te recomendamos que supervises de cerca este gráfico para detectar irregularidades después de cada cambio o actualización de tu proyecto.
- El gráfico de Latencia del percentil 95 es un indicador importante de cómo que la Acción de tu casa inteligente esté funcionando para los usuarios. Fluctuaciones repentinas de este gráfico pueden indicar que es posible que tus sistemas no puedan ponerse al día con las solicitudes. Se recomienda revisar este gráfico periódicamente para detectar cualquier comportamiento inesperado.
- Los gráficos de Desglose de errores son más útiles cuando se trata de y solucionar problemas relacionados con tus integraciones. Para cada error se destaca en tu gráfico de porcentaje de éxito, se muestra un código de error en el desglose de errores. Puedes ver los errores marcados por el 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 problemas detectados por Google Home platform Consulta el 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 a 401 de su
servicio.
Usa requestId en los registros de GCP para verificar
registros de servicios para el hogar.
|
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 y acepte conexiones y no supera 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 los registros de GCP para verificar
registros de servicios para el hogar.
|
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 un formato o valores no válidos en la carga útil.
Usa requestId en los registros de GCP 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 observas una tasa más alta de este error en registros de GCP, comunícate con 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 observas una tasa más alta de este error en registros de GCP, comunícate con para obtener más información. |
GAL_NOT_FOUND |
Los tokens de acceso y de actualización del usuario almacenados en Google están
invalide y ya no se pueda actualizar. El usuario debe volver a vincular su cuenta para seguir usando tu servicio.
Si observas un aumento en la frecuencia de este error en los registros de GCP, 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á habilitado
autorizados.
Si observas una tasa más alta de este error en registros de GCP, comunícate con para obtener más información. |
GAL_REFRESH_IN_PROGRESS |
Caducó el token de acceso del usuario y se intentó realizar otro intento simultáneo de
actualización, ya se está realizando.
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 el registro de GCP para verificar
registros de servicios para el hogar.
|
INVALID_JSON |
La respuesta JSON no se puede analizar ni comprender.
Verifica la estructura de tu respuesta JSON en busca de sintaxis no válida, como 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 Google recibió un código de error HTTP 401 de tu servicio.
Si observas un aumento en la tasa de este código, comprueba si también se muestra aumento de la tasa de errores relacionados con intents o actualizaciones de casas inteligentes las solicitudes de token. |
PARTNER_RESPONSE_INVALID_ERROR_CODE |
La respuesta indica un código de error no reconocido.
Si la respuesta de tu solicitud indica un error, asegúrate de usar uno de los que se proporcionan en nuestros códigos de error admitidos. |
PARTNER_RESPONSE_INVALID_PAYLOAD |
El campo payload de la respuesta no se puede analizar como un archivo JSON
Objeto.
Verifica si el campo de carga útil en tu respuesta a la solicitud tiene coincidencias corchetes y está bien estructurado 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. Tú
puedes encontrar más información en
manejo de errores y excepciones.
|
PARTNER_RESPONSE_MISSING_COMMANDS_AND_DEVICES |
Falta uno o más intents en la solicitud en el
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 |
Uno o más dispositivos incluidos en la solicitud no están en el
respuesta.
Verifica que tu respuesta de ejecución esté estructurada correctamente y que todos los dispositivos Los IDs 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. Tú pueden obtener más información sobre cómo crear correctamente un 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 ver si hay caracteres no deseados. corchetes o errores de formato. Algunos caracteres Unicode podría no ser compatible. Además, asegúrate de que tu respuesta esté correctamente estructura como un objeto JSON. |
PROTOCOL_ERROR |
No se pudo procesar la solicitud.
Usa requestId en Google Cloud Logging para verificar
registros de servicios de casa inteligente.
|
RESPONSE_TIMEOUT |
Se agotó el tiempo de espera de la solicitud mientras se esperaba la respuesta.
El tiempo de espera para enviar una respuesta es de 9 segundos desde que se envía la solicitud. Asegúrate de enviar una respuesta en este período un plazo determinado. |
RESPONSE_UNAVAILABLE |
No se recibe ninguna respuesta o la respuesta no indica un estado.
Se deben estructurar las respuestas a las solicitudes de entrega de intents. de acuerdo con el documentos de casa inteligente e 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. Además, si las nuevas conexiones a un servidor no se pueden abierto. |
Registros de búsqueda
Cuando te sientas cómodo para supervisar tus integraciones con métricas, 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 relacionados con el intent de 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 los registros y encuentra los que necesitas. Las consultas pueden basarse en un Intervalo de tiempo, Recurso, registra Gravedad 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 opciones de estado. Esto filtrará los registros y mostrará los que se originen en el el intervalo de tiempo seleccionado.
Para especificar un Recurso, haz clic en el menú desplegable Recurso. Luego, elige Proyecto de acción de Asistente de Google. Esto agrega un filtro tu consulta para mostrar 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 de consulta en el archivo Logs Explorer
para ingresar entradas personalizadas. El motor de consulta que usa este campo admite consultas básicas, como la coincidencia de cadenas, y tipos de consultas más avanzadas, 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 a partir de 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 consultas de registros de forma eficaz.
Correcciones de pruebas
Una vez que identifiques los errores y apliques actualizaciones para corregirlos, te recomendamos que realices pruebas soluciones a fondo con Google Home Test Suite Proporcionamos una guía del usuario sobre cómo usar Test Suite, que te guía para probar tus cambios de manera eficaz.
Recursos de aprendizaje
En este documento, se proporcionan los pasos para solucionar errores de tu casa inteligente Acción. 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 la casa inteligente.
- Codelab de depuración de Local Home: Guía de inicio rápido para depurar la integración local de casa inteligente.