KubeBolt docs
ENES GitHub

Configuración

El agente

El agente opcional, solo de conexiones salientes, que habilita las métricas históricas, los flujos de red, los costos y el acceso a clústeres remotos.

En esta página
  1. El chart
  2. Versionado
  3. Memoria en un clúster grande

KubeBolt funciona solo con un kubeconfig. El agente es el siguiente paso opcional: un componente ligero que instalas en un clúster para habilitar las métricas históricas, los flujos de red de Hubble, los datos de costos y, para los clústeres a los que KubeBolt no llega, el túnel por el que viajan sus llamadas a la API. Se conecta solo hacia fuera por gRPC: el API server del clúster nunca queda expuesto, y eso es lo que hace viables los clústeres privados, detrás de un firewall o con la salida restringida.

El chart ejecuta hasta dos workloads, que se configuran en el asistente Add cluster:

El chart

El agente se distribuye como su propio chart OCI, que el asistente genera con los valores correctos:

helm install kubebolt-agent \
  oci://ghcr.io/clm-cloud-solutions/kubebolt/helm/kubebolt-agent \
  --namespace kubebolt-system --create-namespace \
  --set backendUrl=kubebolt-agent-ingest.kubebolt.svc.cluster.local:9090

Valores principales (consulta el values.yaml del chart para la referencia completa y comentada):

ValorPor defectoPara qué sirve
backendUrl(ninguno, obligatorio)Dónde se conecta el agente con su backend: un destino de conexión gRPC con la forma <host:port>, sin esquema. Dentro del clúster es el Service <release>-agent-ingest del chart de KubeBolt en el 9090, no el Service web
cluster.name / cluster.id(ninguno) / el UID de kube-systemCómo se registra y se muestra el clúster en KubeBolt
rbac.modereaderCuánto puede hacer la ServiceAccount del agente: metrics, reader u operator (detalles). reader y operator activan el túnel. Ejecuta operator solo con auth.mode configurado; el chart no lo impone
auth.modedisabledAutenticación con el backend: disabled, tokenreview (mismo clúster que el backend) o ingest-token (emitido en la UI de administración; obligatorio entre clústeres y en Cloud), con el token en auth.ingestToken.existingSecret
tls.*desactivadoTLS de transporte y mTLS opcional (paquete de CA, certificado de cliente, cambio del SNI)
hubble.*desactivadoRecogida de flujos de red desde un relay de Hubble existente, con su dirección y TLS
collectors.*(ninguno)Ajusta qué se recoge: dropNetworkInterfaces, exporters adicionales
opencost.*desactivadoInstala el subchart de OpenCost y hace scraping de él. Para un OpenCost que ya tengas, añádelo en collectors.exporters (detalles). Cualquiera de los dos junto con agent.promRead.cost.enabled hace fallar el render: una sola fuente de costo
agent.promRead.*desactivadoModo promread: url del endpoint, auth por proveedor, cost.enabled opcional y deployment.* para los recursos y la planificación (scheduling) de ese pod
agent.deferNodeStress / agent.deferNodeNetworkfalseDeja la carga/PSI, o la red del nodo, a un node-exporter al que ya haces scraping
scrape.*desactivadoSidecar de scrape vmagent opcional, con controles de relabeling y de descubrimiento
serviceAccount.annotations(ninguno)Identidad de nube para promread: el rol de IRSA o el binding de Workload Identity
resources10m/64Mi solicitados, 500m/256Mi de límite (100m/128Mi antes de la 1.4.10)Por pod del DaemonSet. Las requests siguen siendo pequeñas para que el agente quepa en nodos cargados. Los límites dejan sitio para las respuestas del API server que retransmite el agente: consulta Memoria en un clúster grande
tolerations / nodeSelector / affinitytolera todos los taintsDónde corre el DaemonSet. Restringe tolerations para mantenerlo fuera de pools dedicados
priority.*desactivadoUna PriorityClass para que el agente pueda desalojar pods en nodos llenos
gomemlimit90% del límite de memoria de cada contenedorFija en su lugar un objetivo de memoria de Go explícito
logLevelinfodebug, info, warn, error
image.tagla versión del chartFija la imagen del agente
extraEnv[]Variables del agente que no tienen un valor propio

Versionado

El agente sigue su propio ritmo de versiones (ahora mismo, la línea 1.4.x) sobre un esquema de métricas y etiquetas v1.0 estable. El esquema es el único contrato entre los dos lados, así que cualquier agente 1.x ≥ 1.0 funciona con cualquier backend de KubeBolt ≥ 1.10: actualiza cualquiera de los dos por separado dentro de esos límites. El agente 0.2.x emite el esquema previo al canónico y muestra paneles vacíos contra un backend moderno; el backend registra un WARN en el log cuando se conecta uno.

promRead es el único modo con una ventana más estrecha: llegó en el agente 1.1.0 junto con el backend 1.13.0. Sus muestras siguen llegando al almacén de métricas en los backends 1.10–1.12, pero la tarjeta de integración Prometheus (read) no se muestra ahí. Es un mínimo para un modo, no para el agente. La matriz completa, en Compatibilidad.

El changelog propio del agente recoge cada versión de su línea, sin las versiones del backend intermedias: packages/agent/CHANGELOG.md.

Actualiza con --reset-then-reuse-values (o con un archivo de valores) en lugar de --reuse-values, que conserva los valores por defecto del chart anterior, incluida la etiqueta de imagen del sidecar vmagent. Los pasos, en Compatibilidad → Cómo actualizar.

Desde la 2.7.0, KubeBolt avisa cuando el agente de un clúster está desactualizado, y lo juzga por el más antiguo de sus agentes conectados: Clusters, Fleet y Home lo muestran, y Kobi responde con el mismo comando helm upgrade. KubeBolt nunca ejecuta ese comando: el agente es tu release de Helm, a menudo gestionada con GitOps, y actualizarlo desde KubeBolt exigiría permisos de escritura sobre su DaemonSet. Consulta Multiclúster.

Postura de seguridad: conexiones solo salientes (gRPC, más HTTP remote_write cuando el sidecar de scrape está activo), sin puertos entrantes, se ejecuta como no root con un sistema de archivos raíz de solo lectura y, en configuraciones entre clústeres, se autentica con un token de ingesta de alcance limitado. Las métricas pasan por el backend: el agente nunca escribe directamente en el almacén de métricas.

Memoria en un clúster grande

En un clúster conectado a través de él (rbac.mode=reader u operator), el agente retransmite las respuestas del API server y guarda cada una entera mientras la envía. El backend pide las listas en páginas de 500 objetos, pero la primera conexión de un clúster grande sigue pasando decenas de MB por el agente.