🖥️ Alarmas – Ficha de una Alarma
Objetivo Principal: Entender qué ha pasado en una alarma concreta y operar sobre ella —reconocerla, resolverla, escalarla, archivarla o convertirla en tarea— con la trazabilidad de todo lo que se ha hecho.
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.
Se llega pulsando la barra de una alarma en el Timeline. También puede abrirla el copiloto cuando propone ir a una alarma concreta. La ficha ocupa toda la pantalla y no muestra la barra de pestañas de Alarmas: para volver, usa el botón de retroceso del navegador.
La pantalla la puede abrir cualquier perfil, pero cada acción tiene su propio permiso y los botones que tu perfil no puede usar no aparecen en la barra. El reparto es el siguiente:
| Acción | Perfiles que pueden ejecutarla |
|---|---|
| "Reconocer" | Mantenimiento, Administrador y Admin Global |
| "Resolver" | Administrador y Admin Global |
| "Escalar" | Administrador y Admin Global |
| "Reabrir" | Administrador y Admin Global |
| "Archivar" | Solo Admin Global |
| "Crear Tarea" | Mantenimiento, Administrador y Admin Global |
La única excepción a lo anterior es "Crear Tarea": el perfil Usuario también ve el botón, pero al pulsarlo la plataforma no crea nada y responde "Error al crear tarea".
🧩 Despiece de Elementos Funcionales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Cabecera de la ficha | Encabezado informativo | — | Muestra el nombre de la regla que generó la alarma, seguido de dos etiquetas: la severidad y el estado. |
| Etiqueta de severidad | Indicador | — | Nivel de gravedad de la alarma: "P1" en rojo, "P2" en naranja y el resto en amarillo. |
| Etiqueta de estado | Indicador | — | Estado de la alarma según la norma ISA-18.2. En esta pantalla aparece con su nombre técnico: "active_unacked" (activa sin reconocer), "active_acked" (activa y reconocida), "cleared_unacked" (la condición ya no se cumple, pero nadie la ha reconocido), "cleared_acked" (despejada y reconocida), "shelved" (archivada) y "resolved" (resuelta). |
| Bloque "Categoria" | Dato informativo | — | Categoría y subcategoría de la alarma, que es como se agrupa en el resto de la sección. |
| Bloque "Prioridad" | Dato informativo | — | Prioridad numérica calculada para la alarma. Cuanto más alta, antes debería atenderse. |
| Bloque "Propietario" | Dato informativo | — | Responsable de la alarma, según lo defina la regla que la generó. |
| Bloque "Creada" | Dato informativo | — | Fecha y hora en que se levantó la alarma, en la zona horaria del navegador. |
| Recuadro de contexto | Panel destacado | — | Recuadro naranja que explica el problema en una frase y, debajo, los datos que lo sustentan: "Variable", "Valor actual", "Umbral", "Nivel", "Flanco" y "Razon". Solo aparecen los datos que la alarma haya traído consigo; si no trae ninguno, el recuadro no se muestra. |
| Botón "Reconocer" | Botón con confirmación | Marca la alarma como reconocida | Aparece mientras la alarma esté sin reconocer. Es la señal de "me hago cargo": no apaga la alarma, deja constancia de que alguien la ha visto. Al pulsarlo, el botón cambia a "Confirmar ACK"; hay que volver a pulsarlo para que la acción se ejecute. |
| Botón "Resolver" | Botón con confirmación | Cierra la alarma | Aparece mientras la alarma no esté resuelta. Al pulsarlo cambia a "Confirmar Resolver". En las alarmas P1 se abre además una ventana pidiendo el motivo. |
| Botón "Escalar" | Botón con confirmación | Escala la alarma | Aparece en las alarmas que no están resueltas ni archivadas y cambia a "Confirmar Escalar" al pulsarlo. En la versión 0.4.46 la acción no llega a completarse: la ficha no cambia de estado ni se añade ninguna línea a la cronología. Para dejar constancia y asignar el seguimiento a alguien, usa "Crear Tarea". |
| Botón "Archivar" | Botón con confirmación | Aparta la alarma de la vigilancia | Reservado al perfil Admin Global. Aparece mientras la alarma no esté archivada ni resuelta, y cambia a "Confirmar Archivar". Deja la alarma en estado "shelved": sigue registrada, pero fuera del flujo de atención. En las alarmas P1 pide el motivo. |
| Botón "Reabrir" | Botón con confirmación | Devuelve la alarma a activa | Solo aparece en las alarmas ya resueltas. Cambia a "Confirmar Reabrir" y devuelve la alarma al estado "active_unacked", como si acabara de levantarse. |
| Botón "Crear Tarea" | Botón | Crea una tarea a partir de la alarma | Genera una tarea de tipo incidencia titulada "[Alarma] " seguido del nombre de la regla, con la severidad, el estado y la categoría de la alarma copiados en su descripción, y la deja vinculada a esta alarma; el vínculo queda luego a la vista en el panel de detalle de la tarea, en su bloque "Alarmas vinculadas". Al terminar aparece el aviso "Tarea creada" con el título generado, o "Error al crear tarea" si no ha podido crearse. |
| Botón "Ver Tarea" | Enlace de acción | Abre la tarea vinculada | Sustituye a "Crear Tarea" cuando la alarma ya tiene una tarea asociada. Lleva a la sección Tareas con esa tarea resaltada. |
| Ventana "Motivo requerido..." | Ventana emergente | Justifica el cierre de una alarma P1 | Se abre al resolver o archivar una alarma P1, con el título "Motivo requerido para resolver alarma P1" o "...para archivar alarma P1". Pide el texto en el campo "Ingrese el motivo..." y no deja continuar mientras esté vacío. Se confirma con "Confirmar" y se cancela con "Cancelar" o pulsando fuera de la ventana. El motivo queda guardado junto a la acción. |
| Sección "Timeline" | Cronología | — | Historial de la alarma, con sus veinte eventos más recientes: fecha y hora a la izquierda y el tipo de evento a la derecha ("raised" al levantarse, "acked" al reconocerse, "cleared" cuando la condición deja de cumplirse, "resolved", "shelved", "unshelved", "escalated" y "reopened"). Si la alarma todavía no tiene eventos registrados, bajo el título no aparece nada. |
| Estado de carga | Esqueleto de pantalla | — | Mientras se recuperan los datos, la ficha muestra la silueta de sus bloques en gris, de modo que la disposición no salta al terminar de cargar. |
| Estado de error | Mensaje de error | Reintenta la carga | "Error al cargar alarma", con el detalle que devuelve la plataforma o "Error de conexion con el servidor", y el botón "Reintentar". Si la alarma no existe, la pantalla muestra únicamente "Alarma no encontrada". |
💡 Guía de Uso
Esta ficha es donde se opera de verdad. El resto de la sección observa; aquí se decide. Antes de tocar ningún botón, léela de arriba abajo: el nombre de la regla dice qué se estaba vigilando, la severidad cuánto corre, el estado en qué punto del ciclo está la alarma y el recuadro de contexto —el valor alcanzado frente al umbral configurado— cuánto se ha desviado el proceso.
El recorrido habitual es el mismo orden en que aparecen los botones, de izquierda a derecha. Primero "Reconocer": es la forma de decir "ya lo he visto, me hago cargo". No corrige nada ni apaga la alarma; lo que hace es sacarla de la cola de pendientes y dejar tu nombre en su historial, de modo que el indicador "Sin Reconocer" del Overview baje y nadie duplique el trabajo. Después, una vez comprobada la instalación y corregida la causa, "Resolver" cierra la alarma.
Todas las acciones piden dos pulsaciones: la primera cambia el texto del botón a "Confirmar…" y lo tiñe de naranja; la segunda ejecuta. Si te distraes, la confirmación se cancela sola a los pocos segundos y el botón vuelve a su texto original: es una red de seguridad, no un fallo. En las alarmas P1 hay una segunda barrera: resolverlas o archivarlas exige escribir un motivo, que queda guardado junto a la acción para que la auditoría sepa por qué se cerró una alarma crítica.
"Archivar" —el shelve de la norma— es la salida para una alarma que se sabe que va a seguir sonando y que no aporta nada mientras se repara la causa: la aparta del flujo de atención sin borrarla. Está reservada al perfil Admin Global precisamente porque silencia una señal real. Ten en cuenta que, una vez archivada, en esta pantalla ya no hay botón para desarchivarla —aunque la plataforma sí admite esa transición por otras vías—: de las acciones sobre el estado solo queda "Resolver". Sigue disponible "Crear Tarea" —o "Ver Tarea", si ya tiene una vinculada—, que no depende del estado de la alarma.
Cuando la alarma requiere una intervención con seguimiento, "Crear Tarea" es el puente hacia mantenimiento: crea la tarea con el contexto de la alarma ya copiado y las deja vinculadas, de modo que el botón pasa a "Ver Tarea" y desde ahí se salta a la tarea en cualquier momento.
Para comprobar que una acción ha surtido efecto, mira dos sitios: la etiqueta de estado de la cabecera, que debe haber cambiado, y la sección "Timeline" del final, donde debe haber aparecido una línea nueva. Si nada de eso ocurre y el estado sigue igual, la acción no se ha aplicado —lo más frecuente es que sea una cuestión de permisos, o que la alarma haya cambiado de estado mientras la mirabas—: recarga la ficha para ver el estado real antes de volver a intentarlo. El registro completo y no modificable de quién hizo qué está en la pestaña Auditoría.