kube-state-metrics

Kube-state-metrics is a service that listens to the Kubernetes API server and generates metrics about the state of cluster objects such as deployments, nodes,…

  • Infrastructure
  • Monitoring & Logging
  • Tools & Utilities
Kube-state-metrics is a service that listens to the Kubernetes API server and generates metrics about the state of cluster objects such as deployments, nodes, and pods for use by monitoring systems.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

76/100 Good

Maintained
100last commit 1 day ago
Popular
766,237 GitHub stars
Easy to install
101 install platform
Light to run
100250 MB minimum RAM
Security check
74no serious findings, 3 minor, CI, tests, OpenSSF Scorecard 6.1/10

Availability: platform listings confirmed today

GitHub stars
6,237
Open issues
104
Last commit
2026-11-19
Latest release
v2.20.0
License
Apache-2.0
Activity
rising

Checked today - source: GitHub (kubernetes/kube-state-metrics)

Resources & Compatibility

Minimum requirements: 250 MB RAM.

Checked 40 days ago - source: Docker Hub image tags and published docs

First-install notes

No first-install notes yet.

Alternatives (11)

  • Consul Lambda Registrator - Consul Lambda Registrator is a containerized AWS Lambda function that registers and deregisters AWS Lambda functions in Consul, helping ope…
  • Heroku - Heroku is a platform as a service (PaaS) that enables developers to build, run, and operate applications entirely in the cloud.
  • OpenShift - Red Hat OpenShift is a trusted, comprehensive, and consistent platform to develop, modernize, and deploy applications at scale, including t…
  • Rancher - A container management platform built for organizations that deploy containers in production.
  • Rancher Desktop - Rancher Desktop is an open-source desktop application for Mac, Windows and Linux.
  • VMPal
  • Vagrant - Create and manage virtualized development environments.
  • isaiah - Self-hostable clone of lazydocker for the web.
  • openfaas - OpenFaaS is a lightweight serverless platform for deploying event-driven functions and microservices to Kubernetes or a standalone host wit…
  • radius - Radius is a cloud-native application platform that enables developers and the platform engineers that support them to collaborate on delive…
  • virt-manager - Virt-Manager is a desktop graphical interface for virtualization administrators to create, configure, monitor, and access libvirt virtual m…

Checked 40 days ago - source: AlternativeTo

Common questions

Why can kube-state-metrics show values that differ from kubectl output?

kube-state-metrics exposes raw data unmodified from the Kubernetes API. kubectl applies display heuristics, so the two can present different values.

How should an external Prometheus instance collect kube-state-metrics?

Prometheus or another scraper should collect from the kube-state-metrics HTTP endpoint. That endpoint exposes metrics generated from the state of individual Kubernetes objects.

Do multiple kube-state-metrics replicas create duplicate metrics?

Yes, the source reports that setting replicas to 2 produces double the metrics. It asks whether two replicas can provide HA without duplicating the metric set.

What failure modes should I check when kube-state-metrics is misbehaving?

Check for CrashLoopBackOff, OOMKilled, high CPU usage, metrics not appearing, permission errors, and pods not starting after an upgrade.

Can kube-state-metrics pod start/stop metrics disappear with Prometheus remote write?

The source describes missing kube-state-metrics pod start/stop data when using Prometheus remote write. This can affect attempts to track pod uptime.

Answers sourced from github.com, kubernetes.io, kubestatemetrics.com, stackoverflow.com, www.reddit.com

Community

Collected 48 days ago - public community threads