# Reglas de alerta

## 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](https://lymen.app/docs/operacion/incidentes/) 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](https://lymen.app/docs/operacion/anomalias/). 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](https://lymen.app/docs/datos/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](https://lymen.app/docs/operacion/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](https://lymen.app/docs/operacion/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](https://lymen.app/docs/operacion/perfiles-de-alerta/) y de las [ventanas de mantenimiento](https://lymen.app/docs/operacion/mantenimiento/).