Solución de problemas de integración de Matter

fecha_de_actualización: 6-1-2023

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. Cuando se produce una falla cuando se entregan los intents La canalización de Analytics de Google Home registra ese error en tus métricas. publica un registro de errores en los registros de tu proyecto.

Para solucionar los errores, debes seguir dos pasos:

  1. Supervisa el estado de tus proyectos con las métricas de la casa inteligente.
  2. 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 caídas en este gráfico pueden indicar una interrupción para una parte o toda su base de usuarios. Recomendaciones supervisando de cerca este gráfico en busca de irregularidades después de cada cambio. o actualizar tu proyecto.
  • 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 destino que el dispositivo 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.

Esto normalmente indica una falla en la sincronización de datos o una carrera. estado.
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 necesita volver a vincular su cuenta para seguir usando tu servicio.

Si observas una tasa más alta de este error en registros de GCP, comunícate con 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 tu respuesta a la solicitud indica un error, asegúrate de utilizar una proporcionado por nuestro los 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. También asegúrate de que tu respuesta sea correcta estructurados como un objeto JSON.
PROTOCOL_ERROR Se produjo un error al 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 hora, error y 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.

Consulta registros de Cloud

Puedes usar los botones de consulta como ayuda para crear tus filtros personalizados.

Crear consultas de registros de Cloud

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 consultas que usa este campo admite consultas básicas, como la coincidencia de cadenas, y tipos de consultas más avanzadas, como comparadores (<, >=, !=) y 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.

Prueba de correcciones

Una vez que identifiques los errores y apliques actualizaciones para corregirlos, te recomendamos que realices pruebas soluciones a fondo con Google Home Test Suite Ofrecemos una guía del usuario sobre cómo usar Test Suite, que te guiará para probar tu los cambios de forma 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: