Container Service for Kubernetes:Konfigurasikan horizontal pod autoscaling dengan metrik Prometheus

Opsi A: Gunakan metrik bawaan ACK

Prometheus Service diinstal secara default di ACK dan mengumpulkan metrik termasuk:

• Metrik kontainer cAdvisor

• Metrik infrastruktur Node Exporter

• Metrik GPU Exporter

• Metrik tambahan apa pun yang telah Anda hubungkan ke Prometheus Service

Untuk melihat semua metrik yang terhubung:

1. Login ke Konsol ACK. Di panel navigasi kiri, klik Clusters.

2. Di halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, pilih Operations > Prometheus Monitoring.

3. Di pojok kanan atas, klik Alert Settings . Jika tautan tersebut tidak muncul, perbarui Managed Service for Prometheus ke versi terbaru. Lihat Prasyarat.

4. Di konsol Prometheus Service, klik Settings di panel navigasi kiri untuk melihat semua metrik yang terhubung.

Opsi B: Ekspos metrik kustom dari pod

Jika aplikasi Anda mengekspos metrik dalam format Prometheus, ambil metrik tersebut dengan ServiceMonitor. Contoh ini menerapkan aplikasi sampel yang mengekspos http_requests_total dan mengonfigurasi pengambilan metrik.

Perbarui konfigurasi adapter

1. Login ke Konsol ACK. Di panel navigasi kiri, klik Clusters.

2. Klik nama kluster Anda. Di panel navigasi kiri, klik Applications > Helm.

3. Temukan ack-alibaba-cloud-metrics-adapter dan klik Update di kolom Actions.

4. Di panel Update Release, perbarui YAML dengan konfigurasi Anda dan klik OK.

   Detail YAML

   AlibabaCloudMetricsAdapter:
   ......
     prometheus:
       enabled: true    # Aktifkan adapter Prometheus.
       # URL permintaan data Prometheus Service. Lihat "Dapatkan URL permintaan data Prometheus" di bawah.
       url: https://cn-beijing.arms.aliyuncs.com:9443/api/v1/prometheus/xxxx/xxxx/xxxx/cn-beijing
       # Prometheus V1 dengan autentikasi token diaktifkan:
       prometheusHeader:
       - Authorization: {Token}
       # Prometheus V2 tanpa akses bebas password (hapus komentar dan ganti blok V1 di atas):
       # prometheusHeader:
       # - Authorization: Basic <base64Encode(<accessKey:secretKey>)>
       metricsRelistInterval: 1m  # Interval untuk menyegarkan daftar metrik. Gunakan nilai default.
       logLevel: 5                # Tingkat log debug. Gunakan nilai default.
       adapter:
         rules:
           default: false  # Jangan ekspos metrik yang telah ditentukan sebelumnya secara default.
           custom:
           # Contoh: konversi container_memory_working_set_bytes menjadi container_memory_working_set_bytes_per_second
           - seriesQuery: 'container_memory_working_set_bytes{namespace!="",pod!=""}'
             resources:
               overrides:
                 namespace: { resource: "namespace" }
                 pod: { resource: "pod" }
             name:
               matches: "^(.*)_bytes"
               as: "${1}_bytes_per_second"
             metricsQuery: 'sum(<<.Series>>{<<.LabelMatchers>>}) by (<<.GroupBy>>)'
           # Contoh: konversi container_cpu_usage_seconds_total menjadi container_cpu_usage_core_per_second
           - seriesQuery: 'container_cpu_usage_seconds_total{namespace!="",pod!=""}'
             resources:
               overrides:
                 namespace: { resource: "namespace" }
                 pod: { resource: "pod" }
             name:
               matches: "^(.*)_seconds_total"
               as: "${1}_core_per_second"
             metricsQuery: 'sum(rate(<<.Series>>{<<.LabelMatchers>>}[1m])) by (<<.GroupBy>>)'
           # Contoh: konversi http_requests_total menjadi http_requests_per_second
           - seriesQuery: 'http_requests_total{namespace!="",pod!=""}'
             resources:
               overrides:
                 namespace: {resource: "namespace"}
                 pod: {resource: "pod"}
             name:
               matches: "^(.*)_total"
               as: "${1}_per_second"
             metricsQuery: 'sum(rate(<<.Series>>{<<.LabelMatchers>>}[2m])) by (<<.GroupBy>>)'
   ......

Tabel berikut mencantumkan bidang utama adapter. Untuk referensi lengkap, lihat Referensi konfigurasi adapter.

Verifikasi adapter berfungsi

Jalankan perintah berikut untuk memastikan adapter mengekspos metrik melalui Kubernetes aggregation API.

Periksa Custom Metrics:

# Daftar semua Custom Metrics yang tersedia
kubectl get --raw "/apis/custom.metrics.k8s.io/v1beta1/" | jq .

# Kueri container_memory_working_set_bytes_per_second untuk pod di kube-system
kubectl get --raw "/apis/custom.metrics.k8s.io/v1beta1/namespaces/kube-system/pods/*/container_memory_working_set_bytes_per_second" | jq .

# Kueri container_cpu_usage_core_per_second untuk pod di kube-system
kubectl get --raw "/apis/custom.metrics.k8s.io/v1beta1/namespaces/kube-system/pods/*/container_cpu_usage_core_per_second" | jq .

Respons yang berhasil terlihat seperti:

{
  "kind": "MetricValueList",
  "apiVersion": "custom.metrics.k8s.io/v1beta1",
  "metadata": {
    "selfLink": "/apis/custom.metrics.k8s.io/v1beta1/namespaces/kube-system/pods/%2A/container_cpu_usage_core_per_second"
  },
  "items": [
    {
      "describedObject": {
        "kind": "Pod",
        "namespace": "kube-system",
        "name": "ack-cost-exporter-7f44d55c66-cgtz7",
        "apiVersion": "/v1"
      },
      "metricName": "container_cpu_usage_core_per_second",
      "timestamp": "2025-12-30T03:30:21Z",
      "value": "4m",
      "selector": null
    }
  ]
}

Respons ini mengonfirmasi bahwa adapter telah menemukan dan mengaitkan metrik dengan pod yang benar. Larik items mencantumkan satu entri per pod. Bidang value menggunakan akhiran m (satuan mili), sehingga 4m berarti 0,004 core CPU per detik.

Periksa Metrik Eksternal:

# Daftar semua External Metrics yang tersedia
kubectl get --raw "/apis/external.metrics.k8s.io/v1beta1/" | jq .

# Kueri http_requests_per_second di namespace default
kubectl get --raw "/apis/external.metrics.k8s.io/v1beta1/namespaces/default/http_requests_per_second" | jq .

Respons yang berhasil terlihat seperti:

{
  "kind": "ExternalMetricValueList",
  "apiVersion": "external.metrics.k8s.io/v1beta1",
  "metadata": {},
  "items": [
    {
      "metricName": "http_requests_per_second",
      "metricLabels": {},
      "timestamp": "2025-12-30T03:29:40Z",
      "value": "328m"
    }
  ]
}

Berbeda dengan Custom Metrics, respons External Metrics berisi satu nilai agregat (bukan per pod) karena metrik tersebut tidak dibatasi cakupannya pada objek Kubernetes.

Variabel templat di metricsQuery

Bidang metricsQuery adalah templat Go, bukan PromQL biasa. Adapter mengisinya dengan nilai dari permintaan HPA sebelum mengkueri Prometheus. Pembatasnya adalah << dan >> (bukan {{ dan }}) untuk menghindari konflik dengan sintaks PromQL.

Discovery

seriesQuery menentukan metrik Prometheus mana yang akan dikonversi dan menerima pemilih PromQL yang valid, termasuk filter label.

- seriesQuery: 'http_requests_total{namespace!="",pod!=""}'

Filter label namespace!="" dan pod!="" membatasi metrik hanya pada pod yang memiliki kedua label tersebut, yang merupakan persyaratan untuk asosiasi resource pada langkah berikutnya.

Untuk mempersempit seri yang cocok, tambahkan blok seriesFilters:

- seriesQuery: 'http_requests_total{namespace!="",pod!=""}'
  seriesFilters:
    - isNot: "^container_.*_seconds_total"

seriesFilters menerima dua operator:

• is:<regex>: hanya menyimpan seri yang namanya cocok dengan regex.

• isNot:<regex>: mengecualikan seri yang namanya cocok dengan regex.

Association

resources.overrides memetakan nama label Prometheus ke resource API Kubernetes. Ini memberi tahu adapter label mana yang harus dicocokkan saat HPA meminta metrik untuk pod atau namespace tertentu.

- seriesQuery: 'http_requests_total{namespace!="",pod!=""}'
  resources:
    overrides:
      namespace: {resource: "namespace"}
      pod: {resource: "pod"}

Kunci (namespace, pod) adalah nama label Prometheus. Nilai ("namespace", "pod") adalah jenis resource API Kubernetes, seperti yang tercantum di kubectl api-resources -o wide. Setiap kunci harus ada sebagai label dalam data Prometheus Anda.

Naming

name mengonversi nama metrik Prometheus menjadi nama metrik HPA menggunakan ekspresi reguler. Nama metrik Prometheus asli tetap tidak berubah.

- seriesQuery: 'http_requests_total{namespace!="",pod!=""}'
  resources:
    overrides:
      namespace: {resource: "namespace"}
      pod: {resource: "pod"}
  name:
    matches: "^(.*)_total"
    as: "${1}_per_second"

matches adalah regex yang menangkap bagian dari nama metrik Prometheus. as menentukan nama metrik HPA, menggunakan ${1} untuk mereferensikan grup tangkapan pertama. Di sini, http_requests_total menjadi http_requests_per_second.

Untuk External Metrics, konversi huruf kapital dalam nama metrik Prometheus menjadi huruf kecil dalam nama metrik HPA.

Untuk mencantumkan semua nama metrik HPA yang tersedia:

kubectl get --raw "/apis/custom.metrics.k8s.io/v1beta1"

Querying

metricsQuery menentukan ekspresi PromQL yang dikirim adapter ke Prometheus setelah mengganti variabel templat.

- seriesQuery: 'http_requests_total{namespace!="",pod!=""}'
  resources:
    overrides:
      namespace: {resource: "namespace"}
      pod: {resource: "pod"}
  name:
    matches: "^(.*)_total"
    as: "${1}_per_second"
  metricsQuery: 'sum(rate(<<.Series>>{<<.LabelMatchers>>}[2m])) by (<<.GroupBy>>)'

Pemilih label di metricsQuery disisipkan melalui <<.LabelMatchers>> saat kueri dan tidak mewarisi filter dari seriesQuery.

Alibaba Cloud Prometheus Service

1. Login ke Konsol ACK. Di panel navigasi kiri, klik Clusters.

2. Klik nama kluster Anda. Di panel navigasi kiri, pilih Operations > Prometheus Monitoring.

3. Di pojok kanan atas, klik Alert Settings . Jika tautan tersebut tidak muncul, perbarui ack-arms-prometheus ke versi terbaru. Lihat Prasyarat.

4. Di konsol Prometheus Service, klik Settings > Settings untuk menemukan HTTP API Address (Grafana Read URL) . Gunakan alamat Internal Network jika tersedia; jika tidak, gunakan alamat Internet.

   

5. Konfigurasikan autentikasi untuk versi Prometheus Anda.

   • Prometheus V1 (autentikasi token dinonaktifkan secara default): Jika diaktifkan, salin token dari konsol Prometheus dan konfigurasikan adapter.

     

     prometheus:
       prometheusHeader:
       - Authorization: {Token}

   • Prometheus V2 (autentikasi AccessKey diaktifkan secara default): Jika akses bebas password tidak diaktifkan, encode AccessKey ID dan Rahasia AccessKey Anda dalam Base64.

     1. Hasilkan string yang diencode Base64.

        Gabungkan AccessKey ID dan Rahasia AccessKey Anda sebagai AccessKey:AccessSecret, lalu encode Base64:

        echo -n 'accessKey:secretKey' | base64

     2. Konfigurasikan komponen.

        Masukkan string yang dihasilkan dalam format Basic <encoded string> ke bidang Authorization dari prometheusHeader.

        ...
            prometheus:
              prometheusHeader:
              - Authorization: Basic YWxxxxeQ==
        ...

Prometheus open source

Untuk Prometheus yang dikelola sendiri, ekspos API-nya melalui Service Kubernetes dan atur URL Service tersebut di konfigurasi adapter.

Contoh ini menggunakan chart Helm ack-prometheus-operator dari Marketplace ACK. Lihat Pemantauan Prometheus open source.

1. Terapkan ack-prometheus-operator.

   1. Login ke Konsol ACK. Di panel navigasi kiri, pilih Marketplace > Marketplace.

   2. Cari ack-prometheus-operator, klik kartunya, lalu klik Deploy.

   3. Pilih Cluster dan Namespace, atur Release Name, lalu klik Next. Sesuaikan Parameters sesuai kebutuhan dan klik OK.

2. Verifikasi penerapan.

   1. Ekspos API Prometheus melalui Service. Contoh ini menggunakan Service ack-prometheus-operator-prometheus.

   2. Di browser, buka ServiceIP:9090. Untuk akses publik, ekspos Service melalui instance SLB.

   3. Di konsol Prometheus, klik Status > Targets untuk melihat semua job pengambilan. Jika semua job menunjukkan State UP, pengambilan berfungsi dengan benar.

   4. Catat nama Service dan namespace dari kolom Labels. Di sini, Service-nya adalah ack-prometheus-operator-prometheus di namespace monitoring.

3. Atur URL Prometheus di adapter. Untuk akses internal:

   AlibabaCloudMetricsAdapter:
     prometheus:
       enabled: true
       url: http://ack-prometheus-operator-prometheus.monitoring.svc.cluster.local:9090

   Untuk akses publik:

   AlibabaCloudMetricsAdapter:
     prometheus:
       enabled: true
       url: http://your_domain.com:9090   # Ganti dengan alamat IP publik atau domain Anda.

Untuk menambahkan sumber data Prometheus, lihat Tambahkan sumber data Prometheus di Grafana.