🖥️ Estado de servicios
Objetivo Principal: Ver de un vistazo si los servicios de los que depende la plataforma están respondiendo, y saber cuál falla y a qué afecta antes de dar por perdido un dato o un panel.
Esta página describe una pantalla que aún no está fotografiada en el manual, así que el despiece no numera los elementos sobre una imagen. Lo que se cuenta aquí está contrastado con la versión 0.4.46 de la aplicación.
La pantalla la puede abrir cualquier usuario que haya iniciado sesión: no está reservada a ningún rol. Se llega a ella desde el indicador de estado de la barra superior, pulsando "Ver detalle" en el panel que despliega.
🧩 Despiece de Elementos Funcionales
Panel desplegable del indicador de la barra superior
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Punto de estado | Botón de estado | Abre y cierra el panel de servicios | Punto de color permanente en la barra superior. Se pone verde cuando todo responde, naranja cuando hay degradación, rojo cuando un servicio crítico está caído y gris cuando no hay datos. Mientras se hace la primera comprobación muestra dentro un pequeño aro girando. |
| Resumen del panel | Información | — | Primera línea del panel desplegado. Muestra el estado general con las palabras "Servicios OK", "Degradado", "Incidente", "Sin datos" o "Verificando..." y, a su derecha, cuántos servicios responden correctamente sobre el total. |
| Lista de servicios | Listado | — | Un renglón por servicio, agrupado en bloques separados por una línea fina: primero los críticos, después los complementarios y por último los que dependen del entorno. Cada renglón lleva su punto de color, el nombre del servicio y, si lo tiene, su tiempo de respuesta en milisegundos. Los servicios con problema se destacan sobre el resto. |
| "No se pudo verificar" | Mensaje | — | Sustituye a la lista cuando la comprobación no ha llegado a hacerse. |
| Hora de la última comprobación | Información | — | Hora y minuto en que se verificaron los servicios por última vez. |
| "Actualizar" | Botón | Fuerza una comprobación inmediata | Repite la verificación sin esperar al siguiente ciclo automático. Mientras está en marcha el botón se queda deshabilitado y muestra tres puntos. |
| "Ver detalle" | Enlace | Abre la pantalla "Estado de servicios" | Cierra el panel y abre la pantalla completa descrita abajo. |
Pantalla "Estado de servicios"
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Título y etiquetas | Información | — | El título "Estado de servicios" acompañado de una etiqueta azul con el entorno en el que se está trabajando y, en gris, el número de versión de la plataforma. Sirven para acompañar cualquier incidencia que haya que reportar. |
| Hora de la última comprobación | Información | — | Hora, minuto y segundo de la última verificación. Si aún no hay ninguna se muestra un guion. |
| Botón de actualizar | Botón | Fuerza una comprobación inmediata | Icono de flechas circulares a la derecha de la cabecera, con la ayuda emergente "Actualizar". Mientras la comprobación está en curso queda deshabilitado y muestra un indicador de carga. |
| "Auto" | Desplegable | Fija cada cuánto se repite la comprobación | Selector con tres opciones: "Off" (solo se comprueba al entrar o al pulsar el botón de actualizar), "30s" y "60s". Al abrir la pantalla está en "30s". |
| Franja de estado general | Mensaje | — | Banda bajo la cabecera con el veredicto global: "Todos los servicios operativos"; "Algunos servicios degradados", acompañado de "Revisar detalle"; o "Servicios criticos afectados", acompañado de "Requiere atencion". |
| Mapa de servicios | Diagrama | Pulsar un servicio abre su detalle | Cuadrícula con los servicios repartidos en tres filas rotuladas a la izquierda: "Criticos", "Complementarios" y "Auxiliares". Cada servicio es una tarjeta con su punto de color, su nombre y su tiempo de respuesta. Los servicios degradados o caídos laten suavemente para llamar la atención. Mientras cargan los datos, las tarjetas se muestran vacías y en movimiento. |
| Líneas de dependencia | Diagrama | — | Curvas que unen un servicio con los que dependen de él: Firebase con Firebase Storage y con Automatizaciones, y Dashboard Adapter con SSE. La línea toma el color del servicio dependiente y se dibuja a trazos cuando ese servicio no está configurado. Explican por qué al caer un servicio se degradan otros. |
| Tarjeta de servicio | Botón | Abre o cierra el panel de detalle | Se abre pulsando la tarjeta con el ratón o, si se ha llegado a ella con el tabulador, con la tecla Intro o la barra espaciadora. Volver a pulsar la misma tarjeta cierra el detalle. |
| Leyenda | Información | — | Los cuatro estados posibles con su color: "Verificado" (verde), "Degradado" (naranja), "Caido" (rojo) y "Sin configurar" (gris). |
| Panel de detalle | Panel | — | Se despliega bajo el mapa al pulsar un servicio. Lleva arriba el nombre del servicio y una etiqueta con su estado, y debajo los datos disponibles: "Endpoint" (la dirección que se comprueba), "Timeout" (segundos que se espera antes de darla por fallida), "Latencia" (lo que ha tardado en responder), "Respuesta" (resumen de lo que ha contestado), "Impacto" (qué deja de funcionar si ese servicio falla) y "Error" (el último mensaje de fallo, solo si el servicio no está verificado). Mientras se cargan muestra "Cargando detalle..."; si no hay nada que enseñar, "Sin datos de detalle.". |
| "Historial reciente" | Tabla | — | Últimas comprobaciones del servicio seleccionado, con las columnas "Estado", "Latencia", "Hora" y "Mensaje". Solo aparece si hay comprobaciones anteriores guardadas. |
| Aviso de fallo de carga | Mensaje | Reintenta la carga | Si la pantalla no consigue sus datos, muestra "No se pudo cargar el estado de servicios." junto al botón "Reintentar". |
💡 Guía de Uso
Cuándo usarla. Esta pantalla se abre cuando algo no cuadra: un dashboard que no pinta datos, un informe que no se descarga, una notificación que no llega. Antes de abrir una incidencia conviene mirar aquí, porque distingue un problema de la instalación de un problema de un servicio concreto.
Qué se está vigilando. Los servicios se agrupan en tres filas según lo que se pierde si fallan:
- Criticos. "API Backend", cuyo impacto declarado es la indisponibilidad total; "Firebase / Firestore", del que dependen el acceso, los datos y la configuración; y "Dashboard Adapter", del que dependen los dashboards y los datos en tiempo real. Si uno de estos tres cae, la plataforma no puede trabajar con normalidad.
- Complementarios. "Firebase Storage" (subida de informes y adjuntos), "Automatizaciones" (ejecución de los flujos), "SSE (streaming)" y "Realtime Hub" (los datos que se refrescan solos en pantalla) y "Email (SendGrid)" (envío de avisos por correo). Si falla uno, la plataforma sigue funcionando pero pierde esa función.
- Auxiliares. "WhatsApp (Twilio)" (avisos por WhatsApp o SMS), "App Check" y "API Tiempo" (el widget meteorológico). Dependen de lo que tenga contratado y configurado cada instalación.
Cómo leer los colores. Verde, "Verificado", es que el servicio ha respondido dentro de plazo. Naranja, "Degradado", es que responde con problemas o que depende de otro servicio que los tiene. Rojo, "Caido", es que no responde. Gris, "Sin configurar", es que ese servicio no está dado de alta en esta instalación: no es una avería y no cuenta como fallo. La franja superior resume todo eso con una regla sencilla: solo se declara "Servicios criticos afectados" cuando el que ha caído es uno de los tres críticos; si el que se cae es un complementario o un auxiliar, el conjunto se marca como degradado, no como incidente. Conviene saber que un servicio complementario meramente degradado puede no alterar el resumen general, así que ante un problema concreto mira el mapa y no solo la franja.
Cómo trabajar la pantalla. Empieza por la franja superior. Si dice que todo está operativo y aun así algo no te funciona, el problema probablemente no es de servicio. Si señala degradación o incidente, busca en el mapa la tarjeta que no esté en verde y púlsala: el panel de detalle te dirá en "Impacto" qué se pierde exactamente y en "Error" el último mensaje del fallo. Sigue después las líneas que salen de esa tarjeta: si el que ha caído es Firebase o Dashboard Adapter, lo normal es que los servicios que cuelgan de ellos aparezcan también en naranja, y arreglando el primero se recuperan los demás.
Comprobar que se ha recuperado. Pulsa el botón de actualizar y mira la hora de la última comprobación: debe cambiar. Si prefieres no estar pendiente, deja el selector "Auto" en "30s" y la pantalla se irá verificando sola; ponlo en "Off" si prefieres que nada se mueva mientras analizas el "Historial reciente" de un servicio. Ese historial es la mejor prueba de si el fallo es puntual o sostenido: varios renglones seguidos en rojo o con latencias muy altas indican un problema de fondo.
Si la pantalla no carga. Cuando aparece "No se pudo cargar el estado de servicios." con el botón "Reintentar", ni siquiera la comprobación ha podido hacerse. Prueba una vez con "Reintentar" y, si se repite, avisa al responsable de la instalación indicando el entorno y la versión que figuran junto al título: son los dos datos que primero se preguntan.