KubeBolt docs
ENES GitHub

Configuración

Notificaciones

Envío de alertas a Slack, Discord y correo cuando se disparan insights. Opcional: desactivado si no hay ningún canal configurado.

En esta página
  1. Canales
  2. Qué dispara una notificación
  3. Una ráfaga es un solo mensaje
  4. Ajustes globales
  5. Siempre activas en todos los clústeres
  6. Slack
  7. Discord
  8. Correo

Canales

La edición open source envía a tres canales (Slack, Discord y correo) y a nada más. Cada uno se activa cuando se configuran sus datos de conexión. Puedes activar uno, dos o los tres a la vez.

Qué dispara una notificación

Un insight notifica cuando se abre un episodio nuevo de él con la severidad mínima o superior. Una condición que sigue activa, o una restaurada tras un reinicio, no vuelve a notificar, y el mismo insight en el mismo clúster notifica como máximo una vez por ventana de cooldown. Con las notificaciones de resueltos activadas, la resolución del insight envía un mensaje más, titulado [Resolved].

Una ráfaga es un solo mensaje

La primera evaluación de un clúster, una reconexión después de que caducaran sus episodios o un nodo que tumba decenas de workloads pueden abrir muchos insights a la vez. Desde la 2.6.4 ya no llegan como un mensaje cada uno:

Los resúmenes de ráfaga no se pueden desactivar. KUBEBOLT_NOTIFICATIONS_BURST_* y KUBEBOLT_NOTIFICATIONS_DIGEST_LIST_LIMIT fijan la base, y Administration → System → Notifications → Summaries la mueve dentro de rangos fijos:

AjustePor defectoRango
Burst threshold (KUBEBOLT_NOTIFICATIONS_BURST_THRESHOLD)5 insights2–1000
Window (_BURST_WINDOW)60 sde 10 s a 1 h
Quiet before sending (_BURST_QUIET)30 sde 5 s a 10 min, nunca más que Longest wait
Longest wait (_BURST_MAX_WAIT)5 minde 30 s a 1 h
Digest: list up to (KUBEBOLT_NOTIFICATIONS_DIGEST_LIST_LIMIT)20 insights1–500

Un valor de entorno fuera de su rango se aplica en el límite más cercano. Un umbral por debajo de 2 o un límite de lista por debajo de 1 vuelven al valor por defecto, así que un 0, que antes significaba apagado, nunca desactiva los resúmenes.

Ajustes globales

Parámetros comunes a todos los canales, que se aplican a cada notificador:

Variable de entornoPor defectoPara qué sirve
KUBEBOLT_NOTIFICATIONS_ENABLEDtrueInterruptor general: ponlo en false durante las ventanas de mantenimiento.
KUBEBOLT_NOTIFICATIONS_MIN_SEVERITYwarningLos insights por debajo de este umbral no notifican. Valores: critical, warning, info.
KUBEBOLT_NOTIFICATIONS_COOLDOWN1hVentana de deduplicación: el mismo insight en el mismo clúster se dispara como máximo una vez por cooldown.
KUBEBOLT_NOTIFICATIONS_BASE_URL(ninguno)URL pública de tu KubeBolt: se incrusta como enlace directo en los mensajes.
KUBEBOLT_NOTIFICATIONS_INCLUDE_RESOLVEDfalseNotifica también cuando un insight pasa a resuelto.
KUBEBOLT_SLACK_ENABLED · KUBEBOLT_DISCORD_ENABLED · KUBEBOLT_EMAIL_ENABLEDtruePausa un canal sin borrar su configuración.

Con Helm, configúralas con extraEnv; con Docker Compose, añádelas a la lista environment: de la API, que no las incluye por defecto. O usa la página de Administration que se describe más abajo. Todas las variables: Variables de entorno.

Siempre activas en todos los clústeres

Las notificaciones de insights se disparan para cualquier clúster que KubeBolt esté evaluando, no solo para el que tienes abierto:

La regla del episodio nuevo sigue aplicándose, así que los insights restaurados o intermitentes (flapping) no vuelven a notificar. Consulta Multiclúster.

Slack

# Crea un Incoming Webhook en Slack y después:
KUBEBOLT_SLACK_WEBHOOK_URL=https://hooks.slack.com/services/T.../B.../...

Discord

# Server Settings → Integrations → Webhooks → New Webhook, y después:
KUBEBOLT_DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...

Correo

KUBEBOLT_SMTP_HOST=smtp.example.com
KUBEBOLT_SMTP_PORT=587                 # 587 por defecto (STARTTLS); 465 = TLS implícito
KUBEBOLT_SMTP_USERNAME=alerts@example.com
KUBEBOLT_SMTP_PASSWORD=...
KUBEBOLT_SMTP_FROM=KubeBolt <alerts@example.com>
KUBEBOLT_SMTP_TO=sre@example.com,oncall@example.com
KUBEBOLT_SMTP_DIGEST_MODE=hourly       # instant (por defecto) | hourly | daily

El correo cuenta como configurado cuando están definidos el host, el remitente y al menos un destinatario.

En KubeBolt Cloud, las recomendaciones de Kobi Autopilot no dependen de que estos canales estén activos. Cuando ninguno llevaría una recomendación lista, Autopilot la envía por correo a los admins de la organización, además de un resumen semanal de lo que sigue pendiente. Consulta KubeBolt Cloud.

UI de administración: Administration → System → Notifications (/admin/system, rol Admin) edita los canales y los ajustes globales, y envía una notificación de prueba a cada canal. Los valores guardados allí sobrescriben las variables de entorno; Reset to env defaults vuelve a ellas. Requiere tener la autenticación activada.

La mayoría de los cambios se aplican sin reiniciar. En la edición open source, tres esperan al siguiente reinicio: el primer canal en una instalación que arrancó sin ninguno, volver a activar el interruptor general cuando KubeBolt arrancó con él apagado, y activar las notificaciones de resueltos cuando arrancó con ellas desactivadas.