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
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.
- Slack: mensajes con Block Kit, con una barra de color según la severidad y un botón que enlaza directamente al recurso en KubeBolt.
- Discord: mensajes embed con un formato equivalente.
- Correo (SMTP): texto plano y HTML en un mismo mensaje, con tres modos de envío:
instant(el valor por defecto), resumenhourlyo resumendaily. Admite varios destinatarios.
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:
- Un solo resumen. Cuando un clúster abre 5 o más insights en 60 segundos,
Slack, Discord y el correo
instantreciben un único mensaje que los resume, en cuanto el clúster lleva 30 segundos en calma. Una ráfaga que no se calma recibe un resumen parcial still going cada 5 minutos como mucho. - Qué contiene. El conteo por severidad, cada insight crítico con su nombre (hasta 10, cada uno con su enlace) y cada regla con su conteo y los namespaces más afectados. Los primeros insights, enviados antes de que la ráfaga estuviera clara, se cuentan y se marcan.
- Por debajo del umbral, cada insight se sigue enviando en el momento en que se detecta.
- Resúmenes por correo. Un resumen
hourlyodailycon más de 20 insights se agrupa de la misma forma.
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:
| Ajuste | Por defecto | Rango |
|---|---|---|
Burst threshold (KUBEBOLT_NOTIFICATIONS_BURST_THRESHOLD) | 5 insights | 2–1000 |
Window (_BURST_WINDOW) | 60 s | de 10 s a 1 h |
Quiet before sending (_BURST_QUIET) | 30 s | de 5 s a 10 min, nunca más que Longest wait |
Longest wait (_BURST_MAX_WAIT) | 5 min | de 30 s a 1 h |
Digest: list up to (KUBEBOLT_NOTIFICATIONS_DIGEST_LIST_LIMIT) | 20 insights | 1–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 entorno | Por defecto | Para qué sirve |
|---|---|---|
KUBEBOLT_NOTIFICATIONS_ENABLED | true | Interruptor general: ponlo en false durante las ventanas de mantenimiento. |
KUBEBOLT_NOTIFICATIONS_MIN_SEVERITY | warning | Los insights por debajo de este umbral no notifican. Valores: critical, warning, info. |
KUBEBOLT_NOTIFICATIONS_COOLDOWN | 1h | Ventana 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_RESOLVED | false | Notifica también cuando un insight pasa a resuelto. |
KUBEBOLT_SLACK_ENABLED · KUBEBOLT_DISCORD_ENABLED · KUBEBOLT_EMAIL_ENABLED | true | Pausa 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:
- Clústeres conectados con agente (
rbac.mode=readeruoperator): se evalúan desde que su agente se conecta, los abra alguien o no, mientras el agente siga conectado. Lo mismo vale para el clúster en el que corre el propio KubeBolt. - Contextos de kubeconfig: se evalúan mientras están abiertos, y siguen evaluándose en segundo plano durante 30 minutos después de que cambias a otro (hasta ocho a la vez). Un contexto que nadie ha abierto desde que KubeBolt arrancó no se evalúa.
- Clústeres solo de métricas: no tienen vistas de recursos que evaluar, así que no generan insights.
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.