Diagnóstico de API

Una comprobación de servicio del intercambio de datos entre AI Analytics y la plataforma de dispositivos de medición. El informe consulta, una por una, todas las solicitudes de la plataforma que utilizan los demás informes, y muestra cuáles de ellas responden con normalidad y cuáles devuelven un error. El público objetivo es el administrador y el soporte técnico: ejecútelo cuando sospeche un fallo de integración y verá de inmediato dónde se ha roto el enlace con el dispositivo o el servidor.

Qué muestra

Para cada tipo de solicitud de la plataforma, una fila con el resultado: qué endpoint se invocó, si el servidor respondió correctamente, cuántas filas de datos devolvió y qué campos había en la primera fila (para confirmar que el formato de los datos no ha cambiado).

El color de la fila lo determina el código de respuesta del servidor:

Cómo se calcula

El informe consulta, una por una, todas las solicitudes de la plataforma que utilizan los demás informes: inicio de sesión, lista de la flota, directorios (tipos de dispositivos, empresas de servicios públicos, clientes), sesiones de enlace (en cuatro variantes de parámetros), archivos de lecturas (horarios, diarios, mensuales, ajustes), archivos de situaciones anómalas y registros de eventos, así como el pasaporte del dispositivo. Para cada llamada se registran el endpoint, la respuesta del servidor, el número de filas y una muestra de campos. Si se especifica un nodo concreto, además se comprueban los archivos de situaciones anómalas de ese nodo.

Parámetros de ejecución

Cómo interpretarlo

Observe los colores de las filas. Todo en verde significa que el intercambio de datos está sano. Las filas amarillas indican que el servidor está disponible pero no devuelve datos sin los derechos necesarios: un motivo para comprobar el acceso. Las filas rojas son un fallo en el lado del servidor y se atienden primero. Las filas grises («no encontrado») suelen ser normales: no todos los dispositivos admiten todos los tipos de archivo, por lo que la ausencia de archivos de anomalías en un dispositivo concreto no es un error.

Tenga en cuenta una particularidad del inicio de sesión: la plataforma reutiliza un pase obtenido previamente durante unas dos semanas, por lo que la comprobación de inicio de sesión suele tener éxito incluso sin un nuevo inicio de sesión real en el servidor.

Informes relacionados

Este informe es autónomo y no depende de nada. Todos los demás informes de flota usan las mismas solicitudes de la plataforma que él comprueba, así que cuando fallan, este es el punto donde empezar el diagnóstico.