Overview

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

Latest version:

Supported Kubernetes Installations

The CloudZero Agent supports the following Kubernetes installations:

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

CloudZero Agent Setup

📘

CloudZero Namespace

We recommend installing the CloudZero Agent for Kubernetes in the cloudzero namespace. Do not install the agent in the default namespace.

Prerequisites:

• Helm v3+
• Kubernetes v1.23+
• A CloudZero API key with the following scopes:
  • container-metrics_v1:abandon
  • container-metrics_v1:get-status
  • container-metrics_v1:legacy
  • container-metrics_v1:upload
  • insights:read_insights
• Each Kubernetes cluster must have a route to the internet and a rule that allows egress from the agent to the CloudZero collector endpoint at https://api.cloudzero.com on port 443

Helm Installation (Recommended):

helm upgrade --install cloudzero \
    --repo https://cloudzero.github.io/cloudzero-charts cloudzero-agent \
    --namespace cloudzero --create-namespace \
    --set apiKey=<CLOUDZERO_API_KEY>
    --set clusterName=<NAME_OF_YOUR_CLUSTER>

OR Raw YAML Installation:

You can run helm template against our chart to generate flat manifests that can be deployed directly.

helm template cloudzero \
    --repo https://cloudzero.github.io/cloudzero-charts cloudzero/cloudzero-agent \
    --namespace cloudzero --create-namespace \
    --set apiKey=<CLOUDZERO_API_KEY>
    --set clusterName=<NAME_OF_YOUR_CLUSTER>

kubectl apply -f cloudzero.yaml

Validating the Install

If all went well, you should have received an install success message letting you know that the agent has been installed.

View CloudZero Agent for Kubernetes Cost Data

Once your CloudZero agent is installed, wait at least 48 hours for data collection to occur, then you can view it in CloudZero. For example, the following image shows Kubernetes cost data for a custom dimension called CloudZero Agent, grouped by cluster: