Repolode
Enviar
kubernetes

kubernetes/kube-state-metrics

Servicio adicional de Kubernetes que escucha al API server y expone métricas de Prometheus sobre el estado de objetos como pods, deployments y nodos.

Ver en GitHubSitio web
Estrellas
6,228
Forks
2,199
Issues abiertos
117
Último commit
hace 5 días

¿Qué es?

kube-state-metrics (KSM) observa el API server de Kubernetes y genera métricas sobre el estado de objetos como deployments, nodos y pods. Se centra en la salud de los objetos del clúster, no en la salud interna de los componentes de Kubernetes, y expone datos sin procesar de la API, sin aplicar las heurísticas que kubectl usa para mostrarlos.

Las métricas se sirven como texto sin formato en el endpoint HTTP /metrics, diseñado para que Prometheus o un scraper compatible las recopile. Reflejan el estado actual del clúster, por lo que los objetos eliminados desaparecen de la salida. El consumo de recursos aumenta con el tamaño del clúster, y el proyecto ofrece orientación sobre el uso de sharding, el filtrado de recursos y la limitación de acceso mediante RBAC para entornos grandes o restringidos.

El proyecto se mantiene bajo SIG Instrumentation, y el chart oficial de Helm se mantiene en el repositorio helm-charts de prometheus-community.

Funciones clave

  • 01Genera métricas a partir de objetos de la API de Kubernetes, sin modificarlos.
  • 02Expone métricas en formato Prometheus en el endpoint HTTP /metrics.
  • 03Admite el sharding horizontal por UID de objeto o el sharding automatizado mediante StatefulSet.
  • 04Permite filtrar los recursos recopilados mediante los parámetros de consulta resources y exclude_resources.
  • 05Convierte las etiquetas de Kubernetes en etiquetas de Prometheus y resuelve los conflictos de nombres mediante sufijos.
  • 06Ofrece los endpoints de salud /healthz, /livez y /readyz.

Casos de uso

  • Crear dashboards y alertas de Prometheus sobre el número de réplicas de deployments, las fases de los pods o las condiciones de los nodos.
  • Supervisar la salud de las cargas de trabajo en todo un clúster sin modificar las aplicaciones que se ejecutan en él.
  • Distribuir la recopilación de métricas entre varias instancias cuando un clúster genera grandes volúmenes de métricas.

Inicio rápido

  1. 1

    Descarga la imagen del contenedor desde registry.k8s.io

  2. 2

    Despliégala en tu clúster siguiendo las instrucciones de Kubernetes Deployment o Helm Chart del README

Antes de usarlo

  • Solo se ejecuta dentro de un clúster de Kubernetes y necesita acceso al servidor de API.
  • Mantiene en memoria una instantánea completa del estado del clúster, por lo que, como orientación general, necesita unos 250MiB de memoria y 0,1 núcleos.
  • Las métricas de eventos predeterminadas pueden generar altos costos de ingesta en algunos proveedores de nube.
  • La función custom-resource-state está congelada en favor de resource-state-metrics.

En colecciones

Plataformas de OpenTelemetry y observabilidad

Temas

#kubernetes#prometheus#monitoring#metrics#observability#exporter#kubernetes-exporter#kubernetes-monitoring#prometheus-exporter

Preguntas frecuentes

¿Qué es kube-state-metrics?
Servicio adicional de Kubernetes que escucha al API server y expone métricas de Prometheus sobre el estado de objetos como pods, deployments y nodos. kube-state-metrics (KSM) observa el API server de Kubernetes y genera métricas sobre el estado de objetos como deployments, nodos y pods. Se centra en la salud de los objetos del clúster, no en la salud interna de los componentes de Kubernetes, y expone datos sin procesar de la API, sin aplicar las heurísticas que kubectl usa para mostrarlos.
¿kube-state-metrics es gratuito? ¿Qué licencia tiene?
kube-state-metrics es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿kube-state-metrics sigue mantenido?
Mantenimiento activo. El último commit de kube-state-metrics fue el 19 oct 2026.
¿Para qué puedo usar kube-state-metrics?
Crear dashboards y alertas de Prometheus sobre el número de réplicas de deployments, las fases de los pods o las condiciones de los nodos. Supervisar la salud de las cargas de trabajo en todo un clúster sin modificar las aplicaciones que se ejecutan en él. Distribuir la recopilación de métricas entre varias instancias cuando un clúster genera grandes volúmenes de métricas.
¿Cómo se instala kube-state-metrics?
Descarga la imagen del contenedor desde registry.k8s.io Despliégala en tu clúster siguiendo las instrucciones de Kubernetes Deployment o Helm Chart del README
¿Dónde consigo kube-state-metrics?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/kubernetes/kube-state-metrics

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados