Métricas del panel de supervisión de la calidad

Este conjunto de paneles y alertas te ayuda a mantener de forma proactiva una integración de alta calidad con el ecosistema de Google Home. Google se compromete a ayudar a los socios a desarrollar un ecosistema de alta calidad para todos los clientes

El panel tiene tres secciones, cada una de las cuales abarca una parte clave que contribuye a la calidad de una integración general.

1. Métricas de Google para socios: Miden el estado de las llamadas de Google a tu backend de la nube.

2. Estado del sistema: Métricas de socio a Google: Mide el estado de las llamadas desde tu sistema a Google.

3. Estado del dispositivo: Precisión del estado: Mide la precisión de los estados almacenados en los sistemas de Google, que se usan para responder las búsquedas de los usuarios.

Cuando las métricas no alcanzan sus valores objetivo, se destacan en rojo para indicar un problema que podría afectar la experiencia del usuario. La siguiente información proporciona detalles sobre cada objetivo y por qué es importante para tus usuarios.

Ir al panel

Métricas de Google al socio

La métrica Tasa de éxito de la consulta/ejecución >= 99.5% mide la frecuencia con la que se cumplen correctamente los comandos de los usuarios, lo que ayuda a evitar respuestas de Asistente como "No puedo acceder al dispositivo" o confirmar incorrectamente un comando que no se cumplió.

¿Qué define un "éxito"?

Una transacción se marca como exitosa si la plataforma de Google Home recibe una respuesta válida que indica que se completó la acción prevista o que se recuperó el estado solicitado.

Las respuestas que incluyen excepciones no bloqueantes (por ejemplo, un estado SUCCESS acompañado de una excepción lowBattery) se consideran transacciones exitosas. El comando llegó al dispositivo y se satisfizo la intención a pesar de la advertencia.

¿Qué define un "error"?

Los errores que se encuentran en Códigos de error comunes de la plataforma y que se marcan como Acción del socio se consideran "Fallos" cuando se calculan las tasas de éxito de QUERY y EXECUTE.

La métrica Latencia de consulta/ejecución (percentil 90) <= 1,000 ms mide el tiempo de espera de la acción solicitada y ayuda a garantizar que los usuarios no tengan que esperar demasiado, por ejemplo, unos segundos para que se apague la luz.

Métricas de latencia

La latencia es un indicador fundamental de la capacidad de respuesta de tu integración para el usuario final. El panel supervisa la latencia del percentil 90 (P90), que representa la experiencia de los usuarios más "lentos" (por ejemplo, un P90 de 800 ms significa que el 90% de las solicitudes se confirman en 800 ms o menos).

Google mide la latencia de manera diferente para las verificaciones de estado y los comandos del dispositivo para garantizar la precisión técnica.

1. Latencia de la BÚSQUEDA (interrogativa)

Esto mide el tiempo de ida y vuelta de Cloud-to-cloud cuando Google solicita el estado actual de un dispositivo.

• Inicio: Google envía una solicitud action.devices.QUERY a la URL de cumplimiento.
• Período de medición: Es el tiempo que tarda tu nube en recibir, procesar y transmitir la respuesta HTTP completa a Google.
• Fin: Google recibe y confirma la recepción de la carga útil de la respuesta final de tu servicio.

2. Latencia de EXECUTE (acción)

Mide el tiempo de confirmación del comando cuando Google envía una solicitud de control a un dispositivo.

• Inicio: Google envía una solicitud action.devices.EXECUTE a la URL de cumplimiento.
• Ventana de medición: Es el tiempo que tarda tu nube en recibir el comando y devolver una respuesta de confirmación.
• Finalización: Google recibe la respuesta de estado SUCCESS, PENDING o OFFLINE.
• Alcance técnico: Esta métrica mide el tiempo de "confirmación de respuesta" entre la nube de Google y tu nube. No mide el tiempo que tarda el hardware físico (por ejemplo, una bombilla) en completar el cambio de estado físico, ya que a menudo implica una latencia de red de malla local fuera de la ruta de nube a nube.

Estado del sistema: Métricas de socio a Google

Mantener un porcentaje de éxito >= 99.5% ayuda a garantizar que los estados de los dispositivos sean correctos en Google Home, que los dispositivos se agreguen y quiten, que se activen las automatizaciones y que los eventos del historial aparezcan en la pestaña Actividad del Google Home app (GHA).

La tasa de éxito se calcula en función de los códigos de respuesta HTTP que muestra Google cuando tu nube envía actualizaciones de estado. Para garantizar que los socios no reciban penalizaciones por problemas de infraestructura del lado de Google, la métrica excluye los errores internos de Google del recuento de fallas.

¿Qué define un "éxito"?

• 2xx (Correcto): Home Graph recibió y procesó correctamente la actualización de estado.

¿Qué define un "error"?

• 4xx (Error del socio): Representan fallas y señalan un problema con la solicitud enviada desde tu nube. Entre los códigos más comunes, se incluyen los siguientes:
  • 400 Bad Request: El servidor no pudo procesar la solicitud debido a una sintaxis no válida. Entre las causas comunes, se incluyen el uso de JSON con formato incorrecto o el uso de null en lugar de "" para un valor de cadena.
  • 404 Not Found: No se encontró el recurso solicitado. Por lo general, esto significa que Google no puede encontrar el dispositivo solicitado. También puede significar que la cuenta de usuario no está vinculada o que se recibió un agentUserId no válido. Asegúrate de que agentUserId coincida con el valor proporcionado en tu respuesta de SYNC y de que controlas correctamente las intenciones de DISCONNECT.
  • 429 Se agotó el recurso: Tu integración excedió la cuota asignada. Consulta las instrucciones en la sección "Paso 1" más arriba en el panel para administrar la cuota.

Estado del dispositivo: Precisión del estado

Cumplir o superar un porcentaje de precisión del estado >= 99.5% ayuda a garantizar que los usuarios vean resultados correctos cuando consulten los estados de los dispositivos o usen funciones basadas en IA, como Pregúntale a Casa. Si la precisión del estado es baja, es posible que las automatizaciones no se activen y que las entradas del historial no aparezcan en la pestaña Actividad de GHA en el momento adecuado. Para obtener más información, consulta Report State.

El panel de calidad realiza un seguimiento de esto cada hora con dos métricas distintas: Precisión general y la Combinación de tipo o rasgo más baja.

1. Componentes de precisión

La métrica se deriva de "muestras" en las que Google puede verificar el estado informado en comparación con un resultado de intención conocido.

2. Métricas del panel (cálculo por hora)

El panel calcula la precisión en función de un intervalo de 1 hora. Si una hora tiene menos de 100 muestras totales (S_Total < 100), la exactitud para esa hora se establece en N/A.

Vista 1: Precisión general (promedio global)

Esto representa la precisión total de tu integración en todos los tipos de dispositivos y rasgos combinados. Proporciona un promedio ponderado del estado general de tu ecosistema.

• Cálculo: Precisión total del estado en todos los dispositivos / Total del estado total en todos los dispositivos.

Vista 2: Combinación de tipo y rasgo más baja

Identifica la categoría específica menos confiable de tu integración. Evita que los dispositivos de alto volumen y alta calidad oculten los dispositivos de bajo volumen y baja calidad. Por ejemplo, si tienes una gran cantidad de luces con una precisión del estado superior al 99.5%, pero una cantidad baja de interruptores con una precisión del estado baja, esto destaca la mejora necesaria en los interruptores que se pueden perder en un valor promedio.

• Cálculo: Es el mínimo de la precisión del estado o el total del estado para todas las combinaciones de rasgos y dispositivos.