Cloud-controller-manager: Metrik dan dasbor pemantauan - Container Service for Kubernetes

Add-on cloud-controller-manager memungkinkan komponen inti Kubernetes berinteraksi dengan penyedia cloud melalui API Kubernetes. Topik ini mencantumkan metriknya, menjelaskan cara menggunakan dasbor pemantauan, serta menganalisis anomali metrik umum.

Sebelum memulai

Akses dasbor

Lihat Lihat dasbor pemantauan untuk komponen lapisan kontrol.

Daftar metrik

Komponen cloud-controller-manager mengekspos metrik berikut.

Metric	Type	Description
ccm_slb_latency_ms	Histogram	Latensi sinkronisasi Classic Load Balancer (CLB). Satuan: ms. Ambang batas bucket: `{100, 200, 300, 400, 500, 600, 700, 800, 900, 1000,1500, 2000, 3000, 4000, 5000, 6000, 7000, 8000, 9000, 10000}`.
ccm_node_latency_ms	Histogram	Latensi sinkronisasi node. Satuan: ms. Ambang batas bucket: `{100, 200, 300, 400, 500, 600, 700, 800, 900, 1000,1500, 2000, 3000, 4000, 5000, 6000, 7000, 8000, 9000, 10000}`.
ccm_route_latency_ms	Histogram	Latensi sinkronisasi route. Satuan: ms. Ambang batas bucket: `{100, 200, 300, 400, 500, 600, 700, 800, 900, 1000,1500, 2000, 3000, 4000, 5000, 6000, 7000, 8000, 9000, 10000}`.
workqueue_adds_total	Counter	Total event yang ditambahkan ke Workqueue.
workqueue_depth	Gauge	Kedalaman Workqueue saat ini. Nilai tinggi yang berkelanjutan menunjukkan bahwa controller tidak dapat memproses tugas dengan cukup cepat, sehingga menyebabkan penumpukan antrian.
workqueue_queue_duration_seconds_bucket	Histogram	Durasi waktu suatu item menunggu di Workqueue. Ambang batas bucket: {10^-8, 10^-7, 10^-6, 10^-5, 10^-4, 10^-3, 10^-2, 10^-1, 1, 10}. Satuan: detik.
memory_utilization_byte	Gauge	Penggunaan memory. Satuan: byte.
cpu_utilization_core	Gauge	Penggunaan CPU. Satuan: cores.
resource_utilization_level	Gauge	Tingkat pemanfaatan resource. resource: Jenis resource. Nilai yang valid: `cpu` dan `memory`. utilization_level: Tingkat pemanfaatan. Nilai yang valid: `high` (pemanfaatan ≥ 80%) dan `normal` (pemanfaatan < 80%). container: Kontainer target. Nilai yang valid: `kube-apiserver`, `kube-scheduler`, `kube-controller-manager`, `cloud-controller-manager`, dan `etcd`.
rest_client_requests_total	Counter	Total permintaan HTTP berdasarkan status code, method, dan host.
rest_client_request_duration_seconds_bucket	Histogram	Latensi permintaan HTTP berdasarkan verb dan URL.

Catatan

Metrik pemanfaatan sumber daya berikut ini tidak lagi digunakan. Hapus semua alert atau aturan pemantauan yang mengandalkan metrik ini:

cpu_utilization_ratio: CPU utilization.
memory_utilization_ratio: Memory utilization.

Dasbor

Panel berbasis PromQL memvisualisasikan metrik komponen.

CCM

Tampilan observabilitas

Rincian panel

Panel name	PromQL	Description
Route synchronization latency	histogram_quantile($quantile, sum(rate(ccm_route_latencies_duration_milliseconds_bucket[$interval])) by (verb, le))	Latensi sinkronisasi route. Satuan: ms.
Node synchronization latency	histogram_quantile($quantile, sum(rate(ccm_node_latencies_duration_milliseconds_bucket[$interval])) by (verb, le))	Latensi sinkronisasi node. Satuan: ms.
CLB (Classical Load Balancer) Synchronization Latency	histogram_quantile($quantile, sum(rate(ccm_slb_latencies_duration_milliseconds_bucket[$interval])) by (verb, le))	Latensi sinkronisasi CLB. Satuan: ms.

Queue

Tampilan observabilitas

Rincian panel

Panel name	PromQL	Description
Workqueue add rate	sum(rate(workqueue_adds_total{job="ack-cloud-controller-manager"}[$interval])) by (name)	Laju event yang ditambahkan ke Workqueue.
Workqueue depth	workqueue_depth{job="ack-cloud-controller-manager"}	Laju rata-rata perubahan Workqueue depth.
Latensi pemrosesan Workqueue	histogram_quantile($quantile, sum(rate(workqueue_queue_duration_seconds_bucket{job="ack-cloud-controller-manager"}[$interval])) by (name, le))	Waktu yang diperlukan suatu item menunggu di Workqueue.

Resources

Tampilan Observabilitas

Detail Panel

Nama panel	PromQL	Deskripsi
Memory usage	memory_utilization_byte{container="cloud-controller-manager"}	Pemanfaatan memori. Satuan: byte.
CPU Usage	cpu_utilization_core{container="cloud-controller-manager"}*1000	Pemanfaatan CPU. Satuan: millicore.
Memory utilization level	resource_utilization_level{resource="memory",container="cloud-controller-manager",utilization_level="high"} resource_utilization_level{resource="memory",container="cloud-controller-manager",utilization_level="normal"}	Jika `resource_utilization_level{utilization_level="high",...}` bernilai 1, tingkat pemanfaatan resource kontainer ≥ 80%. Jika `resource_utilization_level{utilization_level="normal",...}` bernilai 1, tingkat pemanfaatan resource kontainer < 80%.
CPU utilization level	resource_utilization_level{resource="cpu",container="cloud-controller-manager",utilization_level="high"} resource_utilization_level{resource="cpu",container="cloud-controller-manager",utilization_level="normal"}

Kube API

Tampilan observabilitas

Rincian panel

Panel name	PromQL	Description
Kube API request QPS	sum(rate(rest_client_requests_total{job="ack-cloud-controller-manager",code=~"2.."}[$interval])) by (method,code) sum(rate(rest_client_requests_total{job="ack-cloud-controller-manager",code=~"3.."}[$interval])) by (method,code) sum(rate(rest_client_requests_total{job="ack-cloud-controller-manager",code=~"4.."}[$interval])) by (method,code) sum(rate(rest_client_requests_total{job="ack-cloud-controller-manager",code=~"5.."}[$interval])) by (method,code)	QPS permintaan HTTP dari cloud-controller-manager ke kube-apiserver, berdasarkan metode dan kode status.

Anomali metrik umum

Latensi sinkronisasi Classic Load Balancer (CLB)

Kondisi normal	Kondisi abnormal	Deskripsi	Rekomendasi
Latensi sinkronisasi CLB (Classical Load Balancer) ≤ 10 detik.	Latensi sinkronisasi CLB (Classical Load Balancer) melebihi 10 detik.	Sinkronisasi CLB memakan waktu terlalu lama.	Periksa Service untuk event abnormal.

Kedalaman Workqueue

Kondisi normal	Kondisi abnormal	Deskripsi	Rekomendasi
Kedalaman workqueue ≤ 10.	Kedalaman workqueue melebihi 10.	Antrean besar item yang menunggu sinkronisasi.	Antrean yang terlalu panjang memperlambat sinkronisasi Service. Kurangi frekuensi perubahan pada node, Pod, dan Service di kluster.

Dokumentasi terkait

Untuk komponen lapisan kontrol lainnya, lihat metrik pemantauan kube-apiserver, metrik pemantauan etcd, metrik pemantauan kube-scheduler, dan metrik pemantauan kube-controller-manager.