# Perfiles de alerta

## Para qué sirve

Un **perfil de alerta** responde tres preguntas: **qué** incidentes le importan, **cuándo** avisar y **a quién** (y por dónde). Por ejemplo: "Guardia: lo grave, a cualquier hora, por Telegram al técnico de turno" y "Gerencia: solo lo crítico, de lunes a viernes de 8 a 20, por email".

Un mismo incidente puede llegar a varios perfiles. Sin perfiles, los incidentes se abren en Lymen pero **no se le avisa a nadie**.

## Cuándo usarlo

- Al empezar, para decidir quién se entera de qué.
- Cuando entra gente nueva a la guardia o cambia un horario.
- Cuando hay demasiados avisos (ajustar filtros y demoras) o muy pocos.

La opción del menú se llama **A quién avisar**, y tiene dos pestañas: **Perfiles de alerta** y [**Contactos**](https://lymen.app/docs/operacion/contactos/). Antes de armar un perfil conviene tener cargados los contactos y conectadas las [integraciones](https://lymen.app/docs/operacion/integraciones/) que vayas a usar.

## Quién puede qué

| Rol | Qué puede hacer |
|---|---|
| Administración | Ver, crear, editar y eliminar perfiles. |
| Sistemas | Ver, crear y editar. No puede eliminar. |
| Negocio | No ve la opción. |

## Cómo crear un perfil, paso a paso

1. Entrá a **A quién avisar** y tocá **Nuevo perfil**.
2. **Qué incidentes:** poné un nombre y elegí los filtros (severidad, tipo, servicios, etc.). Lo que dejes vacío vale para todo.
3. **Cuándo avisar:** elegí si avisa apenas se abre o después de unos minutos, si recuerda mientras siga abierto, si avisa el cierre y si tiene horario.
4. **A quién y por dónde:** marcá, por cada contacto, si le llega por email y/o Telegram. Sumá también canales (Slack, Teams, webhook, un grupo de Telegram o Jira).
5. Mirá en la barra de abajo cuántos avisos hubiera mandado en los últimos días con esas reglas.
6. Tocá **Probar perfil** para mandar un aviso de prueba de verdad a los destinos elegidos.
7. Tocá **Guardar perfil**.

## Campos

### 1. Qué incidentes

| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Nombre | Cómo lo ves en la lista. | Vacío (obligatorio) | Hasta 80 caracteres | Solo para identificarlo. |
| Para qué es | Una nota para el equipo. | Vacío | Hasta 500 caracteres | Ninguno. |
| Perfil activo | Si está en funcionamiento. | Sí | Sí / No | **Pausado no avisa nada.** Si pausás el único perfil que cubre una guardia, nadie se entera de los incidentes. |
| Severidad | Qué severidades entran. | Cualquiera | Crítica, Alta, Media (se pueden elegir varias) | Si elegís solo Crítica, los incidentes de severidad alta o media no llegan a este perfil. |
| Tipo | Qué tipos de incidente entran. | Cualquiera | Caído, Sin datos, Errores, Lento, Sin recursos, Negocio, Anomalía propia | Un tipo mal elegido deja incidentes sin avisar. |
| Servicios afectados | Solo incidentes que toquen estos servicios. | Cualquiera | Servicios que envían datos; también la opción "negocio" para alertas de negocio | Vacío = todos. |
| Servidores afectados | Solo incidentes que toquen estos servidores. | Cualquiera | Servidores conocidos | Si elegís servicios y servidores, entra el incidente que afecte a **cualquiera** de ellos. |
| Con las etiquetas (opcional) | Solo lo que tenga ciertas [etiquetas](https://lymen.app/docs/datos/etiquetas/) (por ejemplo `equipo: pagos`). | Cualquiera | Pares clave: valor | Entra si alguna entidad afectada tiene **todas** las etiquetas elegidas. |
| Nivel de lo afectado | Solo lo que tenga cierto nivel. | Cualquiera | T1 · Crítico, T2 · Importante, T3 · Normal (los nombres pueden estar personalizados en tu cuenta) | Entra si alguna entidad afectada tiene alguno de esos niveles. |
| El título contiene (opcional) | Solo incidentes cuyo título incluya esa palabra. | Vacío | Hasta 120 caracteres | Una palabra mal escrita hace que no entre ningún incidente. |
| De dónde viene | Origen del incidente. | De cualquier lado | Anomalías automáticas, Anomalías propias, Reglas del portal | Útil para separar lo técnico de lo que armó tu equipo. |

### 2. Cuándo avisar

| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Avisar | Cuánto esperar antes del primer aviso. | Apenas se abre | Apenas se abre, o si sigue abierto 5, 10, 15 o 30 minutos | Con demora, **si el incidente se cierra antes, no avisa**: sirve para que nadie se despierte por un parpadeo. A cambio, te enterás más tarde. |
| Mientras siga abierto, recordar | Repetir el aviso. | No | No, o cada 15 min, 30 min, 1 h o 2 h | Más recordatorios: más ruido y más mensajes. Sin recordatorio, un incidente largo se puede olvidar. |
| Avisar también cuando se cierra | Mandar un aviso al resolverse. | Sí | Sí / No | Útil para saber que ya terminó. En Jira agrega un comentario al ticket. |
| Horario | Limitar los avisos a ciertos días y horas. | Siempre | Siempre, o Solo en un horario | Fuera del horario no se avisa; queda anotado en el incidente como "fuera de horario". Un incidente grave a las 3 de la mañana puede quedar sin aviso si el horario es de oficina. |
| Días | Qué días vale el horario. | Lunes a viernes | Cualquier combinación de días | Debe haber al menos un día. |
| De / a | Franja horaria. | 08:00 a 20:00 | Horas en pasos de 30 minutos, hora de tu cuenta. Si la de inicio es mayor que la de fin, cruza la medianoche. | No pueden ser iguales. |

Durante una [ventana de mantenimiento](https://lymen.app/docs/operacion/mantenimiento/) no se avisa: el incidente queda marcado como "silenciado por mantenimiento".

### 3. A quién y por dónde

| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Contactos y canales por contacto | A qué personas avisar y cómo. | Ninguno | Por cada contacto activo: Email y/o Telegram | Telegram solo está disponible si el contacto tiene cargado su chat. Los contactos desactivados no aparecen. Cada persona elegida recibirá el texto del incidente: elegí solo a quien necesita verlo. |
| Canales | Destinos compartidos (Slack, Teams, un webhook, un grupo de Telegram o Jira). | Ninguno | Los que conectaste en [Integraciones](https://lymen.app/docs/operacion/integraciones/) | Los canales de Telegram solo se ofrecen si tienen un chat fijo. Los apagados se marcan como "apagado". **Jira abre un ticket por incidente.** |
| Probar perfil | Manda un aviso de prueba. | — | Botón | Es un envío **real** a todos los destinos elegidos: avisá antes al equipo. Muestra por cada destino si salió o no y cuánto tardó. |

Hace falta al menos un destino para guardar un perfil activo. Si no querés que avise, pausalo.

### Barra de simulación

Abajo de todo, Lymen calcula cuántos avisos hubiera mandado este perfil en los últimos días con la configuración que tenés en pantalla, cuántos incidentes eran, cuántos quedaron silenciados por mantenimiento y cuántos fuera de horario. Usala para calibrar antes de guardar.

## Cómo se manda un aviso

Por cada perfil que coincide con el incidente, Lymen manda un aviso cuando se **abre**, mientras **sigue abierto** (si hay demora), cada vez que toca un **recordatorio** y cuando se **cierra**. Si un envío falla, reintenta (hasta tres veces más). Cada intento queda registrado en el incidente, en **Avisos enviados**, con el resultado: Enviado, No salió, Enviando, Silenciado por mantenimiento o Fuera de horario.

## Ejemplos

| Perfil | Filtro | Cuándo | A quién |
|---|---|---|---|
| Guardia | Severidad Crítica y Alta | Apenas se abre, recordar cada 30 min, avisar el cierre; siempre | Técnico de turno por Telegram + canal de Slack |
| Gerencia | Severidad Crítica | Si sigue abierto 15 min; avisar cierre; lunes a viernes 08:00 a 20:00 | Dirección por email |
| Mesa de ayuda | Tipo Caído y Errores | Apenas se abre | Canal Jira (abre un ticket) |
| Sede norte | Etiqueta `sede: norte` | Apenas se abre | Responsable de la sede por email |

## Problemas comunes

- **No puedo guardar.** Falta el nombre, el horario es inválido (sin días o horas iguales) o falta elegir a quién avisar (o pausar el perfil).
- **No aparece Telegram para un contacto.** Cargá su chat de Telegram en [Contactos](https://lymen.app/docs/operacion/contactos/) y verificá que haya una integración de Telegram conectada.
- **No aparecen canales para elegir.** Todavía no conectaste ninguno: andá a [Integraciones](https://lymen.app/docs/operacion/integraciones/).
- **El incidente no avisó.** Abrilo y mirá **Avisos enviados**. Si dice "Fuera de horario", "Silenciado por mantenimiento" o "No se le avisó a nadie", el motivo está en el perfil, en una ventana de mantenimiento o en que ningún perfil coincide.
- **Llegan avisos duplicados.** Un incidente que coincide con varios perfiles avisa una vez por perfil. Si una persona está en dos, recibe dos.
- **Los emails no salen.** El envío de correos lo hace una automatización del sistema; fijate su estado en [Automatizaciones](https://lymen.app/docs/operacion/automatizaciones/).