alerta

Qué es

Una alerta es una señal automática de que una condición vigilada se
ha mantenido el tiempo suficiente para justificar interrumpir a
alguien. Algunos equipos la llaman alarma, y una alerta lo bastante
sonora como para despertar a la persona de guardia suele denominarse
aviso de guardia, o page.

La palabra abarca dos objetos que Prometheus separa de forma clara.
Una regla de alertas de Prometheus produce alertas: una por cada
conjunto distinto de etiquetas para el que la expresión devuelve un
resultado. Estas llegan a otro programa, Alertmanager, que las
convierte en notificaciones: un correo, un mensaje de chat o una
llamada a un servicio de guardias. El proyecto advierte que las
reglas por sí solas no constituyen un sistema completo de
notificación. La separación importa porque las cifras divergen.
Cincuenta alertas pueden llegar en un mensaje, una puede generar
recordatorios cada pocas horas y otra silenciada no llega a nadie
aunque siga activa.

La alerta tiene un ciclo breve. Mientras la expresión no devuelve
nada, está inactiva. Al devolver el primer resultado queda pendiente
y permanece así durante lo exigido por `for`. Si la condición sigue
cumpliéndose al terminar la espera, se activa y se entrega para su
envío. Cuando deja de cumplirse, se resuelve. Una cláusula más
reciente, `keep_firing_for`, mantiene abierta una alerta activa un
tiempo después de desaparecer la condición; la documentación la
propone para evitar oscilaciones y falsas resoluciones. Prometheus
registra también los estados pendiente y activo en una serie
temporal `ALERTS`, para consultar y representar las propias alertas.

Una regla que espera veinte minutos para activarse y diez más para
cerrarse tiene este aspecto:

```yaml
groups:
    - name: exports
      rules:
          - alert: ExportQueueStalled
            expr: exports_waiting > 0 and rate(exports_done_total[15m]) == 0
            for: 20m
            keep_firing_for: 10m
            labels:
                severity: page
                team: billing
            annotations:
                summary: "{{ $value }} exports queued and none finishing"
```

Las etiquetas y las anotaciones se parecen, pero hacen trabajos
distintos. Las etiquetas forman parte de lo que identifica esta
alerta y la distingue de otra, y Alertmanager las lee para decidir
su destino: `severity: page` puede llegar a un teléfono, mientras
que `severity: ticket` termina en una cola. Las anotaciones
contienen las palabras que necesita una persona una vez recibido el
mensaje: un resumen de una línea, una descripción más extensa y un
enlace al procedimiento operativo que indica qué hacer primero. Las
anotaciones pueden usar plantillas con las etiquetas de la alerta y
el valor que la activó; así puede el resumen anterior incluir una
cifra.

Alerta e incidente son palabras distintas por un motivo. La alerta
informa de una condición cumplida; decidir si constituye un
incidente corresponde a una persona.

Por qué importa

La alerta es la parte de la monitorización que no espera a que la
miren. Una métrica queda almacenada, un panel espera en una pantalla
y un registro espera una búsqueda; una alerta irrumpe en la tarde de
alguien. Cada regla exige así de forma permanente una pequeña parte
de su atención, y solo es justo si puede hacer algo con ella. La
guía de Prometheus recomienda evitar avisos de guardia sin acción
posible y mantener sencillo el sistema de alertas.

La segunda razón es aritmética. Una sola causa suele activar muchas
reglas a la vez. Cuando una partición de red separa de su base de
datos a la mitad de las instancias de un servicio, cada instancia
puede disparar su propia alerta, y la documentación de Alertmanager
usa exactamente ese caso para mostrar cómo cientos de alertas se
convierten en una única notificación. Alertmanager reúne las alertas
que comparten las etiquetas nombradas en `group_by`, espera
`group_wait` (30 segundos de forma predeterminada) para que el
primer mensaje contenga todo el lote, envía actualizaciones del
grupo con una frecuencia no mayor que `group_interval` (5 minutos) y
repite un mensaje cuya alerta siga activa después de
`repeat_interval` (4 horas). La inhibición va un paso más allá y
suprime algunas alertas mientras otra está activa, de modo que una
alerta que indica que todo un clúster es inaccesible puede silenciar
las de los servicios que contiene. Los silencios desactivan las
notificaciones de las alertas que coinciden con un conjunto de
etiquetas durante un plazo fijo, normalmente durante un
mantenimiento planificado.

La tercera razón es el final. La mayoría de receptores envía un
mensaje de resolución, pero `send_resolved` del receptor de correo
vale false de forma predeterminada. Un equipo que avisa por correo
puede conocer el problema y nunca su fin.

Cómo se aplica en la práctica

El host de la empresa utiliza una alarma por ausencia de señal. Sus
464 MB de memoria sostienen un servidor web y una forja, y el
agotamiento de la memoria y un disco lleno son dos riesgos
importantes de fallo. Un temporizador en el host envía una señal a
un servicio externo solo si se superan las comprobaciones de los
umbrales de memoria disponible y espacio libre en disco, cada quince
minutos con cierta variación; el servicio externo activa la alarma
cuando dejan de llegar las señales esperadas. Los fallos que impiden
al script ejecutarse o contactar con ese servicio, como la pérdida
de red o un arranque fallido, producen una señal ausente. Una señal
recibida confirma que el script se ejecutó y se superaron sus
comprobaciones de los umbrales de memoria disponible y espacio libre
en disco; no certifica el buen estado general del host ni que el
sitio esté sirviendo páginas. La monitorización puede revelar
señales de advertencia, aunque el momento en que aparecen depende de
la carga de trabajo y de las condiciones observadas.

La misma inversión puede proteger el trabajo programado. La
implementación de copias de seguridad separa las señales de éxito de
copia y restauración. Sus scripts y unidades systemd permiten
instantáneas cifradas fuera del host, comprobaciones de integridad y
una prueba mensual de restauración de un archivo conocido; solo se
envía una señal tras completarse correctamente su flujo. Ese es el
diseño de la ruta de alertas, no una prueba de que estuviera activa.
El registro de implementación del 2026-10-27 indica que los
temporizadores estaban desactivados al no haber un repositorio
configurado y no documenta ninguna restauración real completada. El
silencio puede producir una alerta externa una vez activados el
flujo y su monitor; la configuración por sí sola no demuestra que
estén funcionando.

Las alertas invertidas tienen un fallo propio, descubierto al
preparar el crecimiento de uno a dos hosts. Compartir un mecanismo
de vigilancia entre ambos habría debilitado las alertas que se
pretendía ampliar: mientras cualquiera siga enviando señales, la
comprobación aparece correcta aunque el otro esté muerto. Cada
mecanismo pasó a ser un valor por host y las entradas del host
existente se dejaron vacías deliberadamente: la configuración indica
que el cableado existe y aún falta proporcionar el valor.

Dónde surgen los problemas

Un valor medido termina en una etiqueta. Como las etiquetas
identifican la alerta, poner la cifra actual convierte cada cambio
en una alerta nueva y resuelve la anterior. El receptor ve pares de
activación y resolución para un solo problema. Reserve etiquetas
para identidad y enrutamiento; ponga cifras en anotaciones.

La alerta oscila. Una condición cerca del umbral se activa, resuelve
y reactiva cada pocos minutos; cada resolución dice algo falso.
Alargue `for` para que un pico desaparezca antes de avisar y use
`keep_firing_for` para que una caída breve bajo el umbral no cierre
la alerta.

Un silencio sobrevive a su motivo. Alguien silencia una alerta por
mantenimiento con una condición de coincidencia amplia y una hora de
fin generosa, y el fallo real de la próxima semana llega silenciado.
Limite las coincidencias tanto como permita el trabajo, establezca
una hora de fin cercana al término previsto y escriba quién lo
estableció y por qué en el campo de comentario que ofrece
Alertmanager.

Una ruta amplia se traga las específicas. Alertmanager recorre el
árbol de enrutamiento en orden y, salvo que una ruta establezca
`continue: true`, se detiene en el primer hijo coincidente. Una ruta
que lo recoge todo situada antes de la propia de un equipo se lleva
las alertas de ese equipo. Sitúe primero las rutas más concretas y
pruebe el árbol con etiquetas de muestra antes de confiar en él.

Todo es urgente. Un disco al 70 %, un certificado que caduca el mes
siguiente y un servicio de pagos que devuelve errores generan avisos
al mismo teléfono, que pronto acaba ignorándose. Reserve los avisos
de guardia para condiciones ante las que alguien deba actuar ahora,
envíe lo demás a una cola de tickets o a un resumen diario y elimine
una regla que lleve meses activándose sin que nadie actúe.

Lecturas adicionales

  * Panorama de las alertas — cómo se reparten el trabajo las reglas
de alerta de Prometheus y Alertmanager, y los pasos para configurar
ambos.

  * Reglas de alertas — la sintaxis de las reglas, incluidos `for`,
`keep_firing_for`, etiquetas, anotaciones y plantillas.

  * Alertmanager — agrupación, inhibición, silencios y ejecución de
varias instancias de Alertmanager para alta disponibilidad.

  * Configuración de Alertmanager — el árbol de enrutamiento, los
temporizadores de agrupación, las reglas de inhibición y los ajustes
de cada receptor, entre ellos `send_resolved`.

  * Prácticas de alertas — los consejos del propio proyecto sobre
qué merece un aviso de guardia y qué corresponde a otro canal.

hEsta página en la web	URL:https://engineer.company/es/glossary/alert/	engineer.company	70
