KubeBolt docs
ENES GitHub

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
  1. Flags y precedencia
  2. Núcleo
  3. Almacén de métricas
  4. Autenticación
  5. IA y Kobi
  6. Conectores de nube
  7. Notificaciones
  8. Ingesta de agentes
  9. Ingesta de métricas
  10. Retención
  11. Automonitoreo
  12. Agente
  13. Desarrollo y vías de escape
  14. Cómo configurarlas

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.

FlagPor defectoQué hace
--port8080Puerto HTTP: REST, WebSocket y, en el binario único, la UI
--host0.0.0.0Direcció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/configKubeconfig que se carga. Si no hay archivo ahí y hay una ServiceAccount montada, la API usa la configuración in-cluster
--metric-interval30Segundos entre consultas a Metrics Server
--insight-interval60Segundos entre evaluaciones de insights
--reset-admin-password(ninguno)Establece la contraseña del admin y sale

Núcleo

VariablePor defectoQué hace
KUBEBOLT_DATA_DIR./dataDó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_ORIGINShttp://localhost:3000,http://localhost:5173Orígenes permitidos, separados por comas. Obligatoria cuando la UI se sirve desde un origen distinto al de la API. Admite comodines
KUBEBOLT_DISPLAY_NAMEKubeBoltEtiqueta en la barra superior y en el título del navegador, para distinguir instalaciones
KUBEBOLT_LOG_LEVELinfodebug, info, warn, error
KUBEBOLT_LOG_FORMATtexttext 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_ENABLEDtrueConsulta periódica a la API de releases de GitHub. Ponla en false en entornos aislados (air-gapped)
KUBEBOLT_CACHE_SYNC_TIMEOUT_SECONDS45Cuá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_SECONDS30Cadencia de refresco de la UI por defecto. Uno de 5, 10, 15, 30, 60, 120
KUBEBOLT_PROD_NAMESPACE_PATTERNnamespaces 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.

VariablePor defectoQué hace
KUBEBOLT_METRICS_STORAGE_URLhttp://localhost:8428URL 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_RETENTION30dSolo 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.

VariablePor defectoQué hace
KUBEBOLT_AUTH_ENABLEDtruePonla 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_PASSWORDgenerada automáticamenteFija 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_SECRETgenerada automáticamente y persistidaClave de firma. Un valor proporcionado por el operador de menos de 32 bytes hace fallar el arranque a propósito
KUBEBOLT_JWT_EXPIRY15mDuración del token de acceso
KUBEBOLT_JWT_REFRESH_EXPIRY168hDuració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.

VariablePor defectoQué 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_PROVIDERanthropicanthropic u openai (los dos únicos valores); cualquier API compatible con OpenAI usa openai
KUBEBOLT_AI_MODELclaude-haiku-5-5 · gpt-4oEl valor por defecto del proveedor cuando no se define
KUBEBOLT_AI_BASE_URLel del proveedorURL completa del endpoint, que se usa tal cual: para APIs compatibles con OpenAI debe terminar en /chat/completions
KUBEBOLT_AI_MAX_TOKENSsegún el modeloTope por respuesta: 16384 cuando el razonamiento consume parte de ese tope, 4096 en el resto
KUBEBOLT_AI_MAX_ROUNDS20Rondas de llamadas a herramientas por respuesta. Limitado a 2–40
KUBEBOLT_AI_CACHE_TTL1hSolo 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_ENABLEDtrueInterruptor general de las herramientas de acción propose_*
KUBEBOLT_AI_DESTRUCTIVE_ACTIONS_ENABLEDtrueHabilita o bloquea el borrado y el escalado a cero
KUBEBOLT_AI_ACTION_PROGRESS_TIMEOUT90sCuánto tiempo consulta la UI una acción ejecutada hasta que converge. Mínimo: 10s
KUBEBOLT_AI_AUTO_COMPACTtrueCondensa los turnos antiguos en un resumen a medida que se llena el contexto
KUBEBOLT_AI_AUTO_COMPACT_THRESHOLD0.80Fracción del presupuesto a la que se dispara la compactación. Debe estar entre 0 y 1
KUBEBOLT_AI_SESSION_BUDGET_TOKENSventana de contexto del modeloEl presupuesto con el que se compara la compactación
KUBEBOLT_AI_COMPACT_MODELclaude-haiku-5-5 · gpt-4o-miniModelo que escribe el resumen. Defínelo para cualquier endpoint que no sea de OpenAI
KUBEBOLT_AI_COMPACT_PRESERVE_TURNS3Turnos que se conservan intactos tras condensar
KUBEBOLT_AI_SHOW_TOOL_CALLStrueMuestra 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.

VariablePor defectoQué hace
KUBEBOLT_MCP_CONNECTORSactivadofalse 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_URLhttp://127.0.0.1:5001/Dónde escucha el sidecar de Azure MCP Server. Solo loopback
KUBEBOLT_MCP_TOOL_TIMEOUT30sTiempo 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.

VariablePor defectoQué hace
KUBEBOLT_NOTIFICATIONS_ENABLEDtrueInterruptor general. false silencia todos los canales sin borrar su configuración
KUBEBOLT_NOTIFICATIONS_MIN_SEVERITYwarningcritical, warning, info. Un valor no válido vuelve a warning
KUBEBOLT_NOTIFICATIONS_COOLDOWN1hVentana de deduplicación para el mismo insight en el mismo clúster
KUBEBOLT_NOTIFICATIONS_INCLUDE_RESOLVEDfalseNotifica 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_ENABLEDtruePausa 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_PORT587STARTTLS cuando el servidor lo ofrece; 465 usa TLS implícito
KUBEBOLT_SMTP_DIGEST_MODEinstantinstant, hourly, daily
KUBEBOLT_NOTIFICATIONS_BURST_THRESHOLD5Insights que un clúster abre dentro de la ventana y que se convierten en un solo mensaje. 2–1000
KUBEBOLT_NOTIFICATIONS_BURST_WINDOW60sHasta dónde mira hacia atrás ese conteo. De 10 s a 1 h
KUBEBOLT_NOTIFICATIONS_BURST_QUIET30sEl 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_WAIT5mUna 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_LIMIT20Un 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.

VariablePor defectoQué hace
KUBEBOLT_AGENT_GRPC_ADDR<--host>:9090Dónde escucha el listener gRPC
KUBEBOLT_AGENT_AUTH_MODEdisableddisabled, permissive, enforced. Requiere reinicio
KUBEBOLT_AGENT_TOKEN_AUDIENCEkubebolt-backendAudiencia 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_MTLSfalseRechaza 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_CLUSTERSfalse (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_HORIZON24hCuándo se elimina el registro de un agente obsoleto
KUBEBOLT_AGENT_RATE_LIMIT_ENABLEDfalseLímite de tasa para toda la flota en el canal de ingesta
KUBEBOLT_AGENT_RATE_LIMIT_RPS · _BURST1000 · 2000Su tasa y su ráfaga
KUBEBOLT_AGENT_TUNNEL_IDLE_TIMEOUT5mLos túneles inactivos (exec, port-forward) se cierran pasado este tiempo. 0 desactiva el watchdog
KUBEBOLT_AGENT_PROXY_CONNECT_TIMEOUT60s (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_TIMEOUT45sWatchdog de agentes atascados. 0 lo desactiva
KUBEBOLT_AGENT_PROXY_REQUEST_TIMEOUT30sPlazo por petición a través del túnel
KUBEBOLT_AGENT_MAX_MSG_BYTES67108864 (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.

VariablePor defectoQué hace
KUBEBOLT_REMOTE_WRITE_ENABLEDfalseAcepta remote_write de Prometheus en /api/v1/prom/write. Desactivada, la ruta responde 404
KUBEBOLT_REMOTE_WRITE_AUTH_MODEdisableddisabled, permissive, enforced
KUBEBOLT_PROM_WRITE_DEFAULT_SAMPLES_PER_SEC10000Tasa de muestras por tenant
KUBEBOLT_PROM_WRITE_DEFAULT_BURST_SAMPLES100000Su ráfaga
KUBEBOLT_PROM_WRITE_DEFAULT_MAX_ACTIVE_SERIES1000000Tope de series activas por tenant
KUBEBOLT_PROM_WRITE_DEFAULT_MAX_ACTIVE_SERIES_GLOBAL0 (desactivado)Tope para toda la instalación
KUBEBOLT_PROM_WRITE_ALLOW_CUSTOM_SERIESfalse (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_ENABLEDtruefalse 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.

VariablePor defectoQué acota
KUBEBOLT_INSIGHTS_RETENTION_HORIZON168h (7 días)Registros de insights resueltos (uno por fingerprint). Los episodios siguen el horizonte de hallazgos de abajo
KUBEBOLT_INSIGHT_EXPIRE_TTL15mUn 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_HORIZON720h (30 días)Hallazgos de seguridad resueltos (los activos nunca caducan), eventos de runtime y episodios de insights
KUBEBOLT_AUDIT_RETENTION_HORIZON2160h (90 días)El registro de auditoría de mutaciones y accesos
KUBEBOLT_COPILOT_CONVERSATION_RETENTION_HORIZON2160h (90 días)Transcripciones de Kobi: el almacén con más datos personales (PII) del producto
KUBEBOLT_COPILOT_CONVERSATION_MAX_PER_USER200Conversaciones 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.

VariablePor defectoQué 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_INTERVAL60sIntervalo 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.

VariableValor del chartPor defectoQué hace
KUBEBOLT_BACKEND_URLbackendUrllocalhost:9090 (el chart la exige)Destino de conexión gRPC, host:port, sin esquema
KUBEBOLT_AGENT_MODEse fija por workloadsin definir, lo ejecuta tododaemonset en los pods del DaemonSet, promread en el Deployment de lectura de tu Prometheus
KUBEBOLT_AGENT_CLUSTER_NAMEcluster.name(ninguno)El nombre con el que se registra el clúster
KUBEBOLT_AGENT_CLUSTER_IDcluster.idel UID del namespace kube-systemCámbialo solo para conservar un ID que usaba una instalación antigua
KUBEBOLT_AGENT_LOG_LEVELlogLevelinfodebug, info, warn, error
KUBEBOLT_AGENT_PROXY_ENABLEDderivado de rbac.modefalseTransporta el túnel de la API. El chart lo activa para reader y operator
KUBEBOLT_AGENT_AUTH_MODE · _TOKEN_FILEauth.mode, auth.ingestToken.*, auth.tokenReview.*sin credencialestokenreview o ingest-token, y el token montado
KUBEBOLT_AGENT_TLS_ENABLED · _TLS_CA_FILE · _TLS_CERT_FILE · _TLS_KEY_FILE · _TLS_SERVER_NAMEtls.*texto planoTLS hacia el backend. Un certificado de cliente añade mTLS
KUBEBOLT_AGENT_MAX_MSG_BYTESextraEnv67108864 (64 MiB)Mensaje gRPC más grande. Mantenlo igual que el de la API
KUBEBOLT_HUBBLE_ENABLEDhubble.enabledtrue en el binario, false en el chartColector de flujos de Hubble
KUBEBOLT_HUBBLE_RELAY_ADDRhubble.relay.addresshubble-relay.kube-system.svc.cluster.local:80Relay de Hubble del que se leen los flujos
KUBEBOLT_HUBBLE_RELAY_CA_FILE · _CERT_FILE · _KEY_FILE · _SERVER_NAMEhubble.relay.tls.*texto planoTLS o mTLS hacia el relay
KUBEBOLT_AGENT_DROP_NET_INTERFACEScollectors.dropNetworkInterfacesninguna en el binario; el chart excluye los dispositivos de túnel, los pares veth de cada pod y loInterfaces que quedan fuera de container_network_*. Un * final hace coincidencia por prefijo
KUBEBOLT_AGENT_EXPORTERScollectors.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_STRESSagent.deferNodeNetwork, agent.deferNodeStressfalseDeja 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.*desactivadoModo de lectura desde Prometheus: URL, autenticación, intervalo de consulta, step, lookback, matchers, costo
KUBEBOLT_TENANT_IDtenant.id(ninguno)Déjala vacía: el backend toma el tenant del token de ingesta
GOMEMLIMITgomemlimit90% del límite de memoria de cada contenedorObjetivo de memoria de Go
KUBEBOLT_AGENT_MEMORY_LIMIT_BYTESse 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

VariablePor defectoQué hace
KUBEBOLT_WATCHLIST_CLIENTfalsetrue 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 chartVariables
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=trueKUBEBOLT_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.