Docs
Ctrl K
Volver al sitio Pedí una demo
DocsOperaciónReglas de alerta

Reglas de alerta

.md

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é sirveCuándo usarloQuién puede quéLa lista de reglasCómo crear una regla, paso a pasoCamposEditar y borrarEjemplosProblemas comunes

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#

  1. Entrá a Alertas › Reglas y tocá Nueva regla (aparece solo para Administración y Sistemas).
  2. 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).
  3. 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".
  4. Cómo avisar: poné un nombre, la severidad y el texto del aviso.
  5. 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ó.
  6. 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.