Configuration

The CostGraph Operator is configured through Helm values.yaml. The defaults work for most clusters; this page covers the options you’re most likely to change.

Global settings

string

required

Name used to identify this cluster in the CostGraph platform.

string

API key for authenticating with CostGraph. Don’t commit a real key — prefer existingSecret in production.

string

Name of a pre-existing Secret holding the API key. When set, apiKey is ignored.

string

default:"apiKey"

Key within existingSecret that holds the API key value.

string

default:"https://api.costgraph.ai"

Base URL of the CostGraph API.

string

default:"costgraph"

Namespace the operator runs in.

Resource exporter

operatorKubernetes watches cluster resources and exports them to CostGraph.

boolean

default:"true"

Deploy the resource exporter.

number

default:"1"

Keep at 1 — the exporter is not designed to run multiple replicas.

object

Resource requests and limits.

object

Standard pod scheduling controls.

array

Additional environment variables.

Operational/Compute Metrics scraper

operatorPrometheus scrapes in-cluster metrics endpoints and remote-writes them to CostGraph.

boolean

default:"true"

Deploy the operational/compute metrics scraper.

string

default:"https://tsdb.costgraph.ai"

Remote-write endpoint for collected metrics.

string

default:"/api/v1/write"

Remote-write path appended to the URL.

string

default:"prometheus"

Metrics API flavor. prometheus or victoriametrics.

string

default:"30s"

Timeout for scrape and backend requests.

AI gateway scraper

aiGatewayScraper reads token usage from AI gateways running in the cluster and remote-writes it to the short-retention tier. It is a second instance of the same scraper image; the difference is remoteWritePath, because raw gateway series are high cardinality and are not intended to live as long as the operator’s scraped metrics.

boolean

default:"false"

Deploy the AI gateway scraper.

string

default:"/api/v1/write/short"

Short-retention tier. Recording rules distil these series before anything reaches 90-day retention.

It takes no scrapeTargets. Targets are served by CostGraph from the connections you create in Settings -> Integrations, fetched at start and refreshed while it runs, so connecting a gateway never edits these values. See AI gateways. A target you define yourself in operatorPrometheus.scrapeTargets always wins over a served one, and a served target is only applied when it carries a metric-name filter.

Network Metrics scraper

flowtrace scrapes per-container network metrics and, optionally, host-process network metrics, then remote-writes them to CostGraph.

The DaemonSet mounts the host filesystems at:

cgroupfs — /host/sys/fs/cgroup.
procfs — /host/proc.

boolean

default:"true"

Deploy the network metrics scraper.

string

default:"https://tsdb.costgraph.ai"

Remote-write endpoint for collected metrics.

string

default:"/api/v1/write/short"

Remote-write path appended to the URL.

string

default:"30s"

Timeout for write and backend requests.

boolean

default:"false"

Container network flows are collected by default. Host-process network flows are collected only when this is enabled.

Scrape targets

operatorPrometheus.scrapeTargets is a map of the in-cluster /metrics endpoints to scrape. The chart ships defaults for cAdvisor, kube-state-metrics, node-exporter, and the kubelet (DCGM is off). Add a source by appending an entry — no new operator image is required. Each entry accepts:

boolean

default:"true"

Include this target.

string

default:"pod"

pod discovers and scrapes matching pods; node scrapes each node’s kubelet through the API-server proxy.

string

Pod targets only — namespace to discover pods in.

string

Label selector for pod (or node) discovery. Required for pod targets.

number

Pod targets only — port the exporter listens on.

string

default:"/metrics"

Metrics path to scrape.

boolean

default:"false"

Stamp costgraph_instance_hostname and costgraph_instance_id on node-scoped sources like cAdvisor and node-exporter.

array

Keep only metric families whose names match one of these prefixes. Empty keeps everything.

Bundled exporters

The chart pulls in the metrics sources as subcharts. Disable any you already run in the cluster. Disable \flowtrace if you do not need network tracing.

boolean

default:"true"

Kubernetes object-level metrics (pods, deployments, nodes).

boolean

default:"true"

Per-container resource usage. Uses the baselinehq/cadvisor image.

boolean

default:"true"

Host-level metrics (CPU, memory, disk, network) on port 9100.

boolean

default:"false"

NVIDIA GPU metrics. Enable only on clusters with GPU nodes; restrict it to GPU nodes with dcgm-exporter.nodeSelector and dcgm-exporter.tolerations.

boolean

default:"true"

Per-container and, optionally, host per-process network metrics (bytes sent/received, packets sent/received, connection count).

Full values reference

Complete values.yaml

global:
  clusterName: ""
  apiKey: ""
  existingSecret: ""
  existingSecretKey: ""
  backendURL: "https://api.costgraph.ai"
  namespace: "costgraph"

serviceAccount:
  create: true
  automount: true

kube-state-metrics:
  enabled: true

cadvisor:
  enabled: true
  image:
    registry: ghcr.io
    repository: baselinehq/cadvisor
    tag: "0.56.3-baseline"

prometheus-node-exporter:
  enabled: true
  service:
    port: 9100
    targetPort: 9100

dcgm-exporter:
  enabled: false
  nodeSelector:
    accelerator: nvidia
  tolerations: []

operatorKubernetes:
  enabled: true
  replicas: 1
  resources:
    requests:
      cpu: 10m
      memory: 64Mi
  nodeSelector: {}
  tolerations: []
  affinity: {}
  env: []

operatorPrometheus:
  enabled: true
  replicas: 1
  config:
    remoteWriteURL: "https://tsdb.costgraph.ai"
    remoteWritePath: "/api/v1/write"
    prometheusAPIProvider: "prometheus"
    httpTimeout: "30s"
  scrapeTargets:
    cadvisor:
      enabled: true
      labelSelector: "app.kubernetes.io/name=cadvisor"
      port: 8080
      nodeMetrics: true
    kube-state-metrics:
      enabled: true
      labelSelector: "app.kubernetes.io/name=kube-state-metrics"
      port: 8080
    node-exporter:
      enabled: true
      labelSelector: "app.kubernetes.io/name=prometheus-node-exporter"
      port: 9100
      nodeMetrics: true
    kubelet:
      enabled: true
      kind: node
      nodeMetrics: true
      metricNamePrefixes:
        - kubelet_
    dcgm-exporter:
      enabled: false
      labelSelector: "app.kubernetes.io/name=dcgm-exporter"
      port: 9400
      nodeMetrics: true
  resources:
    requests:
      cpu: 100m
      memory: 64Mi
  env: []

# flowtrace runs on every node and tolerates all taints by default, 
# requires BTF and cgroup v2, and enters CrashLoopBackOff on incompatible nodes. 
# Use nodeSelector to target compatible nodes in mixed clusters and
# set flowtrace.enabled to false when no compatible nodes exist.

flowtrace:
  enabled: true
  config:
    remoteWriteURL: "https://tsdb.costgraph.ai"
    remoteWritePath: "/api/v1/write/short"
    pushInterval: "4m"
    includeHostFlows: false
    httpTimeout: "30s"
  maxUnavailable: 1
  priorityClassName: ""
  resources:
    requests:
      cpu: 50m
      memory: 64Mi
    limits:
      memory: 256Mi
  tolerations:
    - operator: Exists
  nodeSelector: {}
  affinity: {}
  podAnnotations: {}
  podLabels: {}
  env: []

Node and volume pricing

Nodes and volumes outside a supported cloud are priced with a costgraph.ai/pricing-id label. See On-prem pricing.

Get Started

CostGraph Operator

CostGraph Agent

MCP

Integrations

Global settings

Resource exporter

Operational/Compute Metrics scraper

AI gateway scraper

Network Metrics scraper

Scrape targets

Bundled exporters

Full values reference

Node and volume pricing

​Global settings

​Resource exporter

​Operational/Compute Metrics scraper

​AI gateway scraper

​Network Metrics scraper

​Scrape targets

​Bundled exporters

​Full values reference

​Node and volume pricing

Global settings

Resource exporter

Operational/Compute Metrics scraper

AI gateway scraper

Network Metrics scraper

Scrape targets

Bundled exporters

Full values reference

Node and volume pricing