쿠버네티스(Kubernetes) kube-state-metrics(KSM) 핵심 가이드 및 리소스별 메트릭 명세

💡 kube-state-metrics (KSM) 아키텍처 개요 (Executive Summary)

kube-state-metrics(KSM)는 쿠버네티스 API 서버를 감취(Listen)하여 Pod, Deployment, Node, PersistentVolume 등 쿠버네티스 내부 오브젝트의 현재 상태(State)와 헬스(Health)를 프로메테우스(Prometheus) 메트릭 포맷으로 변환·익스포트하는 핵심 모니터링 컴포넌트입니다. 노드의 CPU/메모리 실사용량을 수집하는 node-exporter나 컨테이너 런타임 지표를 수집하는 cAdvisor와 달리, 리소스의 스펙(Desired Spec), 상태(Status), 복제본 개수(Replicas), 조건(Conditions)을 객관적 지표로 제공합니다.

🏗️ kube-state-metrics 데이터 플로우 및 수집 메커니즘

KSM은 클러스터 수준에서 1개(또는 HA 복제본)의 Deployment로 배포되며, Kubernetes Client-go의 Reflector / Informer 캐시를 사용하여 API 서버에 불필요한 부하를 주지 않고 인메모리에서 프로메테우스 텍스트 메트릭을 실시간 생성합니다.

yaml
# Prometheus Operator ServiceMonitor 설정 예시
apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  name: kube-state-metrics
  namespace: monitoring
  labels:
    app.kubernetes.io/name: kube-state-metrics
spec:
  selector:
    matchLabels:
      app.kubernetes.io/name: kube-state-metrics
  endpoints:
    - port: http-metrics
      interval: 30s
      scrapeTimeout: 10s
      honorLabels: true
    - port: telemetry
      interval: 30s
      scrapeTimeout: 10s
📑 쿠버네티스 리소스별 메트릭 목차 (Table of Contents – 총 23종 리소스)

📦 ConfigMap 메트릭 명세 (5개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_configmap_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_configmap_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_configmap_info GAUGE STABLE ConfigMap에 대한 정보입니다.
kube_configmap_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_configmap_metadata_resource_version GAUGE ConfigMap의 특정 버전을 나타내는 리소스 버전입니다.

📦 CronJob 메트릭 명세 (13개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_cronjob_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_cronjob_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_cronjob_info GAUGE STABLE CronJob에 대한 정보입니다.
kube_cronjob_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_cronjob_status_active GAUGE STABLE 현재 실행 중인 작업의 포인터를 보유합니다.
kube_cronjob_status_last_schedule_time GAUGE STABLE 마지막으로 작업이 성공적으로 예약된 시간을 나타냅니다.
kube_cronjob_status_last_successful_time GAUGE 작업이 마지막으로 성공적으로 완료된 시간을 나타냅니다.
kube_cronjob_spec_suspend GAUGE STABLE 컨트롤러가 이후 실행을 중단하도록 지시하는 플래그입니다.
kube_cronjob_spec_starting_deadline_seconds GAUGE STABLE 예약 시간에 맞추지 못한 경우 작업 시작에 대한 기한(초)입니다.
kube_cronjob_next_schedule_time GAUGE STABLE CronJob이 다음으로 예약될 시간입니다. 마지막 예약 시간 이후 또는 한 번도 예약되지 않은 경우 생성 시간 이후입니다. 이 정보를 사용하여 작업이 지연되었는지 확인합니다.
kube_cronjob_metadata_resource_version GAUGE STABLE CronJob의 특정 버전을 나타내는 리소스 버전입니다.
kube_cronjob_spec_successful_job_history_limit GAUGE 완료된 작업의 수를 보존해야 하는지 컨트롤러에게 지시하는 제한입니다.
kube_cronjob_spec_failed_job_history_limit GAUGE 실패한 작업의 수를 보존해야 하는지 컨트롤러에게 지시하는 제한입니다.

📦 DaemonSet 메트릭 명세 (12개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_daemonset_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_daemonset_status_current_number_scheduled GAUGE STABLE 최소 하나의 데몬 포드를 실행 중이며 실행해야 하는 노드의 수입니다.
kube_daemonset_status_desired_number_scheduled GAUGE STABLE 데몬 포드를 실행 중인 노드의 수입니다.
kube_daemonset_status_number_available GAUGE STABLE 데몬 포드를 실행 중이며 사용 가능한 노드의 수입니다.
kube_daemonset_status_number_misscheduled GAUGE STABLE 데몬 포드를 실행 중이지만 실행해서는 안 되는 노드의 수입니다.
kube_daemonset_status_number_ready GAUGE STABLE 데몬 포드를 실행 중이며 준비된 노드의 수입니다.
kube_daemonset_status_number_unavailable GAUGE STABLE 데몬 포드를 실행 중이지만 사용 불가능한 노드의 수입니다.
kube_daemonset_status_observed_generation GAUGE STABLE 데몬셋 컨트롤러가 관찰한 가장 최근 세대입니다.
kube_daemonset_status_updated_number_scheduled GAUGE STABLE 업데이트된 데몬 포드를 실행 중인 노드의 총 수입니다.
kube_daemonset_metadata_generation GAUGE STABLE 특정 세대의 원하는 상태를 나타내는 시퀀스 번호입니다.
kube_daemonset_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_daemonset_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.

📦 Deployment 메트릭 명세 (15개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_deployment_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_deployment_status_replicas GAUGE STABLE Deployment당 복제본의 수입니다.
kube_deployment_status_replicas_ready GAUGE STABLE 준비된 복제본의 수입니다.
kube_deployment_status_replicas_available GAUGE STABLE 사용 가능한 복제본의 수입니다.
kube_deployment_status_replicas_unavailable GAUGE STABLE 사용 불가능한 복제본의 수입니다.
kube_deployment_status_replicas_updated GAUGE STABLE 업데이트된 복제본의 수입니다.
kube_deployment_status_observed_generation GAUGE STABLE Deployment 컨트롤러가 관찰한 세대입니다.
kube_deployment_status_condition GAUGE STABLE Deployment의 현재 상태 조건입니다.
kube_deployment_spec_replicas GAUGE STABLE Deployment의 원하는 포드 수입니다.
kube_deployment_spec_paused GAUGE STABLE Deployment가 일시 중지되어 Deployment 컨트롤러에 의해 처리되지 않는지 여부입니다.
kube_deployment_spec_strategy_rollingupdate_max_unavailable GAUGE STABLE Deployment 롤링 업데이트 중 사용할 수 없는 최대 복제본 수입니다.
kube_deployment_spec_strategy_rollingupdate_max_surge GAUGE STABLE Deployment 롤링 업데이트 중 원하는 복제본 수를 초과하여 예약할 수 있는 최대 복제본 수입니다.
kube_deployment_metadata_generation GAUGE STABLE 특정 세대의 원하는 상태를 나타내는 시퀀스 번호입니다.
kube_deployment_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_deployment_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.

📦 Endpoint 메트릭 명세 (8개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_endpoint_info GAUGE STABLE 엔드포인트에 대한 정보입니다.
kube_endpoint_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_endpoint_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_endpoint_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_endpoint_address_available GAUGE (v2.6.0 버전 이후로는 사용 중단됨) 엔드포인트에서 사용할 수 있는 주소 수입니다.
kube_endpoint_address_not_ready GAUGE (v2.6.0 버전 이후로는 사용 중단됨) 엔드포인트에서 준비되지 않은 주소 수입니다.
kube_endpoint_address GAUGE STABLE 사용할 수 있는 및 사용할 수 없는 주소에 대한 엔드포인트 정보입니다.
kube_endpoint_ports GAUGE STABLE 엔드포인트 포트에 대한 정보입니다.

📦 HorizontalPodAutoscaler 메트릭 명세 (11개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_horizontalpodautoscaler_info GAUGE 이 오토스케일러에 대한 정보입니다.
kube_horizontalpodautoscaler_metadata_generation GAUGE STABLE HorizontalPodAutoscaler 컨트롤러가 관찰한 세대입니다.
kube_horizontalpodautoscaler_spec_max_replicas GAUGE STABLE 오토스케일러가 설정할 수 있는 최대 포드 수로 MinReplicas보다 작을 수 없습니다.
kube_horizontalpodautoscaler_spec_min_replicas GAUGE STABLE 오토스케일러가 설정할 수 있는 최소 포드 수로 기본값은 1입니다.
kube_horizontalpodautoscaler_spec_target_metric GAUGE 이 오토스케일러가 원하는 복제본 수를 계산할 때 사용하는 메트릭 사양입니다.
kube_horizontalpodautoscaler_status_target_metric GAUGE 이 오토스케일러가 원하는 복제본 수를 계산할 때 사용하는 현재 메트릭 상태입니다.
kube_horizontalpodautoscaler_status_current_replicas GAUGE STABLE 이 오토스케일러가 관리하는 현재 포드 복제본 수입니다.
kube_horizontalpodautoscaler_status_desired_replicas GAUGE STABLE 이 오토스케일러가 관리하는 원하는 포드 복제본 수입니다.
kube_horizontalpodautoscaler_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_horizontalpodautoscaler_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_horizontalpodautoscaler_status_condition GAUGE STABLE 이 오토스케일러의 조건입니다.

📦 Ingress 메트릭 명세 (7개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_ingress_info GAUGE STABLE 인그레스에 대한 정보입니다.
kube_ingress_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_ingress_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_ingress_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_ingress_metadata_resource_version GAUGE 인그레스의 특정 버전을 나타내는 리소스 버전입니다.
kube_ingress_path GAUGE STABLE 인그레스 호스트, 경로 및 백엔드 서비스 정보입니다.
kube_ingress_tls GAUGE STABLE 인그레스 TLS 호스트 및 시크릿 정보입니다.

📦 Job 메트릭 명세 (15개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_job_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_job_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_job_info GAUGE STABLE 작업에 대한 정보입니다.
kube_job_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_job_spec_parallelism GAUGE STABLE 작업이 동시에 실행해야 하는 최대 포드 수입니다.
kube_job_spec_completions GAUGE STABLE 작업이 완료해야 하는 성공적인 포드의 수입니다.
kube_job_spec_active_deadline_seconds GAUGE STABLE 작업이 활성 상태로 있을 수 있는 시간(초)입니다.
kube_job_status_succeeded GAUGE STABLE Phase Succeeded에 도달한 포드의 수입니다.
kube_job_status_failed GAUGE STABLE Phase Failed에 도달한 포드의 수 및 실패 이유입니다.
kube_job_status_active GAUGE STABLE 현재 실행 중인 포드의 수입니다.
kube_job_complete GAUGE STABLE 작업이 완료되었습니다.
kube_job_failed GAUGE STABLE 작업이 실패했습니다.
kube_job_status_start_time GAUGE STABLE 작업 관리자가 작업을 인식한 시간입니다.
kube_job_status_completion_time GAUGE STABLE 작업이 완료된 시간입니다.
kube_job_owner GAUGE STABLE 작업의 소유자에 대한 정보입니다.

📦 Lease 메트릭 명세 (2개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_lease_owner GAUGE Lease의 소유자에 대한 정보입니다.
kube_lease_renew_time GAUGE Kubernetes lease 갱신 시간입니다.

📦 MutatingWebhookConfiguration 메트릭 명세 (4개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_mutatingwebhookconfiguration_info GAUGE MutatingWebhookConfiguration에 대한 정보입니다.
kube_mutatingwebhookconfiguration_created GAUGE 유닉스 생성 타임스탬프입니다.
kube_mutatingwebhookconfiguration_metadata_resource_version GAUGE MutatingWebhookConfiguration의 특정 버전을 나타내는 리소스 버전입니다.
kube_mutatingwebhookconfiguration_webhook_clientconfig_service GAUGE apiserver가 mutating webhook에 연결하는 데 사용하는 서비스입니다.

📦 Namespace 메트릭 명세 (5개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_namespace_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_namespace_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_namespace_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_namespace_status_phase GAUGE STABLE Kubernetes 네임스페이스 상태 단계입니다.
kube_namespace_status_condition GAUGE 네임스페이스의 상태입니다.

📦 NetworkPolicy 메트릭 명세 (5개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_networkpolicy_created GAUGE 네트워크 정책의 유닉스 생성 타임스탬프입니다.
kube_networkpolicy_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_networkpolicy_labels GAUGE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_networkpolicy_spec_ingress_rules GAUGE 네트워크 정책의 인그레스 규칙 수입니다.
kube_networkpolicy_spec_egress_rules GAUGE 네트워크 정책의 이그레스 규칙 수입니다.

📦 Node 메트릭 명세 (12개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_node_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_node_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_node_deletion_timestamp GAUGE 유닉스 삭제 타임스탬프입니다.
kube_node_info GAUGE STABLE 클러스터 노드에 대한 정보입니다.
kube_node_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_node_role GAUGE 클러스터 노드의 역할입니다.
kube_node_spec_taint GAUGE STABLE 클러스터 노드의 taint입니다.
kube_node_spec_unschedulable GAUGE STABLE 노드에 새로운 포드를 예약할 수 있는지 여부입니다.
kube_node_status_allocatable GAUGE STABLE 예약 가능한 노드의 다양한 리소스 할당량입니다.
kube_node_status_capacity GAUGE STABLE 노드의 다양한 리소스 용량입니다.
kube_node_status_condition GAUGE STABLE 클러스터 노드의 상태입니다.
kube_node_status_addresses GAUGE 노드 주소 정보입니다.

📦 PersistentVolumeClaim 메트릭 명세 (9개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_persistentvolumeclaim_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_persistentvolumeclaim_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_persistentvolumeclaim_info GAUGE STABLE 영구 볼륨 클레임에 대한 정보입니다.
kube_persistentvolumeclaim_status_phase GAUGE STABLE 영구 볼륨 클레임의 현재 단계입니다.
kube_persistentvolumeclaim_resource_requests_storage_bytes GAUGE STABLE 영구 볼륨 클레임에 의해 요청된 스토리지 용량입니다.
kube_persistentvolumeclaim_access_mode GAUGE STABLE 영구 볼륨 클레임에 의해 지정된 액세스 모드입니다.
kube_persistentvolumeclaim_status_condition GAUGE 영구 볼륨 클레임의 다양한 상태 조건에 대한 정보입니다.
kube_persistentvolumeclaim_created GAUGE 유닉스 생성 타임스탬프입니다.
kube_persistentvolumeclaim_deletion_timestamp GAUGE 유닉스 삭제 타임스탬프입니다.

📦 PersistentVolume 메트릭 명세 (8개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_persistentvolume_claim_ref GAUGE STABLE 영구 볼륨 클레임 참조에 대한 정보입니다.
kube_persistentvolume_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_persistentvolume_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_persistentvolume_status_phase GAUGE STABLE 볼륨이 사용 가능, 클레임에 바인딩되었거나 클레임에 의해 해제되었음을 나타내는 단계입니다.
kube_persistentvolume_info GAUGE STABLE 영구 볼륨에 대한 정보입니다.
kube_persistentvolume_capacity_bytes GAUGE STABLE 영구 볼륨의 용량(바이트)입니다.
kube_persistentvolume_created GAUGE 유닉스 생성 타임스탬프입니다.
kube_persistentvolume_deletion_timestamp GAUGE 유닉스 삭제 타임스탬프입니다.

📦 PodDisruptionBudget 메트릭 명세 (8개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_poddisruptionbudget_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_poddisruptionbudget_labels GAUGE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_poddisruptionbudget_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_poddisruptionbudget_status_current_healthy GAUGE STABLE 현재 건강한 포드의 수입니다.
kube_poddisruptionbudget_status_desired_healthy GAUGE STABLE 최소로 필요한 건강한 포드의 수입니다.
kube_poddisruptionbudget_status_pod_disruptions_allowed GAUGE STABLE 현재 허용된 포드 중단의 수입니다.
kube_poddisruptionbudget_status_expected_pods GAUGE STABLE 이 중단 예산에 의해 계산된 포드의 총 수입니다.
kube_poddisruptionbudget_status_observed_generation GAUGE STABLE 이 PDB 상태를 업데이트할 때 관찰된 가장 최근 세대입니다.

📦 Pod 메트릭 명세 (53개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_pod_completion_time GAUGE STABLE 포드의 유닉스 완료 시간입니다.
kube_pod_container_info GAUGE STABLE 포드 내 컨테이너에 대한 정보입니다.
kube_pod_container_resource_limits GAUGE 컨테이너가 요청한 제한 리소스의 수입니다. 더 정밀한 kube\_pod\_resource\_limits 메트릭을 사용하는 것이 좋습니다.
kube_pod_container_resource_requests GAUGE 컨테이너가 요청한 리소스의 수입니다. 더 정밀한 kube\_pod\_resource\_requests 메트릭을 사용하는 것이 좋습니다.
kube_pod_container_state_started GAUGE STABLE 포드 컨테이너의 시작 시간입니다.
kube_pod_container_status_last_terminated_reason GAUGE 컨테이너가 마지막으로 종료된 상태의 이유를 설명합니다.
kube_pod_container_status_last_terminated_exitcode GAUGE 컨테이너가 마지막으로 종료된 상태의 종료 코드를 설명합니다.
kube_pod_container_status_last_terminated_timestamp GAUGE 포드 컨테이너가 마지막으로 종료된 시간입니다.
kube_pod_container_status_ready GAUGE STABLE 컨테이너의 준비 상태가 성공했는지 설명합니다.
kube_pod_container_status_restarts_total COUNTER STABLE 컨테이너의 총 재시작 횟수입니다.
kube_pod_container_status_running GAUGE STABLE 컨테이너가 현재 실행 중인지 설명합니다.
kube_pod_container_status_terminated GAUGE STABLE 컨테이너가 현재 종료 상태인지 설명합니다.
kube_pod_container_status_terminated_reason GAUGE 컨테이너가 현재 종료 상태인 이유를 설명합니다.
kube_pod_container_status_waiting GAUGE STABLE 컨테이너가 현재 대기 상태인지 설명합니다.
kube_pod_container_status_waiting_reason GAUGE 컨테이너가 현재 대기 상태인 이유를 설명합니다.
kube_pod_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_pod_deletion_timestamp GAUGE 유닉스 삭제 타임스탬프입니다.
kube_pod_info GAUGE STABLE 포드에 대한 정보입니다.
kube_pod_ips GAUGE 포드 IP 주소입니다.
kube_pod_init_container_info GAUGE STABLE 포드 내 초기화 컨테이너에 대한 정보입니다.
kube_pod_init_container_resource_limits GAUGE 초기화 컨테이너가 요청한 제한 리소스의 수입니다.
kube_pod_init_container_resource_requests GAUGE 초기화 컨테이너가 요청한 리소스의 수입니다.
kube_pod_init_container_status_last_terminated_reason GAUGE 초기화 컨테이너가 마지막으로 종료된 상태의 이유를 설명합니다.
kube_pod_init_container_status_ready GAUGE STABLE 초기화 컨테이너의 준비 상태가 성공했는지 설명합니다.
kube_pod_init_container_status_restarts_total COUNTER STABLE 초기화 컨테이너의 총 재시작 횟수입니다.
kube_pod_init_container_status_running GAUGE STABLE 초기화 컨테이너가 현재 실행 중인지 설명합니다.
kube_pod_init_container_status_terminated GAUGE STABLE 초기화 컨테이너가 현재 종료 상태인지 설명합니다.
kube_pod_init_container_status_terminated_reason GAUGE 초기화 컨테이너가 현재 종료 상태인 이유를 설명합니다.
kube_pod_init_container_status_waiting GAUGE STABLE 초기화 컨테이너가 현재 대기 상태인지 설명합니다.
kube_pod_init_container_status_waiting_reason GAUGE 초기화 컨테이너가 현재 대기 상태인 이유를 설명합니다.
kube_pod_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_pod_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_pod_overhead_cpu_cores GAUGE 포드를 실행하는 데 필요한 CPU 코어 오버헤드입니다.
kube_pod_overhead_memory_bytes GAUGE 포드를 실행하는 데 필요한 메모리 오버헤드입니다.
kube_pod_owner GAUGE STABLE 포드의 소유자에 대한 정보입니다.
kube_pod_restart_policy GAUGE STABLE 이 포드에서 사용 중인 재시작 정책을 설명합니다.
kube_pod_runtimeclass_name_info GAUGE 포드에 연결된 런타임 클래스입니다.
kube_pod_spec_volumes_persistentvolumeclaims_info GAUGE STABLE 포드 내 영구 볼륨 클레임에 대한 정보입니다.
kube_pod_spec_volumes_persistentvolumeclaims_readonly GAUGE STABLE 영구 볼륨 클레임이 읽기 전용으로 마운트되었는지 여부를 설명합니다.
kube_pod_start_time GAUGE STABLE 포드의 유닉스 시작 시간입니다.
kube_pod_status_phase GAUGE STABLE 포드의 현재 단계입니다.
kube_pod_status_qos_class GAUGE 포드의 현재 QoS 클래스입니다.
kube_pod_status_ready GAUGE STABLE 포드가 요청을 처리할 준비가 되었는지 설명합니다.
kube_pod_status_ready_time GAUGE 포드의 준비가 완료된 시간입니다.
kube_pod_status_initialized_time GAUGE 포드의 초기화가 완료된 시간입니다.
kube_pod_status_container_ready_time GAUGE 포드 컨테이너의 준비가 완료된 시간입니다.
kube_pod_status_reason GAUGE 포드 상태 이유입니다.
kube_pod_status_scheduled GAUGE STABLE 포드 예약 프로세스의 상태를 설명합니다.
kube_pod_status_scheduled_time GAUGE STABLE 포드가 예약 상태로 전환된 유닉스 타임스탬프입니다.
kube_pod_status_unschedulable GAUGE STABLE 포드가 예약되지 않은 상태를 설명합니다.
kube_pod_tolerations GAUGE 포드 허용오차에 대한 정보입니다.
kube_pod_service_account GAUGE 포드의 서비스 계정입니다.
kube_pod_scheduler GAUGE 포드의 스케줄러입니다.

📦 ReplicaSet 메트릭 명세 (10개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_replicaset_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_replicaset_status_replicas GAUGE STABLE ReplicaSet당 복제본의 수입니다.
kube_replicaset_status_fully_labeled_replicas GAUGE STABLE 완전히 레이블된 복제본의 수입니다.
kube_replicaset_status_ready_replicas GAUGE STABLE 준비된 복제본의 수입니다.
kube_replicaset_status_observed_generation GAUGE STABLE ReplicaSet 컨트롤러가 관찰한 세대입니다.
kube_replicaset_spec_replicas GAUGE STABLE ReplicaSet의 원하는 포드 수입니다.
kube_replicaset_metadata_generation GAUGE STABLE 특정 세대의 원하는 상태를 나타내는 시퀀스 번호입니다.
kube_replicaset_owner GAUGE STABLE ReplicaSet의 소유자에 대한 정보입니다.
kube_replicaset_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_replicaset_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.

📦 Secret 메트릭 명세 (7개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_secret_info GAUGE STABLE 시크릿에 대한 정보입니다.
kube_secret_type GAUGE STABLE 시크릿의 유형입니다.
kube_secret_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_secret_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_secret_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_secret_metadata_resource_version GAUGE 시크릿의 특정 버전을 나타내는 리소스 버전입니다.
kube_secret_owner GAUGE 시크릿의 소유자에 대한 정보입니다.

📦 Service 메트릭 명세 (7개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_service_info GAUGE STABLE 서비스에 대한 정보입니다.
kube_service_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_service_spec_type GAUGE STABLE 서비스의 유형입니다.
kube_service_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_service_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_service_spec_external_ip GAUGE STABLE 서비스 외부 IP입니다. 각 IP에 대한 시리즈입니다.
kube_service_status_load_balancer_ingress GAUGE STABLE 서비스 로드 밸런서 인그레스 상태입니다.

📦 StatefulSet 메트릭 명세 (15개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_statefulset_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_statefulset_status_replicas GAUGE STABLE StatefulSet당 복제본의 수입니다.
kube_statefulset_status_replicas_available GAUGE StatefulSet당 사용 가능한 복제본의 수입니다.
kube_statefulset_status_replicas_current GAUGE STABLE StatefulSet당 현재 복제본의 수입니다.
kube_statefulset_status_replicas_ready GAUGE STABLE StatefulSet당 준비된 복제본의 수입니다.
kube_statefulset_status_replicas_updated GAUGE STABLE StatefulSet당 업데이트된 복제본의 수입니다.
kube_statefulset_status_observed_generation GAUGE STABLE StatefulSet 컨트롤러가 관찰한 세대입니다.
kube_statefulset_replicas GAUGE STABLE StatefulSet의 원하는 포드 수입니다.
kube_statefulset_ordinals_start GAUGE StatefulSet의 시작 번호입니다.
kube_statefulset_metadata_generation GAUGE STABLE 특정 세대의 원하는 상태를 나타내는 시퀀스 번호입니다.
kube_statefulset_persistentvolumeclaim_retention_policy GAUGE StatefulSet 템플릿 PVC의 보존 정책 수입니다.
kube_statefulset_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_statefulset_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.
kube_statefulset_status_current_revision GAUGE STABLE StatefulSet에서 생성된 포드의 버전을 나타냅니다.
kube_statefulset_status_update_revision GAUGE STABLE StatefulSet에서 생성된 포드의 버전을 나타냅니다.

📦 StorageClass 메트릭 명세 (4개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_storageclass_info GAUGE STABLE StorageClass에 대한 정보입니다.
kube_storageclass_created GAUGE STABLE 유닉스 생성 타임스탬프입니다.
kube_storageclass_annotations GAUGE Kubernetes 주석을 Prometheus 레이블로 변환합니다.
kube_storageclass_labels GAUGE STABLE Kubernetes 레이블을 Prometheus 레이블로 변환합니다.

📦 ValidatingWebhookConfiguration 메트릭 명세 (4개)

메트릭 이름 (Metric Name) 유형 (Type) 설명 및 역할 (Description & Help)
kube_validatingwebhookconfiguration_info GAUGE ValidatingWebhookConfiguration에 대한 정보입니다.
kube_validatingwebhookconfiguration_created GAUGE 유닉스 생성 타임스탬프입니다.
kube_validatingwebhookconfiguration_metadata_resource_version GAUGE ValidatingWebhookConfiguration의 특정 버전을 나타내는 리소스 버전입니다.
kube_validatingwebhookconfiguration_webhook_clientconfig_service GAUGE apiserver가 Validating webhook에 연결하는 데 사용하는 서비스입니다.

이 포스팅은 쿠팡 파트너스 및 알리익스프레스 어필리에이트 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.


Posted:

/

Category:

Author:

Tags:

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *