Kubernetes Agent

Overview

• Runs as a DaemonSet; optional sidecar for namespaces that need per-request metadata.
• Scrapes pod/container requests, usage (CPU, RAM, GPU), node labels, namespace annotations, and custom tags.
• Joins the metrics with AWS pricing data pulled from the public API or Cost & Usage Reports.

Installation

• Helm (recommended): see the quickstart instructions.
• Raw manifests: apply the rendered YAML from helm template ... > clustercost-agent.yaml when you need GitOps control.
• Air-gapped: mirror the container image ghcr.io/clustercost/k8s-agent into your registry and set image.repository.

Configuration

Value	Description
clusterName	Friendly identifier for charts and multi-cluster views.
aws.pricingEndpoint	Override when using a CUR export or PrivateLink endpoint.
extraLabels	Key/value map automatically attached to every metric (e.g., business unit).
namespaces.include / exclude	Restrict collection to specific workloads if needed.

All values are documented in the reference, and anything exposed here can also be set via environment variables on the agent pod.