Skip to content

Kube State Metrics Add-on

This add-on installs kube-state-metrics.

kube-state-metrics (KSM) is a simple service that listens to the Kubernetes API server and generates metrics about the state of the objects. (See examples in the Metrics section below.) It is not focused on the health of the individual Kubernetes components, but rather on the health of the various objects inside, such as deployments, nodes and pods.

kube-state-metrics Add-on is about generating metrics from Kubernetes API objects without modification. This ensures that features provided by kube-state-metrics have the same grade of stability as the Kubernetes API objects themselves.


import * as cdk from 'aws-cdk-lib';
import * as blueprints from '@aws-quickstart/eks-blueprints';

const app = new cdk.App();

const addOn = new blueprints.addons.KubeStateMetricsAddOn()

const blueprint = blueprints.EksBlueprint.builder()
  .build(app, 'my-stack-name');

Configuration Options


To validate that kube-state-metrics is installed properly in the cluster, check if the kube-state-metrics pods are running.

Verify if the pods are running correctly for kube-state-metrics

  kubectl get pods -A | awk '/kube-state/ {print ;exit}'  


There should list pod starting with name kube-state For Eg:

kube-system                     kube-state-metrics-5d4c95885d-82bv4                               1/1     Running   0          13h


Applies the kube-state-metrics add-on to an Amazon EKS cluster.