---
url: https://docs.zenavo.app/es-ES/operations/alert-rules
---

# Reglas de alerta

Las reglas de alerta te avisan cuando algo supera un umbral que tú eliges: un servidor o servicio que sigue ocupado, o registros que repiten el mismo error. Se suman a las [notificaciones](https://docs.zenavo.app/es-ES/operations/notifications) integradas, que todos los planes conservan. Las reglas de alerta están incluidas en el plan **Pro** y superiores: 20 reglas en Pro y 100 en Team.

## Añadir una regla {#add-a-rule}

Los propietarios y administradores del equipo abren **Ajustes de la cuenta → Reglas de alerta** (para el equipo elegido en la barra lateral) y hacen clic en **Añadir regla**. Elige qué vigila:

| Vigila | Umbral | Se dispara cuando |
| --- | --- | --- |
| **CPU del servidor** | Porcentaje de todos sus núcleos | Todas las muestras de los últimos *N* minutos están en el umbral o por encima |
| **Memoria del servidor** | Porcentaje en uso | Igual |
| **Disco del servidor** | Porcentaje en uso | Igual |
| **CPU del servicio** | vCPU, todas las instancias juntas (1 vCPU = un núcleo) | Igual |
| **Memoria del servicio** | MiB, todas las instancias juntas | Igual |
| **Líneas de registro** | Número de líneas | En los últimos *N* minutos se escribieron al menos esas líneas con el texto |

*N* va de 1 a 60 minutos. Las métricas se toman más o menos una vez por minuto, así que una regla necesita muestras que cubran toda su ventana antes de dispararse: una sola muestra alta tras un periodo tranquilo no cuenta. Un servidor que deja de informar (por ejemplo, mientras está desconectado) conserva el estado de su regla; ese caso lo cubre la notificación integrada **Servidor desconectado**.

Una regla de **Líneas de registro** vigila un servicio de un proyecto, o todos. El texto se busca en cualquier parte de la línea, sin distinguir mayúsculas, después de ocultar los valores de las variables. Las líneas se cuentan a medida que se escriben; nunca se guardan para las reglas ni se envían en las alertas.

Las reglas se comprueban cada minuto. La lista muestra el último valor de cada regla y **Activa** mientras se cumple su condición. Al cambiar una regla, empieza de nuevo. Añadir, cambiar y eliminar reglas queda en el [registro de auditoría](https://docs.zenavo.app/es-ES/account/audit-log).

## Alertas {#alerts}

Una regla que se dispara envía **Regla de alerta disparada** al equipo: correos a los miembros que la tienen activada (propietarios y administradores por defecto, como las demás [notificaciones](https://docs.zenavo.app/es-ES/operations/notifications#who-gets-them)) y mensajes a los [canales](https://docs.zenavo.app/es-ES/operations/notifications#channels) del equipo suscritos. Cuando la condición deja de cumplirse, llega un mensaje de **Recuperada**.

Cada regla avisa como mucho una vez por hora. Si vuelve a dispararse dentro de esa hora, la consola la muestra **Activa** pero no envía nada, ni tampoco la recuperación.

Las alertas indican la regla, qué vigila, la condición y el valor observado, como *mínimo del 86 % en ese tiempo* o *14 líneas coincidentes*. Nunca incluyen texto de registros, valores de variables ni secretos.

## Planes {#plans}

En los planes sin reglas de alerta, la página indica qué plan las incluye. Un equipo que pasa a uno de esos planes conserva sus reglas: dejan de comprobarse y se pueden editar, desactivar o eliminar, pero no activar ni añadir. Se reanudan solas cuando el equipo vuelve a Pro o Team.

## API {#api}

| Método | Ruta | |
| --- | --- | --- |
| `GET` `POST` | `/api/teams/{tid}/alert-rules` | Listar reglas o añadir una: `{kind, name, threshold, window_minutes}` con `server_id` para `server_cpu`, `server_memory` y `server_disk`; `project_id` y `service` para `service_cpu` (milinúcleos) y `service_memory` (MiB); `project_id`, `pattern` y opcionalmente `service` para `log_match` |
| `PATCH` `DELETE` | `/api/teams/{tid}/alert-rules/{rid}` | Cambiar cualquier campo salvo `kind`, o `enabled`; eliminar |

Crear o activar una regla sin un plan que las incluya devuelve 402 con [`plan_required`](https://docs.zenavo.app/es-ES/api/overview#conventions).