Reglas de alerta
Armá reglas simples del tipo "avisame si los errores pasan de 5 % durante 5 minutos", sin escribir código. Cuando una regla se cumple, Lymen abre un incidente.
En esta página
Para qué sirve#
Una regla le dice a Lymen qué vigilar y cuándo avisar. Por ejemplo: "si los errores del servicio de turnos pasan de 5 % durante 5 minutos, abrí un incidente". Se arman eligiendo opciones, sin escribir consultas. Cuando la regla se cumple, Lymen abre un incidente con el texto que escribiste, y se cierra solo cuando todo vuelve a la normalidad.
Cuándo usarlo#
- Cuando sabés qué número no debería pasar un límite (errores, tiempo de respuesta, pedidos por minuto, ventas rechazadas).
- Cuando querés vigilar un evento de negocio que cuenta tu aplicación.
- Si preferís que Lymen aprenda solo qué es normal, usá Anomalías. Las dos se complementan.
Esta pantalla y la de Anomalías son pestañas de la misma opción del menú: Alertas › Reglas.
Quién puede qué#
| Rol | Qué puede hacer |
|---|---|
| Administración | Ver, crear, editar y borrar reglas. |
| Sistemas | Ver, crear y editar. No puede borrar. |
| Negocio | No ve esta opción del menú. |
La lista de reglas#
La tabla muestra, por regla: nombre, cuándo avisa, severidad, estado y cuántas veces se disparó en las últimas 24 horas. Primero van las que están disparando, después las que dieron error, y después el resto; las del portal van antes que las automáticas. La pantalla se actualiza sola cada 15 segundos.
| Estado | Qué significa |
|---|---|
| Activa | La regla vigila y todo está dentro del límite. |
| Por disparar | Se superó el límite pero todavía no pasó el tiempo de "Durante". |
| Disparada | Se cumplió y hay un incidente abierto. |
| Activándose | Recién guardada: tarda unos segundos en empezar a vigilar. |
| Error | La regla no se pudo cargar. Se muestra el motivo debajo. |
Las reglas con la marca Automática son parte de la detección de anomalías de Lymen: aprenden qué es normal y no se editan ni se borran. Podés abrirlas para mirarlas.
Cómo crear una regla, paso a paso#
- Entrá a Alertas › Reglas y tocá Nueva regla (aparece solo para Administración y Sistemas).
- Qué medir: elegí una tarjeta. Si la señal lo pide, elegí el servicio o el evento de la lista (solo aparecen los que ya están enviando datos).
- Cuándo avisar: elegí Más de o Menos de, el umbral y cuánto tiempo tiene que sostenerse. Abajo ves la frase que se arma, por ejemplo "los errores de web-turnos pasan de 5 % durante 5 minutos".
- Cómo avisar: poné un nombre, la severidad y el texto del aviso.
- Probar: tocá Probar con las últimas 24 h. Te muestra cuántas veces hubiera disparado, un gráfico con la línea del umbral y los momentos en que se pasó.
- Guardar: tocá Guardar y activar. El botón queda deshabilitado hasta que probás la regla. Si cambiás cualquier campo después de probar, tenés que volver a probar.
Campos#
1. Qué medir#
| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Qué medir (señal) | El dato que se vigila. | La primera señal de la lista (Errores) | Ver tabla de señales | Cambiar la señal cambia la unidad y el rango del umbral; el umbral se reinicia al sugerido. |
| De qué servicio | El servicio vigilado. | El primero de la lista | Uno de los servicios que envían datos | Si el servicio deja de enviar datos, la regla queda sin datos y no dispara. Se muestra igual si ya no llega, para que puedas corregirla. |
| Qué evento | El evento de negocio contado. | Ninguno | Uno de los eventos que ya llegaron | Si el evento nunca llega, la regla no dispara. |
Señales disponibles
| Señal | Unidad | Rango del umbral | Umbral sugerido | Pide |
|---|---|---|---|---|
| Errores | % de pedidos que fallan | 0 a 100 (de a 0,1) | 5 | Servicio |
| Tiempo de respuesta (p95) | ms (lo que tarda el 95 % de los pedidos) | 1 a 600.000 | 800 | Servicio |
| Pedidos | pedidos por minuto | 0 a 1.000.000 | 1 | Servicio |
| Eventos de negocio | eventos por hora | 0 a 1.000.000 | 1 | Un evento |
| Señales de negocio propias de tu cuenta (por ejemplo, turnos reservados o pagos rechazados) | eventos por hora | 0 a 1.000.000 | 1 o 10 | Nada: salen de eventos fijos |
Las señales de negocio propias solo aparecen si tu cuenta tiene configurados esos eventos (ver Reglas de captura). Si no ves una, es porque tu cuenta no la tiene.
2. Cuándo avisar#
| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Condición | Si avisa cuando el valor sube o baja del umbral. | Más de | Más de, Menos de | "Menos de" sirve para detectar que algo dejó de pasar (por ejemplo, cero pedidos). Con una señal que a veces vale cero, puede dar avisos de más. |
| Umbral | El límite. | El sugerido de la señal | Ver tabla de señales | Muy bajo: ruido y avisos de más. Muy alto: te enterás tarde. |
| Durante | Cuánto tiempo tiene que sostenerse la condición antes de disparar. | 5 minutos | 1, 5, 10, 15, 30 minutos o 1 hora | Más corto: avisa antes pero con más falsas alarmas por picos. Más largo: menos ruido pero tardás más en enterarte. |
3. Cómo avisar#
| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Nombre de la regla | Cómo la ves en la lista. | Vacío | 3 a 60 caracteres: letras sin acento, números, espacios, punto, guion y guion bajo | Es el nombre público de la regla; no uses datos sensibles. |
| Severidad | Qué tan urgente es. | Media | Alta (urgente, hay que mirar ya) o Media (importante, puede esperar un rato) | Alta se muestra más fuerte y sirve para filtrar en los perfiles de alerta: si un perfil solo recibe severidad alta, una regla media no le avisa. |
| Texto del aviso | Lo que se lee en el incidente. | Vacío | 3 a 200 caracteres. Letras, números y signos comunes; sin llaves, $, <, > ni saltos de línea |
Es lo que van a leer quienes reciben el aviso por correo, Telegram, Slack o Teams. Escribilo claro y sin datos sensibles. |
4. Probar y guardar#
| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Probar con las últimas 24 h | Simula la regla contra lo que pasó ayer y hoy. | No probada | Botón | No avisa a nadie ni abre incidentes. Es solo una lectura de datos. |
| Guardar y activar | Crea la regla y la deja vigilando. | — | Botón (se habilita después de probar) | Desde que guardás, la regla puede abrir incidentes y disparar avisos según tus perfiles. |
Quienes tienen rol Administración o Sistemas también ven una vista técnica de la regla, útil para el equipo de sistemas.
Editar y borrar#
Al abrir una regla desde la lista se ve su detalle. Para cambiarla, tocá Editar. Los cambios valen desde que guardás; los incidentes que ya abrió no cambian. Borrar una regla (solo Administración) deja de vigilar; los incidentes ya abiertos siguen hasta que se cierren.
Ejemplos#
| Quiero… | Señal | Condición | Umbral | Durante | Severidad |
|---|---|---|---|---|---|
| Enterarme si el servicio de turnos falla mucho | Errores, web-turnos | Más de | 5 % | 5 minutos | Alta |
| Saber si el sistema se puso lento | Tiempo de respuesta (p95), web-turnos | Más de | 2000 ms | 10 minutos | Media |
| Detectar que el servicio dejó de recibir pedidos | Pedidos, web-turnos | Menos de | 1 pedido/min | 15 minutos | Alta |
| Que me avisen si se rechazan muchos pagos | Señal de negocio de pagos rechazados | Más de | 10 por hora | 30 minutos | Media |
Problemas comunes#
- No puedo guardar. Falta probar la regla o hay un campo con error (se marca debajo del campo). Con el nombre o el texto del aviso, revisá los caracteres: no se aceptan acentos en el nombre ni llaves en ninguno.
- El servicio que quiero no aparece. Solo se listan servicios que ya están enviando datos. Verificá que el servicio esté conectado.
- La regla dice "Activándose" mucho tiempo. Debería pasar en segundos. Si sigue, recargá la pantalla; si no cambia, pedí soporte.
- Dispara demasiado. Subí el umbral o aumentá "Durante". Revisá la prueba de 24 horas antes de guardar.
- Nunca dispara. Probá con un umbral más bajo y mirá el gráfico de la prueba para ver el rango real del dato.
- Dispara pero no me llega el aviso. La regla abre el incidente; el aviso depende de los perfiles de alerta y de las ventanas de mantenimiento.