Recopila y consulta las métricas de cAdvisor/Kubelet

En esta página, se describe cómo configurar un clúster de Google Kubernetes Engine (GKE) para enviar un conjunto seleccionado de métricas de cAdvisor/Kubelet a Cloud Monitoring con Google Cloud Managed Service para Prometheus. Esta página también describe cómo se formatean estas métricas cuando se escriben en Monitoring y cómo se consultan métricas.

El conjunto seleccionado de métricas es un subconjunto del conjunto de métricas de cAdvisor/Kubelet integradas en cada implementación de Kubernetes de forma predeterminada e incluye métricas relacionadas con la reducción del volumen de transferencia y los costos asociados.

Antes de comenzar

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

  • Habilita la API de Google Kubernetes Engine.
    • Habilitar la API de Google Kubernetes Engine
  • Si deseas usar Google Cloud CLI para esta tarea, instala y, luego, inicializa gcloud CLI. Si ya instalaste gcloud CLI, ejecuta gcloud components update para obtener la versión más reciente.

Requisitos

Para recopilar las métricas de cAdvisor/Kubelet, el clúster de GKE debe cumplir con los siguientes requisitos:

  • El clúster debe ejecutar la versión de GKE 1.29.3-gke.1093000 o una versión posterior.
  • El clúster debe tener habilitadas las métricas del sistema. Las métricas del sistema se habilitan de forma predeterminada cuando creas un clúster que ejecuta la versión 1.29.3-gke.1093000 o una posterior.
  • El clúster tiene habilitada la recopilación administrada de Google Cloud Managed Service para Prometheus. La recopilación administrada se habilita de forma predeterminada cuando creas un clúster que ejecuta la versión 1.29.3-gke.1093000 o una posterior.

Configura la recopilación de métricas de cAdvisor/Kubelet

Puedes habilitar las métricas de cAdvisor/Kubelet en un clúster de GKE existente con la consola de Google Cloud, gcloud CLI o Terraform.

Console

Para configurar las métricas de cAdvisor/Kubelet desde la pestaña Detalles del clúster, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Clústeres de Kubernetes.

    Ir a clústeres de Kubernetes

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Kubernetes Engine.

  2. Haz clic en el nombre del clúster.

  3. En la fila Funciones etiquetada como Cloud Monitoring, haz clic en el ícono Editar.

  4. En el cuadro de diálogo Editar Cloud Monitoring que aparecerá, confirma que esté seleccionada la opción Habilitar Cloud Monitoring.

  5. En el menú desplegable Componentes, selecciona los componentes de cAdvisor/Kubelet del que deseas recopilar métricas:

    • cAdvisor
    • Kubelet

  6. Haga clic en Aceptar.

  7. Haz clic en Guardar cambios.

gcloud

Actualiza tu clúster para recopilar métricas:

gcloud container clusters update CLUSTER_NAME \
    --location=COMPUTE_LOCATION \
    --enable-managed-prometheus \
    --monitoring=SYSTEM,CADVISOR,KUBELET

Reemplaza lo siguiente:

El conjunto de valores proporcionados a la marca monitoring anula cualquier configuración anterior.

Terraform

Para configurar la colección de métricas de cAdvisor/Kubelet mediante Terraform, consulta el bloque monitoring_config en el registro de Terraform para google_container_cluster. Para obtener información general sobre el uso de Google Cloud con Terraform, consulta Terraform con Google Cloud.

Formato de métrica

Todas las métricas de cAdvisor/Kubelet de Kubernetes escritas en Cloud Monitoring usan el tipo de recurso prometheus_target. Cada nombre de métrica tiene el prefijo prometheus.googleapis.com/ y tiene un sufijo que indica el tipo de métrica de Prometheus, como /gauge, /histogram o /counter. De lo contrario, cada nombre de métrica es idéntico al nombre de la métrica que expone Kubernetes de código abierto.

Exporta desde Cloud Monitoring

Las métricas de cAdvisor/Kubelet pueden exportarse desde Cloud Monitoring con la API de Cloud Monitoring. Debido a que todas las métricas de cAdvisor/Kubelet se transfieren mediante Google Cloud Managed Service para Prometheus, las métricas de cAdvisor/Kubelet se pueden consultar a través del lenguaje de consulta de Prometheus (PromQL). También se pueden consultar a través del uso del lenguaje de consulta de Monitoring (MQL).

Consulta métricas

Cuando consultas las métricas de cAdvisor/Kubelet, el nombre que usas depende de si usas funciones basadas en PromQL o Cloud Monitoring, como MQL o la interfaz controlada por menú del Explorador de métricas.

Las siguientes tablas de métricas de cAdvisor/Kubelet muestran dos versiones de cada nombre de métrica:

  • Nombre de la métrica de PromQL: Cuando usas PromQL en páginas de Cloud Monitoring de la consola de Google Cloud o en campos de PromQL de la API de Cloud Monitoring, usa el nombre de la métrica PromQL.
  • Nombre de la métrica de Cloud Monitoring Cuando uses otras funciones de Cloud Monitoring, usa el nombre de la métrica de Cloud Monitoring en las tablas que aparecen a continuación. Este nombre debe tener el prefijo prometheus.googleapis.com/, que se omitió en las entradas de la tabla.

Métricas de cAdvisor

Los nombres de las métricas de Cloud Monitoring en esta tabla deben tener el prefijo prometheus.googleapis.com/. Este prefijo se omitió en las entradas de la tabla.

Nombre de la métrica de PromQL
Nombre de la métrica de Cloud Monitoring
Categoría, tipo, unidad
Recursos supervisados
Versión de GKE requerida		 Descripción
Etiquetas
container_cpu_cfs_periods_total
container_cpu_cfs_periods_total/counter
CUMULATIVE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Cantidad de intervalos de períodos de aplicación transcurridos. Se tomaron muestras cada 30 segundos.

cpu
container_cpu_cfs_throttled_periods_total
container_cpu_cfs_throttled_periods_total/counter
CUMULATIVE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Cantidad de intervalos de períodos regulados. Se tomaron muestras cada 30 segundos.

cpu
container_cpu_usage_seconds_total
container_cpu_usage_seconds_total/counter
CUMULATIVE, DOUBLE, s
prometheus_target
1.29.3-gke.1093000 		Tiempo de CPU consumido acumulado. Se tomaron muestras cada 30 segundos.

cpu
container_fs_limit_bytes
container_fs_limit_bytes/gauge
GAUGE, DOUBLE, By
prometheus_target
1.29.3-gke.1093000 		Cantidad de bytes que puede consumir el contenedor en este sistema de archivos. Se tomaron muestras cada 30 segundos.

disk
container_fs_read_seconds_total
container_fs_read_seconds_total/counter
CUMULATIVE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de lecturas completadas. Se tomaron muestras cada 30 segundos.

diskIO
container_fs_reads_bytes_total
container_fs_reads_bytes_total/counter
CUMULATIVE, DOUBLE, By
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de bytes leídos. Se tomaron muestras cada 30 segundos.

diskIO
container_fs_reads_total
container_fs_reads_total/counter
CUMULATIVE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de lecturas completadas. Se tomaron muestras cada 30 segundos.

diskIO
container_fs_usage_bytes
container_fs_usage_bytes/gauge
GAUGE, DOUBLE, By
prometheus_target
1.29.3-gke.1093000 		Cantidad de bytes que consume el contenedor en este sistema de archivos. Se tomaron muestras cada 30 segundos.

disk
container_fs_write_seconds_total
container_fs_write_seconds_total/counter
CUMULATIVE, DOUBLE, s
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de segundos dedicados a la escritura. Se tomaron muestras cada 30 segundos.

diskIO
container_fs_writes_bytes_total
container_fs_writes_bytes_total/counter
CUMULATIVE, DOUBLE, By
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de bytes escritos. Se tomaron muestras cada 30 segundos.

diskIO
container_fs_writes_total
container_fs_writes_total/counter
CUMULATIVE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de escrituras completadas. Se tomaron muestras cada 30 segundos.

diskIO
container_memory_rss
container_memory_rss/gauge
GAUGE, DOUBLE, By
prometheus_target
1.29.3-gke.1093000 		Tamaño del RSS. Se tomaron muestras cada 30 segundos.

memory
container_memory_working_set_bytes
container_memory_working_set_bytes/gauge
GAUGE, DOUBLE, By
prometheus_target
1.29.3-gke.1093000 		Conjunto de trabajo actual. Se tomaron muestras cada 30 segundos.

memory
container_network_receive_bytes_total
container_network_receive_bytes_total/counter
CUMULATIVE, DOUBLE, By
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de bytes recibidos. Se tomaron muestras cada 30 segundos.

network
container_network_receive_packets_dropped_total
container_network_receive_packets_dropped_total/counter
CUMULATIVE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de paquetes descartados durante la recepción. Se tomaron muestras cada 30 segundos.

network
container_network_receive_packets_total
container_network_receive_packets_total/counter
CUMULATIVE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de paquetes recibidos. Se tomaron muestras cada 30 segundos.

network
container_network_transmit_bytes_total
container_network_transmit_bytes_total/counter
CUMULATIVE, DOUBLE, By
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de bytes transmitidos. Se tomaron muestras cada 30 segundos.

network
container_network_transmit_packets_dropped_total
container_network_transmit_packets_dropped_total/counter
CUMULATIVE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de paquetes descartados durante la transmisión. Se tomaron muestras cada 30 segundos.

network
container_network_transmit_packets_total
container_network_transmit_packets_total/counter
CUMULATIVE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Recuento acumulativo de paquetes transmitidos. Se tomaron muestras cada 30 segundos.

network

Métricas de Kubelet

Los nombres de las métricas de Cloud Monitoring en esta tabla deben tener el prefijo prometheus.googleapis.com/. Este prefijo se omitió en las entradas de la tabla.

Nombre de la métrica de PromQL
Nombre de la métrica de Cloud Monitoring
Categoría, tipo, unidad
Recursos supervisados
Versión de GKE requerida		 Descripción
Etiquetas
kubelet_certificate_manager_server_ttl_seconds
kubelet_certificate_manager_server_ttl_seconds/gauge
GAUGE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Indicador del TTL (tiempo de actividad) más corto del certificado de entrega de Kubelet. El valor está en segundos hasta que venza el certificado (negativa si ya venció). Si el certificado de publicación no es válido o está sin usar, el valor será +INF. Se tomaron muestras cada 30 segundos.

 
kubelet_node_name
kubelet_node_name/gauge
GAUGE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		El nombre del nodo. El recuento es siempre 1. Se tomaron muestras cada 30 segundos.

node
kubelet_pleg_relist_duration_seconds
kubelet_pleg_relist_duration_seconds/histogram
CUMULATIVE, DISTRIBUTION, s
prometheus_target
1.29.3-gke.1093000 		Duración en segundos para volver a mostrar los Pods en PLEG. Se tomaron muestras cada 30 segundos.

 
kubelet_pod_worker_duration_seconds
kubelet_pod_worker_duration_seconds/histogram
CUMULATIVE, DISTRIBUTION, s
prometheus_target
1.29.3-gke.1093000 		Duración en segundos para sincronizar un solo Pod. Desglosado por tipo de operación: crear, actualizar o sincronizar. Se tomaron muestras cada 30 segundos.

operation_type
kubelet_running_containers
kubelet_running_containers/gauge
GAUGE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Cantidad de contenedores que se ejecutan actualmente. Se tomaron muestras cada 30 segundos.

container_state
kubelet_running_pods
kubelet_running_pods/gauge
GAUGE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Cantidad de Pods que tienen una zona de pruebas de Pods en ejecución. Se tomaron muestras cada 30 segundos.

 
kubelet_runtime_operations_total
kubelet_runtime_operations_total/counter
CUMULATIVE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Cantidad acumulativa de operaciones del entorno de ejecución por tipo de operación. Se tomaron muestras cada 30 segundos.

operation_type
kubelet_volume_stats_available_bytes
kubelet_volume_stats_available_bytes/gauge
GAUGE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Cantidad de bytes disponibles en el volumen. Se tomaron muestras cada 30 segundos.

namespace
persistentvolumeclaim
kubelet_volume_stats_capacity_bytes
kubelet_volume_stats_capacity_bytes/gauge
GAUGE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Capacidad en bytes del volumen. Se tomaron muestras cada 30 segundos.

namespace
persistentvolumeclaim
kubelet_volume_stats_inodes
kubelet_volume_stats_inodes/gauge
GAUGE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Cantidad máxima de inodos en el volumen. Se tomaron muestras cada 30 segundos.

namespace
persistentvolumeclaim
kubelet_volume_stats_inodes_free
kubelet_volume_stats_inodes_free/gauge
GAUGE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Cantidad de inodos libres en el volumen. Se tomaron muestras cada 30 segundos.

namespace
persistentvolumeclaim
kubelet_volume_stats_inodes_used
kubelet_volume_stats_inodes_used/gauge
GAUGE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Cantidad de inodos usados en el volumen. Se tomaron muestras cada 30 segundos.

namespace
persistentvolumeclaim
kubelet_volume_stats_used_bytes
kubelet_volume_stats_used_bytes/gauge
GAUGE, DOUBLE, 1
prometheus_target
1.29.3-gke.1093000 		Cantidad de bytes usados en el volumen. Se tomaron muestras cada 30 segundos.

namespace
persistentvolumeclaim