Alertas y notificaciones

Pier supervisa las métricas del host y de los contenedores, además de eventos del ciclo de vida como despliegues y copias de seguridad, y envía notificaciones cuando algo cruza un umbral o falla.

Reglas de alerta

Una regla empareja una métrica con un umbral, una comparación y una gravedad. Las reglas numéricas se evalúan en un tick recurrente (de forma predeterminada cada 30 segundos); las reglas de eventos se disparan desde la ruta de código que produjo el evento.

Métricas disponibles:

Grupo	Métricas
Host	cpu, ram, disk
Contenedor	container_cpu, container_ram, container_status, container_restarts
Ciclo de vida	deploy_status, deploy_success, backup_status, backup_success
Infraestructura	agent_offline, server_reachable, ssl_expiry, docker_cleanup_success, docker_cleanup_failure

Cada regla también incluye:

• comparación — gt, lt o eq.
• gravedad — info, warning o critical.
• ámbito — global o un servicio específico.
• duración — cuánto debe mantenerse una infracción antes de dispararse (predeterminado 60 s).
• periodo de enfriamiento — intervalo mínimo entre disparos repetidos mientras la infracción persiste (predeterminado 30 minutos).

Una regla se dispara una vez que su infracción se ha mantenido durante la duración configurada, vuelve a dispararse solo después de que transcurre el periodo de enfriamiento, y se resuelve automáticamente cuando el valor vuelve por debajo del umbral.

Canales de notificación

Pier incluye cuatro canales. Cada uno tiene una única configuración global, almacenada cifrada:

Canal	Configuración
Telegram	Token del bot + ID del chat
Email	Driver (smtp, brevo o resend) + direcciones de origen/destino
Discord	URL del webhook + ping opcional @here
Slack	URL del webhook

Para el correo electrónico SMTP, el modo de cifrado (starttls, tls, none), el host, el puerto (predeterminado 587) y las credenciales se configuran por canal. Brevo y Resend envían a través de sus APIs HTTP usando una clave de API en su lugar.

La entrega de Telegram se conecta directamente a api.telegram.org. Si la red de tu servidor bloquea ese host, las notificaciones de Telegram no se enviarán aunque la configuración sea válida.

Notificaciones de prueba

Cada canal tiene una acción Test que envía un mensaje de muestra a través de la configuración activa, de modo que puedas confirmar las credenciales y la conectividad antes de depender del canal. Las reglas individuales también pueden enviar un mensaje de prueba etiquetado [TEST].

El feed de eventos

Cada disparo y resolución se registra como un evento con su estado de entrega. Hay dos vistas disponibles:

• Un feed global de los eventos más recientes de todas las reglas.
• Un historial por regla de los eventos recientes de esa regla.

Las entregas fallidas se conservan con el mensaje de error adjunto, de modo que un webhook mal configurado o un host SMTP incorrecto sean visibles en el feed en lugar de descartarse silenciosamente.

Alertas predefinidas

Pier incluye un conjunto de reglas predefinidas listas para usar, de modo que no empieces desde cero. Las alertas predefinidas se activan o desactivan en lugar de construirse campo a campo, y entregan a través de la configuración de canales globales descrita arriba en lugar de llevar sus propias credenciales.

Próximos pasos

• Mantenimiento del sistema — los eventos de limpieza de Docker también alimentan alertas.
• Copias de seguridad — haz copias de seguridad de las bases de datos que vigilan las alertas.
• Resolución de problemas — cuando las notificaciones no llegan.