Configuration
Agent Configuration
View sourceHelm values reference for the Kubeadapt agent. Covers authentication, resource sizing, GPU metrics, compression, and scheduling.
All values below live under the agent key in your values.yaml or can be set with --set agent.<path>=<value>.
Authentication
| Value | Type | Default | Description |
|---|---|---|---|
config.token | string | "" | Agent token from the Kubeadapt dashboard. Required (unless existingSecret is set). |
config.existingSecret | string | "" | Name of an existing Kubernetes Secret containing the token. The Secret must have a key named token. When set, config.token is ignored and no Secret is created by the chart. |
Data Collection
The agent collects cluster metrics at 1-minute intervals by default. This granularity can be overridden by Kubeadapt Cloud for your subscription tier. The agent handles retries and recovery automatically.
Compression
| Value | Type | Default | Description |
|---|---|---|---|
config.compressionLevel | int | 3 | Compression level for data sent to Kubeadapt. Min: 1 (fastest). Max: 4 (smallest payload). |
Level 3 is a good balance for most clusters. Increase to 4 for larger clusters (3000+ nodes) where payload size matters.
Resource Sizing
Default resources:
1agent:
2 resources:
3 requests:
4 cpu: 100m
5 memory: 128Mi
6 limits:
7 cpu: 1000m
8 memory: 1GiThe agent automatically tunes itself to the container limits you set.
| Cluster Size | Memory Request | Memory Limit |
|---|---|---|
| Up to 1000 nodes | 128Mi (default) | 1Gi (default) |
| 1000+ nodes | 512Mi | 2Gi |
GPU Metrics
The agent auto-discovers NVIDIA DCGM Exporter pods and collects GPU utilization and memory metrics. No configuration needed in most cases.
| Value | Type | Default | Description |
|---|---|---|---|
config.gpuMetricsEnabled | bool | true | Enable GPU metrics collection from DCGM Exporter. |
config.dcgmPort | int | 9400 | DCGM Exporter port. |
config.dcgmNamespace | string | "" | Restrict DCGM discovery to a specific namespace. Empty means search all namespaces. |
config.dcgmEndpoints | string | "" | Comma-separated list of DCGM Exporter endpoints (IPs or hostnames). Use this if auto-discovery fails. |
If you do not have NVIDIA GPUs in your cluster, the agent silently skips GPU collection. No need to disable it.
Scheduling
| Value | Type | Default | Description |
|---|---|---|---|
tolerations | list | [] | Pod tolerations. |
nodeSelector | object | {} | Node selector constraints. |
affinity | object | {} | Pod affinity rules. |
topologySpreadConstraints | list | [] | Topology spread constraints. |
Full Values Reference
The sections above cover what you need for capability enablement and successful scheduling. For other configurations, see the full values.yaml.