La pantalla que muestra, en vivo, qué cuentas GPS se están capturando, cuántas unidades trae cada una y si algo falló. Se actualiza sola y es solo lectura: desde aquí no se puede romper nada. Agrupa por cliente · transportista (una tarjeta por grupo) y tiene dos zonas: Estado de rastreo — los grupos que sí ejecutan — y Diagnóstico técnico — fallas, tiempos y transiciones.
| Elemento | Qué significa |
|---|---|
| EN VIVO · última respuesta… | El tablero está recibiendo datos. PAUSADO = congelaste la pantalla (botón Ⅱ); ERROR DE ACTUALIZACIÓN = el tablero se quedó sin datos del runtime. |
| ↻ actualizar ahora · Ⅱ congelar | Refrescar al momento, o congelar la vista para leer con calma sin que cambie. |
| X / Y dentro de su cadencia | De Y grupos, X ejecutaron dentro del ritmo que les toca. Es el número de salud del dash. |
| N grupos · N cuentas | El tamaño del padrón: cuántos transportistas y cuentas atiende este dash. |
No todos los dash capturan al mismo ritmo (los hay de 2, 5 o 10 minutos). Los colores se ajustan al ritmo real: verde = ejecutó dentro de ~1.3× su intervalo (sana, aunque la edad diga varios minutos) · ámbar = se está atrasando · rojo = pasó ~2.2× su intervalo: la ejecución está genuinamente detenida. Por eso una edad de 8 minutos puede ser normal en un dash lento y alarma en uno rápido — confía en el color, no en el número solo.
| Casilla | Qué mide | Umbral |
|---|---|---|
| runs / 5min | Ejecuciones de captura recientes. | En 0, la captura está detenida. |
| error rate | Porcentaje de fallos en 5 min. | ≥ 10% vigilar · ≥ 25% avisar |
| atrasados (>Xs) | Grupos fuera de su cadencia. | > 10% del total = problema general del dash |
| edad mediana · p95 | Qué tan viejo es el dato típico y el peor razonable. | Si la mediana sube sin parar, el dash se rezaga. |
Ejemplo con datos ficticios: el cliente, el transportista y las placas son ilustrativos.
Cliente · transportista del grupo — la identidad de la tarjeta.
Etiquetas: la plataforma GPS de origen, el modo de captura (⚡ api = consulta directa, 🌐 browser = navegador), cuántas cuentas junta el grupo, y la frescura de la última ejecución. El color se calibra a la cadencia del dash (pág. 1); el cursor encima muestra dos relojes: EJECUCIÓN (cuándo corrió el scraper) y POSICIÓN NUEVA (cuándo llegó el último dato GPS distinto).
Host del portal e ID de la cuenta. Un clic en el ID lo copia: es el dato clave al reportar un problema.
Historial de ejecuciones, la más reciente a la izquierda. Cada punto es una ronda; el color marca el hueco contra la anterior. Racha roja = el grupo estuvo callado.
Unidades que trajo la última ronda y el destino del envío.
Último envío (200 = aceptado por el receptor) y última ejecución con su duración. Si en su lugar dice «sin datos nuevos» o «sin ejecución desde hace Xm», el grupo no corre o no produce.
Detalle por cuenta: ID · edad · puntos del ciclo (3p) · duración · corridas/errores (43/0 = 43 corridas, 0 errores). Abajo, cada unidad con su posición; clic en las coordenadas las copia y ofrece abrirlas en Maps.
JSON crudo: el paquete exacto que se envía. Útil para soporte; no hace falta para operar.
| Aviso | Qué significa |
|---|---|
| ⚠ datos de corrida anterior | La última ejecución falló; ves la foto de la última corrida buena. Posiciones sin refrescar. |
| más de 1h sin reportar | La fecha GPS de esa unidad es vieja. Casi siempre es el equipo (apagado, sin señal, estacionado). |
| — sin unidades — | El portal de origen no devolvió vehículos para esa cuenta en el último ciclo. |
| sin snapshot GPS aún | Cuenta recién arrancada; espera al próximo ciclo. |
Así se ve la zona principal. El filtro separa los estados; el orden Más fallas es la vista de guardia; a la derecha, el total de grupos y cuántos capturan por ⚡api o 🌐browser.
Cuando hay cuentas que no lograron iniciar sesión, arriba de las tarjetas aparece la banda roja «cuentas sin rastreo» — la lista a revisar primero cada mañana. Ejemplo con datos ficticios:
El contador. Cuántas cuentas están sin poder entrar a su portal ahora mismo. Solo aparece cuando hay al menos una; si no la ves, no hay logins fallando.
Grupo y cuenta afectada: cliente // transportista y, debajo, el ID de la cuenta. Un clic lo copia — es el dato para reportar.
Plataforma y último intento: qué integración es y cuándo fue la última vez que intentó entrar.
El motivo, traducido. La página 4 dice qué significa cada frase y a quién le toca resolverla.
En el detalle de cada falla (zona de Diagnóstico técnico) la distinción que importa es: reintentando (N) = el runtime la sigue trabajando solo, dale tiempo; ⚠ atorada (N intentos) — necesita intervención = ya no se cura sola: hace falta credencial nueva, alta en el portal del proveedor, o reporte al equipo de runtime. Regla de cada mañana: atiende primero las atoradas y las de credenciales; lo de navegador/infra o rate-limit se reintenta solo — revísalo en una hora antes de reportar. Las fallas vienen clasificadas por causa: credenciales sin unidades suspendida rate-limit navegador/infra cambió estructura.
El dashboard traduce los errores técnicos a frases. Esta tabla dice de quién es el problema.
| Mensaje en pantalla | Qué está pasando | De quién es |
|---|---|---|
| credenciales rechazadas / expiradas — usuario o contraseña inválido | El portal rechaza el acceso. Hay que actualizar usuario/contraseña con el cliente. | CREDENCIAL |
| cuenta suspendida por el proveedor — login OK, reactivar con el administrador | La credencial entra pero el proveedor suspendió la cuenta. | CLIENTE |
| sin unidades asignadas — revisar permisos en el panel | Entra, pero no ve vehículos: falta asignarle flota en el portal. | CLIENTE |
| sitio del proveedor caído · servidor inaccesible · DNS o IP inválido · certificado SSL vencido | El portal del proveedor no responde o su dirección/certificado cambió. | PROVEEDOR |
| tiempo de espera agotado — servidor lento o caído | El portal tarda demasiado. Suele ser transitorio. | PROVEEDOR |
| demasiadas consultas — rate-limit activo | El proveedor está limitando las consultas; el runtime espacia solo. | ESPERAR |
| en pausa entre reintentos (backoff) — esperando la ventana de re-login | Falló un login y el runtime espera su turno para reintentar. Es protección, no caída. | ESPERAR |
| navegador no disponible (infra) · proxy/red del navegador inestable — no es la cuenta | Problema de infraestructura de captura por navegador; se reintenta solo. | RUNTIME |
| la página de login no presentó el formulario · el login no llegó al panel | El sitio cambió o hay bloqueo anti-bot. | RUNTIME |
| respuesta inesperada — formato cambió · endpoint no encontrado · respuesta vacía | El portal cambió su página o API; requiere ajuste de código. | RUNTIME |
| error interno del scraper | Fallo nuestro en la captura. | RUNTIME |
Con esos tres datos, el diagnóstico empieza en minutos en lugar de horas.
Casi nunca. Hay dos relojes: la frescura de captura (el chip «hace Xs», calibrado a la cadencia del dash — eso es nuestro y debe estar verde) y el gps_date, que es la hora en que el equipo del camión reportó. Muchos equipos reportan una vez por hora o callan al apagar el motor. Captura verde + gps_date que avanza cuando la unidad se mueve = todo bien.
Unidad detenida: estacionada o en patio. El dato sigue llegando; solo que no cambia. Si además el evento dice parking, es exactamente eso.
Este dashboard prueba que capturamos y enviamos. Que el sistema del cliente lo muestre depende de su lado: en AIS, una posición solo se acepta si la unidad tiene viaje/bitácora abierta — sin viaje, el descarte es el comportamiento normal, no una falla. La revisión sigue en el alta del viaje o del catálogo del cliente.
El dashboard muestra lo que el portal del proveedor entrega a esa credencial. Si faltan unidades, primero se confirma cuántas devuelve el portal en crudo; si da menos que la flota real, el ajuste es de permisos o asignación en el portal del proveedor.