Installation of CloudZero Agent for Kubernetes

Install and configure the CloudZero Kubernetes agent

Overview

The CloudZero Agent for Kubernetes collects and forwards container metrics to the CloudZero Platform, combining them with data from your cloud provider to determine how to allocate your Kubernetes costs.

Detailed documentation and examples are provided in our GitHub repository.

Supported Kubernetes Installations

The CloudZero Agent supports the following Kubernetes installations:

  • Self-managed Kubernetes in AWS and Azure
  • AWS Elastic Kubernetes Service (EKS)
  • Azure Kubernetes Service (AKS)
  • Google Kubernetes Engine (GKE) and self-managed Kubernetes in Google Cloud (in beta)

Prerequisites

The installation of the agent requires Helm3+, kube-state-metrics, and node-exporter.

Kubernetes Versionkube-state-metricsnode-exporter
1.23+5.15+4.24+

Installation

See the README for installation instructions.

Validate Installation

See Validating the Deployment for instructions on validating and troubleshooting installation.

Exploring Kubernetes Cost Allocations

Kubernetes cost allocations will appear in CloudZero after your cloud provider's next billing data ingestion. You can then filter and group costs by Kubernetes dimensions in the Explorer.

For example, in the following image, the Group By drop-down menu is set to the Kubernetes Cluster dimension:

Costs grouped by Kubernetes cluster in the Explorer

See Exploring Container Costs for more information.

Technical Implementation Details

The CloudZero Agent for Kubernetes pulls metrics from kube-state-metrics and node-exporter projects and forwards the metrics to CloudZero using Prometheus Remote Write, as shown in the following architecture diagram:

Architecture diagram of the CloudZero Agent for Kubernetes

To learn how to optimally configure your cluster's resources for agent deployment, see the CloudZero Agent Deployment Sizing Guide.