# Mantenimiento

## Para qué sirve

Una **ventana de mantenimiento** es un período en el que sabés que algo va a fallar o reiniciarse (una actualización, un corte programado, un cambio de equipo). Durante la ventana, los servicios que elijas **no generan avisos**, así nadie recibe alarmas por algo esperado. Los datos se siguen guardando y los gráficos siguen mostrando lo que pasó.

## Cuándo usarlo

- Antes de actualizar o reiniciar un servidor o una aplicación.
- Para mantenimientos que se repiten (por ejemplo, todos los domingos a la madrugada).
- Cuando una sede entera va a estar fuera de línea.

## Quién puede qué

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

## Cómo se crea una ventana, paso a paso

1. Entrá a **Alertas › Mantenimiento** y tocá **Nueva ventana**.
2. Poné un **nombre** que explique qué se hace.
3. Elegí **Desde** y **Hasta** (fecha y hora), y si se repite.
4. Elegí los **servicios** sin avisos, y/o **etiquetas** y **niveles**.
5. Elegí qué pasa con los problemas durante la ventana.
6. Tocá **Guardar ventana**.

La pantalla separa las ventanas en **En curso**, **Próximas** y **Terminadas** (se guardan las últimas 30 terminadas).

## Campos

| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Nombre | Qué se hace y por qué. | Vacío (obligatorio) | Hasta 120 caracteres | Se muestra en los incidentes que arrancan durante la ventana. |
| Desde / hasta | Cuándo empieza y termina. Horario de Buenos Aires. | Desde la próxima hora en punto; dura 1 hora | Fecha y hora (horas en pasos de 30 minutos). "Hasta" tiene que ser posterior a "Desde". Una ventana nueva no puede empezar antes de hoy. | **Una ventana dura como mucho 7 días** (y una ventana diaria, como mucho 24 horas). Si se pasa de la hora de fin, los avisos vuelven solos. Si se queda corta, se generan avisos de lo que siga fallando. |
| Repetir | Si se repite. | Una vez | Una vez, Cada día, Cada semana, Cada mes | Una repetición semanal usa el día de la semana de "Desde"; la mensual, el día del mes. Una ventana recurrente silencia en cada repetición hasta que la borres o la edites. |
| Servicios sin avisos durante la ventana | Qué servicios se silencian. | Ninguno | Servicios que detectan los agentes (podés pegar varios separados por coma) | Un servicio silenciado no avisa ni aunque se rompa de verdad por otro motivo. Elegí solo lo que se va a tocar. |
| Y todo lo que tenga (opcional) | Silenciar por etiqueta (por ejemplo `sede: norte`) o por nivel. | Nada | Etiquetas clave: valor, o niveles T1/T2 | Se resuelve en el momento: **lo que se etiquete después también queda incluido**. Una etiqueta muy general (como un nivel) puede silenciar muchos servicios. |
| Qué pasa con los problemas durante la ventana | Si se registran o se ignoran. | No avisar, pero registrar | No avisar, pero registrar; No abrir incidentes | **Registrar**: los incidentes se abren marcados "en mantenimiento" y no llegan avisos; te queda el historial. **No abrir incidentes**: como si no hubiera pasado nada, no queda registro. Usalo solo si el corte es seguro. |

Hay que elegir al menos un servicio, una etiqueta o un nivel.

## Qué ves cuando hay una ventana en curso

Los servicios silenciados llevan una marca de mantenimiento. Los incidentes que arrancaron dentro de la ventana lo indican, y los [perfiles de alerta](https://lymen.app/docs/operacion/perfiles-de-alerta/) los registran como "silenciado por mantenimiento" en vez de avisar. Los flujos tampoco se disparan por incidentes que arrancan en una ventana.

## Ejemplos

- **Actualización del servidor de base de datos un sábado de noche.** Desde sábado 23:00 hasta domingo 02:00; una vez; servicios: los que usan esa base; modo: No avisar, pero registrar.
- **Reinicio semanal.** Domingo 03:00 a 03:30; repetir cada semana; servicios del sistema de turnos.
- **Corte eléctrico programado en una sede.** Etiqueta `sede: norte`; una vez; modo: No avisar, pero registrar.

## Problemas comunes

- **"Una ventana dura como mucho 7 días".** Para tareas más largas, partí la ventana en tramos.
- **"Elegí al menos un servicio, una etiqueta o un nivel".** Una ventana sin alcance no silencia nada.
- **Me siguen llegando avisos.** Verificá que el servicio esté en la ventana, que la hora sea la de Buenos Aires y que la ventana esté en curso. Un servicio que no figura en la lista no se puede elegir hasta que envíe datos.
- **Terminé antes de la hora.** Editá la ventana y poné la hora de fin que corresponda, o eliminala si sos Administración.