Configuración
Variables de entorno
Todas las variables KUBEBOLT_* que un operador configura en la API y en el agente, agrupadas por área y con el valor por defecto del código para cada una.
En esta página
Esta página reúne todas las variables KUBEBOLT_* que un operador puede
configurar, en la API y en el agente, agrupadas por área.
Quedan fuera las que solo importan a la compilación multi-tenant de KubeBolt
Cloud. .env.example, en la raíz del repositorio, es la referencia comentada;
deploy/.env.example es su equivalente para Docker Compose.
El entorno es la base del arranque, no la última palabra. La mayoría de
estas variables tiene un campo equivalente en las páginas de
Administration. Un valor guardado allí se persiste y gana en cada lectura
posterior, así que la configuración como código sigue funcionando hasta que
alguien edita ese ajuste en la UI: a partir de entonces, la UI es la fuente de
verdad para ese ajuste. La mayoría de los cambios en la UI se aplican sin
reiniciar; las excepciones se señalan más abajo. Con
KUBEBOLT_AUTH_ENABLED=false no hay páginas de Administration y el entorno es
la única capa.
Los valores por defecto de abajo son los que usa el código cuando la variable no está definida. Cuando el chart de Helm o el archivo de Docker Compose fijan otro valor, la fila lo indica. Para ver qué recibió realmente la API en ejecución, abre Administration → System → Boot snapshot.
Flags y precedencia
El binario de la API acepta algunos flags. Ganan sobre todo lo demás; después
vienen el entorno del proceso, luego un archivo .env en el directorio de
trabajo (solo rellena huecos) y, por último, los valores por defecto del código.
| Flag | Por defecto | Qué hace |
|---|---|---|
--port | 8080 | Puerto HTTP: REST, WebSocket y, en el binario único, la UI |
--host | 0.0.0.0 | Dirección de escucha. El listener gRPC del agente también la usa, en el puerto 9090, salvo que KUBEBOLT_AGENT_GRPC_ADDR indique otra cosa |
--kubeconfig | $KUBECONFIG o, si no, ~/.kube/config | Kubeconfig que se carga. Si no hay archivo ahí y hay una ServiceAccount montada, la API usa la configuración in-cluster |
--metric-interval | 30 | Segundos entre consultas a Metrics Server |
--insight-interval | 60 | Segundos entre evaluaciones de insights |
--reset-admin-password | (ninguno) | Establece la contraseña del admin y sale |
Núcleo
| Variable | Por defecto | Qué hace |
|---|---|---|
KUBEBOLT_DATA_DIR | ./data | Dónde vive la BoltDB embebida: usuarios, tokens, ajustes, registro de agentes, historial de insights, conversaciones de Kobi. Monta aquí un volumen persistente. Solo se abre con la autenticación activada. No se puede configurar desde la UI |
KUBEBOLT_CORS_ORIGINS | http://localhost:3000,http://localhost:5173 | Orígenes permitidos, separados por comas. Obligatoria cuando la UI se sirve desde un origen distinto al de la API. Admite comodines |
KUBEBOLT_DISPLAY_NAME | KubeBolt | Etiqueta en la barra superior y en el título del navegador, para distinguir instalaciones |
KUBEBOLT_LOG_LEVEL | info | debug, info, warn, error |
KUBEBOLT_LOG_FORMAT | text | text o json |
KUBEBOLT_LOG_DIR | (ninguno) | Si se define, los logs también se escriben en kubebolt.log dentro de ese directorio |
KUBEBOLT_UPDATE_CHECK_ENABLED | true | Consulta periódica a la API de releases de GitHub. Ponla en false en entornos aislados (air-gapped) |
KUBEBOLT_CACHE_SYNC_TIMEOUT_SECONDS | 45 | Cuánto puede pasar la sincronización de las cachés de los informers, en una conexión en frío, sin recibir nada antes de fallar. Si sigue recibiendo páginas continúa, hasta 10 minutos. Mínimo: 5 |
KUBEBOLT_DEFAULT_REFRESH_INTERVAL_SECONDS | 30 | Cadencia de refresco de la UI por defecto. Uno de 5, 10, 15, 30, 60, 120 |
KUBEBOLT_PROD_NAMESPACE_PATTERN | namespaces llamados prod, production o prd, solos o con un sufijo - o _ | Expresión regular que marca un namespace como de producción: revelar un Secret ahí exige el rol admin; en el resto basta con editor |
Almacén de métricas
Dónde vive el historial. Los detalles, y los valores del chart para el VictoriaMetrics incluido, en Métricas.
| Variable | Por defecto | Qué hace |
|---|---|---|
KUBEBOLT_METRICS_STORAGE_URL | http://localhost:8428 | URL base de VictoriaMetrics. Si no se define y nada responde ahí al arrancar, la API no guarda historial y lo indica en su log. El chart de Helm y Docker Compose siempre la definen |
KUBEBOLT_METRICS_STORAGE_TOKEN | (ninguno) | Token bearer para un almacén que lo exija. Tiene prioridad sobre la autenticación básica |
KUBEBOLT_METRICS_STORAGE_USERNAME · _PASSWORD | (ninguno) | Autenticación básica para el almacén. También sirven las credenciales escritas en la URL |
KUBEBOLT_METRICS_RETENTION | 30d | Solo Docker Compose: el --retentionPeriod del VictoriaMetrics incluido. Con Helm es metrics.storage.embedded.retention |
Ninguna de estas se puede cambiar desde la UI.
Autenticación
Contexto completo en Autenticación.
| Variable | Por defecto | Qué hace |
|---|---|---|
KUBEBOLT_AUTH_ENABLED | true | Ponla en false solo cuando el acceso ya esté restringido en la capa de red. Desactivada, no hay almacén embebido: ni páginas de Administration, ni ajustes guardados, ni historial de insights, ni hallazgos de seguridad, ni conversaciones de Kobi, ni conectores de nube |
KUBEBOLT_ADMIN_PASSWORD | generada automáticamente | Fija la contraseña inicial del admin en el primer arranque. Se ignora una vez que el admin existe |
KUBEBOLT_RESET_ADMIN_PASSWORD | (ninguno) | Restablece la contraseña del admin en el siguiente arranque y luego sigue arrancando. Se lee antes que .env, así que tiene que ser una variable de entorno real. Bórrala después |
KUBEBOLT_JWT_SECRET | generada automáticamente y persistida | Clave de firma. Un valor proporcionado por el operador de menos de 32 bytes hace fallar el arranque a propósito |
KUBEBOLT_JWT_EXPIRY | 15m | Duración del token de acceso |
KUBEBOLT_JWT_REFRESH_EXPIRY | 168h | Duración del token de refresco (7 días) |
Las dos duraciones de JWT se pueden editar en Administration → Access → Authentication, pero necesitan un reinicio, porque el servicio JWT se configura al arrancar. La UI lo indica.
IA y Kobi
El conjunto completo, y sus equivalentes en Helm, están en Activar Kobi.
| Variable | Por defecto | Qué hace |
|---|---|---|
KUBEBOLT_AI_API_KEY | (ninguno) | Este es el interruptor. Kobi está apagado cuando no hay ni esta variable ni una clave guardada en Administration → AI (Kobi) → Configuration |
KUBEBOLT_AI_PROVIDER | anthropic | anthropic u openai (los dos únicos valores); cualquier API compatible con OpenAI usa openai |
KUBEBOLT_AI_MODEL | claude-haiku-5-5 · gpt-4o | El valor por defecto del proveedor cuando no se define |
KUBEBOLT_AI_BASE_URL | el del proveedor | URL completa del endpoint, que se usa tal cual: para APIs compatibles con OpenAI debe terminar en /chat/completions |
KUBEBOLT_AI_MAX_TOKENS | según el modelo | Tope por respuesta: 16384 cuando el razonamiento consume parte de ese tope, 4096 en el resto |
KUBEBOLT_AI_MAX_ROUNDS | 20 | Rondas de llamadas a herramientas por respuesta. Limitado a 2–40 |
KUBEBOLT_AI_CACHE_TTL | 1h | Solo Anthropic: cuánto vive en caché el prefijo del prompt. 5m vuelve a la caché corta de la API, más barata cuando las preguntas son sueltas |
KUBEBOLT_AI_FALLBACK_API_KEY | (ninguno) | Definirla activa el proveedor de respaldo. _PROVIDER toma por defecto el del principal; _MODEL y _BASE_URL son opcionales |
KUBEBOLT_AI_ESCALATION_MODEL | (ninguno) | Definirla activa el modelo de escalamiento. _PROVIDER toma por defecto el del principal y, con el mismo proveedor, también _API_KEY y _BASE_URL |
KUBEBOLT_AI_ACTIONS_ENABLED | true | Interruptor general de las herramientas de acción propose_* |
KUBEBOLT_AI_DESTRUCTIVE_ACTIONS_ENABLED | true | Habilita o bloquea el borrado y el escalado a cero |
KUBEBOLT_AI_ACTION_PROGRESS_TIMEOUT | 90s | Cuánto tiempo consulta la UI una acción ejecutada hasta que converge. Mínimo: 10s |
KUBEBOLT_AI_AUTO_COMPACT | true | Condensa los turnos antiguos en un resumen a medida que se llena el contexto |
KUBEBOLT_AI_AUTO_COMPACT_THRESHOLD | 0.80 | Fracción del presupuesto a la que se dispara la compactación. Debe estar entre 0 y 1 |
KUBEBOLT_AI_SESSION_BUDGET_TOKENS | ventana de contexto del modelo | El presupuesto con el que se compara la compactación |
KUBEBOLT_AI_COMPACT_MODEL | claude-haiku-5-5 · gpt-4o-mini | Modelo que escribe el resumen. Defínelo para cualquier endpoint que no sea de OpenAI |
KUBEBOLT_AI_COMPACT_PRESERVE_TURNS | 3 | Turnos que se conservan intactos tras condensar |
KUBEBOLT_AI_SHOW_TOOL_CALLS | true | Muestra cada llamada a herramienta como una tarjeta en el panel |
Conectores de nube
Consulta Conectores de nube. Necesitan la autenticación activada: sin el almacén embebido no hay dónde guardar un conector.
| Variable | Por defecto | Qué hace |
|---|---|---|
KUBEBOLT_MCP_CONNECTORS | activado | false quita la pestaña Connectors y las herramientas de nube |
KUBEBOLT_MCP_AWS_PRINCIPAL_ARN | (ninguno) | La identidad de AWS con la que corre KubeBolt, que aparece en la política de confianza (trust policy) de la guía de configuración |
KUBEBOLT_MCP_AZMCP_URL | http://127.0.0.1:5001/ | Dónde escucha el sidecar de Azure MCP Server. Solo loopback |
KUBEBOLT_MCP_TOOL_TIMEOUT | 30s | Tiempo límite por llamada, como duración de Go o en segundos. La primera llamada de AWS en una sesión tarda 9–12 s |
Notificaciones
Consulta Notificaciones, incluido qué cambios hechos en la UI esperan a un reinicio.
| Variable | Por defecto | Qué hace |
|---|---|---|
KUBEBOLT_NOTIFICATIONS_ENABLED | true | Interruptor general. false silencia todos los canales sin borrar su configuración |
KUBEBOLT_NOTIFICATIONS_MIN_SEVERITY | warning | critical, warning, info. Un valor no válido vuelve a warning |
KUBEBOLT_NOTIFICATIONS_COOLDOWN | 1h | Ventana de deduplicación para el mismo insight en el mismo clúster |
KUBEBOLT_NOTIFICATIONS_INCLUDE_RESOLVED | false | Notifica también cuando un insight se resuelve |
KUBEBOLT_NOTIFICATIONS_BASE_URL | (ninguno) | URL pública con la que se construyen los enlaces dentro de los mensajes |
KUBEBOLT_SLACK_WEBHOOK_URL · KUBEBOLT_DISCORD_WEBHOOK_URL | (ninguno) | Configurar una URL activa ese canal |
KUBEBOLT_SLACK_ENABLED · KUBEBOLT_DISCORD_ENABLED · KUBEBOLT_EMAIL_ENABLED | true | Pausa un canal sin borrar su destino |
KUBEBOLT_SMTP_HOST · _USERNAME · _PASSWORD · _FROM · _TO | (ninguno) | El correo necesita host, remitente y al menos un destinatario para contar como configurado. _TO va separado por comas |
KUBEBOLT_SMTP_PORT | 587 | STARTTLS cuando el servidor lo ofrece; 465 usa TLS implícito |
KUBEBOLT_SMTP_DIGEST_MODE | instant | instant, hourly, daily |
KUBEBOLT_NOTIFICATIONS_BURST_THRESHOLD | 5 | Insights que un clúster abre dentro de la ventana y que se convierten en un solo mensaje. 2–1000 |
KUBEBOLT_NOTIFICATIONS_BURST_WINDOW | 60s | Hasta dónde mira hacia atrás ese conteo. De 10 s a 1 h |
KUBEBOLT_NOTIFICATIONS_BURST_QUIET | 30s | El resumen sale cuando el clúster lleva este tiempo en calma. De 5 s a 10 min, nunca más que la espera máxima |
KUBEBOLT_NOTIFICATIONS_BURST_MAX_WAIT | 5m | Una ráfaga que no se calma recibe un resumen parcial still going con esta frecuencia. De 30 s a 1 h |
KUBEBOLT_NOTIFICATIONS_DIGEST_LIST_LIMIT | 20 | Un resumen horario o diario con más insights que este número se envía como resumen agrupado. De 1 a 500 |
Ingesta de agentes
El canal entre el agente y el backend. Los valores por defecto son permisivos para que una instalación nueva arranque y después se pueda cerrar desde Administration → Agents & Ingest → Configuration.
| Variable | Por defecto | Qué hace |
|---|---|---|
KUBEBOLT_AGENT_GRPC_ADDR | <--host>:9090 | Dónde escucha el listener gRPC |
KUBEBOLT_AGENT_AUTH_MODE | disabled | disabled, permissive, enforced. Requiere reinicio |
KUBEBOLT_AGENT_TOKEN_AUDIENCE | kubebolt-backend | Audiencia esperada en los tokens de agente. Requiere reinicio |
KUBEBOLT_AGENT_TLS_CERT_FILE · _TLS_KEY_FILE | (ninguno) | Certificado y clave del servidor para el canal gRPC. Los dos o ninguno; sin definir, el canal va en texto plano |
KUBEBOLT_AGENT_TLS_CLIENT_CA | (ninguno) | Paquete de CA que verifica los certificados de cliente de los agentes cuando presentan uno |
KUBEBOLT_AGENT_REQUIRE_MTLS | false | Rechaza los agentes sin un certificado de cliente verificado. Necesita _TLS_CLIENT_CA. Requiere reinicio |
KUBEBOLT_AGENT_INGEST_URL | (ninguno) | host:port externo al que se conectan los agentes remotos. Definirla marca la instalación como alojada (hosted) y cambia los valores por defecto del asistente |
KUBEBOLT_AGENT_AUTOREGISTER_CLUSTERS | false (el chart de Helm pone true) | Añade un clúster al selector cuando su agente se conecta. Desactivada, el agente envía métricas pero su clúster no aparece en el selector |
KUBEBOLT_AGENT_REGISTRY_PRUNE_HORIZON | 24h | Cuándo se elimina el registro de un agente obsoleto |
KUBEBOLT_AGENT_RATE_LIMIT_ENABLED | false | Límite de tasa para toda la flota en el canal de ingesta |
KUBEBOLT_AGENT_RATE_LIMIT_RPS · _BURST | 1000 · 2000 | Su tasa y su ráfaga |
KUBEBOLT_AGENT_TUNNEL_IDLE_TIMEOUT | 5m | Los túneles inactivos (exec, port-forward) se cierran pasado este tiempo. 0 desactiva el watchdog |
KUBEBOLT_AGENT_PROXY_CONNECT_TIMEOUT | 60s (25s antes de la 2.6.7) | Cuánto puede pasar una conexión en frío a través de un agente sin recibir nada antes de fallar. Si sigue recibiendo páginas continúa, hasta 10 minutos |
KUBEBOLT_AGENT_PROXY_STUCK_TIMEOUT | 45s | Watchdog de agentes atascados. 0 lo desactiva |
KUBEBOLT_AGENT_PROXY_REQUEST_TIMEOUT | 30s | Plazo por petición a través del túnel |
KUBEBOLT_AGENT_MAX_MSG_BYTES | 67108864 (64 MiB) | Mensaje gRPC más grande en el canal. Los clústeres grandes envían respuestas de la API de más de 4 MiB. Mantenlo igual que el del agente |
Los tres timeouts del proxy aceptan 5–600 s; un valor fuera de ese rango conserva el valor por defecto. Desde la 2.6.7, el de conexión y el de agentes atascados nunca se aplican por debajo del timeout por petición + 5 s (35 s con los 30 s por defecto): un valor menor se sube, la API lo deja en el log y Settings › Agents & Ingest muestra el valor que corre. Los archivos TLS solo se leen al arrancar.
KUBEBOLT_AGENT_PROXY_CONNECT_TIMEOUT mide silencio desde la 2.6.5: un
clúster grande que sigue recibiendo páginas ya no se corta por ella. Súbela
solo si un clúster muestra «Cluster unreachable» mientras todavía se está
sincronizando: consulta
Solución de problemas. Es un instrumento tosco:
también afloja la protección que existe para los agentes realmente bloqueados.
Ingesta de métricas
El receptor de remote_write de Prometheus. Consulta
Métricas.
| Variable | Por defecto | Qué hace |
|---|---|---|
KUBEBOLT_REMOTE_WRITE_ENABLED | false | Acepta remote_write de Prometheus en /api/v1/prom/write. Desactivada, la ruta responde 404 |
KUBEBOLT_REMOTE_WRITE_AUTH_MODE | disabled | disabled, permissive, enforced |
KUBEBOLT_PROM_WRITE_DEFAULT_SAMPLES_PER_SEC | 10000 | Tasa de muestras por tenant |
KUBEBOLT_PROM_WRITE_DEFAULT_BURST_SAMPLES | 100000 | Su ráfaga |
KUBEBOLT_PROM_WRITE_DEFAULT_MAX_ACTIVE_SERIES | 1000000 | Tope de series activas por tenant |
KUBEBOLT_PROM_WRITE_DEFAULT_MAX_ACTIVE_SERIES_GLOBAL | 0 (desactivado) | Tope para toda la instalación |
KUBEBOLT_PROM_WRITE_ALLOW_CUSTOM_SERIES | false (Docker Compose pone true) | false descarta toda serie fuera de las familias de métricas propias de KubeBolt; true conserva también las métricas de tus aplicaciones |
KUBEBOLT_PROM_WRITE_NAME_FILTER_ENABLED | true | false se salta esa clasificación por completo y lo reenvía todo |
Retención
Una pasada por hora, por organización; los valores _HORIZON se vuelven a
leer del entorno en cada pasada. Las duraciones son duraciones de Go. Los
insights activos nunca caducan, y los episodios en curso (firing) tampoco. El
historial de métricas tiene su propia retención, que se configura en el
almacén de métricas.
| Variable | Por defecto | Qué acota |
|---|---|---|
KUBEBOLT_INSIGHTS_RETENTION_HORIZON | 168h (7 días) | Registros de insights resueltos (uno por fingerprint). Los episodios siguen el horizonte de hallazgos de abajo |
KUBEBOLT_INSIGHT_EXPIRE_TTL | 15m | Un episodio en curso sin señal durante más tiempo pasa a expired en lugar de quedarse activo para siempre después de que un agente se va |
KUBEBOLT_FINDINGS_RETENTION_HORIZON | 720h (30 días) | Hallazgos de seguridad resueltos (los activos nunca caducan), eventos de runtime y episodios de insights |
KUBEBOLT_AUDIT_RETENTION_HORIZON | 2160h (90 días) | El registro de auditoría de mutaciones y accesos |
KUBEBOLT_COPILOT_CONVERSATION_RETENTION_HORIZON | 2160h (90 días) | Transcripciones de Kobi: el almacén con más datos personales (PII) del producto |
KUBEBOLT_COPILOT_CONVERSATION_MAX_PER_USER | 200 | Conversaciones que se guardan por usuario |
En Cloud no las configuras tú: la retención es una dimensión del plan, detallada en Seguridad y cumplimiento.
Automonitoreo
La API puede enviar una segunda copia de sus propias series de salud (HTTP, tareas en segundo plano, llamadas a VictoriaMetrics, WebSocket, canales de agentes, proceso) a un Prometheus fuera de la instalación, para que una caída de la API o de su almacén siga siendo visible en algún sitio. Solo salen series de plataforma: ningún identificador de clúster ni de tenant, nada de Kobi. Desactivado salvo que se defina la URL.
| Variable | Por defecto | Qué hace |
|---|---|---|
KUBEBOLT_EXTERNAL_METRICS_URL | (ninguno) | Endpoint de remote_write, por ejemplo el de Grafana Cloud |
KUBEBOLT_EXTERNAL_METRICS_USER · _TOKEN | (ninguno) | Usuario y contraseña de autenticación básica para ese endpoint |
KUBEBOLT_EXTERNAL_METRICS_LABELS | (ninguno) | Etiquetas extra en cada serie, como key=value,key=value, para distinguir instalaciones |
KUBEBOLT_EXTERNAL_METRICS_INTERVAL | 60s | Intervalo de envío. Los valores por debajo de 15s se ignoran |
Un Prometheus propio también puede hacer scraping del endpoint /metrics de la
API, y metrics.alertRules.enabled del chart incluye reglas de alerta para él
como un PrometheusRule.
Agente
El agente lee sus propias variables. El chart del agente
las escribe a partir de sus valores, así que tú configuras el valor; donde no lo
hay, usa extraEnv del chart del agente.
| Variable | Valor del chart | Por defecto | Qué hace |
|---|---|---|---|
KUBEBOLT_BACKEND_URL | backendUrl | localhost:9090 (el chart la exige) | Destino de conexión gRPC, host:port, sin esquema |
KUBEBOLT_AGENT_MODE | se fija por workload | sin definir, lo ejecuta todo | daemonset en los pods del DaemonSet, promread en el Deployment de lectura de tu Prometheus |
KUBEBOLT_AGENT_CLUSTER_NAME | cluster.name | (ninguno) | El nombre con el que se registra el clúster |
KUBEBOLT_AGENT_CLUSTER_ID | cluster.id | el UID del namespace kube-system | Cámbialo solo para conservar un ID que usaba una instalación antigua |
KUBEBOLT_AGENT_LOG_LEVEL | logLevel | info | debug, info, warn, error |
KUBEBOLT_AGENT_PROXY_ENABLED | derivado de rbac.mode | false | Transporta el túnel de la API. El chart lo activa para reader y operator |
KUBEBOLT_AGENT_AUTH_MODE · _TOKEN_FILE | auth.mode, auth.ingestToken.*, auth.tokenReview.* | sin credenciales | tokenreview o ingest-token, y el token montado |
KUBEBOLT_AGENT_TLS_ENABLED · _TLS_CA_FILE · _TLS_CERT_FILE · _TLS_KEY_FILE · _TLS_SERVER_NAME | tls.* | texto plano | TLS hacia el backend. Un certificado de cliente añade mTLS |
KUBEBOLT_AGENT_MAX_MSG_BYTES | extraEnv | 67108864 (64 MiB) | Mensaje gRPC más grande. Mantenlo igual que el de la API |
KUBEBOLT_HUBBLE_ENABLED | hubble.enabled | true en el binario, false en el chart | Colector de flujos de Hubble |
KUBEBOLT_HUBBLE_RELAY_ADDR | hubble.relay.address | hubble-relay.kube-system.svc.cluster.local:80 | Relay de Hubble del que se leen los flujos |
KUBEBOLT_HUBBLE_RELAY_CA_FILE · _CERT_FILE · _KEY_FILE · _SERVER_NAME | hubble.relay.tls.* | texto plano | TLS o mTLS hacia el relay |
KUBEBOLT_AGENT_DROP_NET_INTERFACES | collectors.dropNetworkInterfaces | ninguna en el binario; el chart excluye los dispositivos de túnel, los pares veth de cada pod y lo | Interfaces que quedan fuera de container_network_*. Un * final hace coincidencia por prefijo |
KUBEBOLT_AGENT_EXPORTERS | collectors.exporters, opencost.* | (ninguno) | Exporters de Prometheus adicionales, como pares name=url. Un solo pod del clúster hace scraping de cada uno |
KUBEBOLT_AGENT_DEFER_NODE_NETWORK · _DEFER_NODE_STRESS | agent.deferNodeNetwork, agent.deferNodeStress | false | Deja la red del nodo, o la carga y PSI, a un node-exporter al que ya haces scraping. El chart pone las dos cuando su scrape de node-exporter está activado |
KUBEBOLT_AGENT_PROMREAD_* | agent.promRead.* | desactivado | Modo de lectura desde Prometheus: URL, autenticación, intervalo de consulta, step, lookback, matchers, costo |
KUBEBOLT_TENANT_ID | tenant.id | (ninguno) | Déjala vacía: el backend toma el tenant del token de ingesta |
GOMEMLIMIT | gomemlimit | 90% del límite de memoria de cada contenedor | Objetivo de memoria de Go |
KUBEBOLT_AGENT_MEMORY_LIMIT_BYTES | se toma de resources.limits.memory | (ninguno) | El límite de memoria del contenedor. Cada cuerpo que retransmite el agente tiene un tope de una cuarta parte de él, nunca por encima de 63 MiB (detalles) |
Desarrollo y vías de escape
| Variable | Por defecto | Qué hace |
|---|---|---|
KUBEBOLT_WATCHLIST_CLIENT | false | true recupera el listado inicial en streaming de client-go. Solo para instalaciones que nunca llegan a un clúster a través de un agente: por el túnel trunca las cachés sin avisar |
KUBEBOLT_AI_DEBUG | (ninguno) | Heredada. 1 fuerza KUBEBOLT_LOG_LEVEL=debug |
KUBEBOLT_AGENT_PPROF_ADDR | (ninguno) | Solo en el agente. Sirve /debug/pprof en esa dirección; usa 127.0.0.1:6060 con kubectl port-forward |
Cómo configurarlas
Con Helm, estos valores del chart escriben las variables por ti:
| Valor del chart | Variables |
|---|---|
auth.* | KUBEBOLT_AUTH_ENABLED, KUBEBOLT_ADMIN_PASSWORD, KUBEBOLT_JWT_SECRET, KUBEBOLT_RESET_ADMIN_PASSWORD, y KUBEBOLT_DATA_DIR en el volumen del chart |
copilot.*, con copilot.enabled=true | KUBEBOLT_AI_PROVIDER, _MODEL, _BASE_URL, _MAX_TOKENS, _CACHE_TTL, _API_KEY, _FALLBACK_*, _ESCALATION_MODEL |
mcpConnectors.* | KUBEBOLT_MCP_CONNECTORS, KUBEBOLT_MCP_AWS_PRINCIPAL_ARN |
agentIngest.* | KUBEBOLT_AGENT_GRPC_ADDR, _AUTH_MODE, _TOKEN_AUDIENCE, _INGEST_URL, _AUTOREGISTER_CLUSTERS, _RATE_LIMIT_*, _TLS_*, _REQUIRE_MTLS |
metrics.storage.* | KUBEBOLT_METRICS_STORAGE_URL y sus credenciales |
metrics.remoteWrite.* | KUBEBOLT_REMOTE_WRITE_ENABLED, KUBEBOLT_REMOTE_WRITE_AUTH_MODE |
Para todo lo que no tenga uno, usa la vía de escape del chart en lugar de esperar a un cambio en las plantillas:
extraEnv:
- name: KUBEBOLT_FINDINGS_RETENTION_HORIZON
value: "2160h"
- name: KUBEBOLT_AGENT_PROXY_CONNECT_TIMEOUT
value: "90s"
Con Docker Compose, copia deploy/.env.example a deploy/.env y edítalo.
Compose solo pasa al contenedor las variables listadas en environment: dentro
de deploy/docker-compose.yml. El logging, los canales de notificación y el
modo de autenticación del agente no están entre ellas: añade una línea ahí o,
para los dos últimos, configúralos en las páginas de Administration.
Si ejecutas el binario, ponlas en un archivo .env en el directorio desde el
que lo arrancas. Las variables de entorno del sistema tienen prioridad sobre el
archivo: este solo rellena huecos.