Skip to main content
The CostGraph Operator runs in your Kubernetes cluster and continuously reports its state to CostGraph. It deploys three components:
  • Resource exporter: watches every Kubernetes resource (workloads, nodes, namespaces, and more) and exports their definitions to CostGraph.
  • Operational/Compute Metrics scraper: scrapes cluster, host, and container metrics and remote-writes them to CostGraph.
  • Network Metrics scraper: scrapes container network metrics and, optionally, host-process network metrics, then remote-writes them to CostGraph.
Together they collect:
  • Cluster inventory: the live manifests of all resources in the cluster.
  • Container CPU/memory metrics: per-container CPU and memory from cAdvisor.
  • Container and host process network metrics: per-container and, optionally, per-process bytes sent/received, packets sent/received, new-connection counts.
  • Host metrics: node CPU, memory, disk, and network from node-exporter and the kubelet.
  • Kubernetes object metrics: pod, deployment, and node state from kube-state-metrics.
  • GPU metrics: optional, from the NVIDIA DCGM exporter. See Accelerators.
On the CostGraph platform, this data powers:
  • Workload and namespace cost: spend attributed across pods, deployments, and namespaces.
  • Rightsizing recommendations: CPU and memory resize suggestions for your workloads.
  • Idle detection: workloads that consistently use less than they request.
  • Cost anomalies: unusual spend or utilization changes surfaced automatically.

Prerequisites

  • A running Kubernetes cluster.
  • Helm 3+.
  • An API key from the CostGraph platform.
  • For network flow tracing, a root-privileged BTF-enabled kernel and a host-mounted cgroup v2 filesystem.

Install

1

Add the Helm repository

2

Install the operator

For production, store the API key in a Secret and reference it with global.existingSecret instead of passing it inline. See Configuration.
3

Verify

After all pods are Running, your cluster appears in the CostGraph platform.
Running GPU nodes? Enable the DCGM exporter for GPU metrics. See Accelerators.
The chart ships with sensible defaults. To tune scheduling, metrics sources, or the bundled exporters, see the Configuration reference.