Anda dapat menggunakan Prometheus Query Language (PromQL) untuk mengkueri data pemantauan Prometheus guna memverifikasi akurasi dan ketepatan waktu aturan alert Anda.
Kueri data pemantauan Prometheus di konsol
Managed Service for Prometheus
Untuk informasi selengkapnya tentang cara men-deploy dan menggunakan Managed Service for Prometheus, lihat Menghubungkan dan mengonfigurasi Managed Service for Prometheus.
-
Masuk ke Konsol ARMS.
-
Di panel navigasi sebelah kiri, pilih .
-
Di pojok kiri atas halaman Prometheus Monitoring, pilih wilayah tempat kluster Container Service for Kubernetes (ACK) Anda berada. Temukan instance yang dituju, lalu klik Shared Edition pada kolom Grafana Workspace.
-
Di panel navigasi sebelah kiri dasbor, klik ikon
. Di pojok kiri atas, pilih sumber data dari daftar drop-down di sebelah kanan Explore. -
Pada kotak teks di sebelah kanan Metric, masukkan kueri PromQL, lalu klik Run query.
Open source Prometheus
Untuk informasi selengkapnya tentang cara men-deploy open source Prometheus pada kluster ACK, lihat Pemantauan open source Prometheus.
-
Masuk ke Konsol ACK. Di panel navigasi kiri, klik Clusters.
-
Di halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik .
-
Di halaman Services, pilih namespace monitoring tempat ack-prometheus-operator dideploy. Pada kolom Actions untuk ack-prometheus-operator-prometheus, klik Update.
-
Pada kotak dialog, atur Type menjadi LoadBalancer. Pilih Create Resource, atur Access Method menjadi Public Access, dan atur Billing Method menjadi Pay-as-you-go (Pay-by-CU). Klik OK.
Lihat Ikhtisar Penagihan CLB.
-
Setelah pembaruan selesai, salin alamat IP eksternal. Buka UI Prometheus di
<external_IP_address>:9090, misalnya,47.XX.XX.12:9090. -
Di konsol Prometheus, klik tab Graph. Di kotak teks, masukkan kueri PromQL, lalu klik Execute.
Kueri data pemantauan melalui API
Managed Service for Prometheus
Masuk ke Konsol ARMS.
-
Di panel navigasi kiri, pilih .
-
Di bagian atas halaman Instance, pilih wilayah tempat instance Prometheus Anda berada. Temukan instance yang dituju, lalu klik Settings pada kolom Actions.
-
Di halaman Settings, pada bagian HTTP API Address (Grafana Read Address), salin URL HTTP API publik atau internal.
-
Untuk instance V1, jika Anda perlu meningkatkan keamanan pembacaan data di Grafana, klik Generate token untuk mendapatkan token otentikasi untuk instance Prometheus tersebut.
Penting-
Instance V1: Setelah Anda membuat token, Anda harus mengonfigurasikannya saat menambahkan sumber data di Grafana. Jika tidak, data pemantauan tidak dapat dibaca dari instance Prometheus.
-
Instance V2: Secara default, Anda harus menggunakan ID AccessKey dan Rahasia AccessKey akun Anda untuk mengakses data. Pengguna RAM yang memiliki ID AccessKey tersebut harus memiliki izin sistem AliyunPrometheusMetricReadAccess atau AliyunCloudMonitorFullAccess.
-
-
Gunakan HTTP API untuk mengkueri data pemantauan Prometheus.
Kode berikut merupakan contoh permintaan. Untuk informasi selengkapnya tentang cara menggunakan HTTP API untuk mendapatkan data pemantauan Prometheus, lihat HTTP API.
V1
GET {HTTP API URL}/api/v1/query Accept: application/json Content-Type: application/json Authorization: {Token} { "query":"arms_prometheus_target_interval_length_seconds_sum", "time":"1635302655", "timeout":"1000" }V2
GET {HTTP API URL}/api/v1/query Accept: application/json Content-Type: application/json Authorization: Basic <base64Encode(<AccessKey ID:AccessKey secret>)> { "query":"arms_prometheus_target_interval_length_seconds_sum", "time":"1635302655", "timeout":"1000" }
Open source Prometheus
-
Dapatkan URL HTTP API.
Jika Anda mengakses open source Prometheus dari dalam kluster, URL default layanan permintaan data untuk ack-prometheus-operator adalah
http://ack-prometheus-operator-prometheus.monitoring:9090.Jika Anda menggunakan akses publik untuk open source Prometheus, sambungkan instance Classic Load Balancer (CLB) ke layanan permintaan data untuk ack-prometheus-operator dengan mengikuti langkah-langkah berikut:
-
Masuk ke Konsol ACK. Di panel navigasi kiri, klik Clusters.
-
Di halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik .
-
Di bagian atas halaman Services, atur Namespace menjadi monitoring. Temukan ack-prometheus-operator-prometheus, lalu klik Update pada kolom Actions.
-
Pada kotak dialog Update Service, konfigurasikan parameter berikut, lalu klik Update.
Parameter
Konfigurasi
Service Type
Atur Service Type menjadi LoadBalancer dan atur metode akses menjadi Public Access.
Port Mapping
Masukkan nama port. Atur Service Port menjadi 9090, Container Port menjadi 9090, dan Protocol menjadi TCP.
-
Di halaman Services, klik layanan ack-prometheus-operator-prometheus. Di bagian Basic Information, dapatkan External IP. Ini adalah URL HTTP API.
-
-
Gunakan HTTP API untuk mengkueri data pemantauan Prometheus.
-
Dapatkan data pemantauan instan.
GET {HTTP API}/api/v1/query Headers: Accept: application/json Content-Type: application/json Param: { "query":"{{PromQL}}", "time":"1635302655", "timeout":"1000" }-
time: menentukan titik waktu untuk mengkueri data.
-
timeout: menentukan batas waktu dalam milidetik. Jika kueri melebihi batas waktu ini, hasil saat ini akan dikembalikan.
-
-
Kueri data pemantauan dalam rentang waktu tertentu.
GET {HTTP API}/api/v1/query_range Headers: Accept: application/json Content-Type: application/json Param: { "query":"{{PromQL}}", "start": 1673946024, "end": 1673949624, "step": 30 }-
start: menentukan waktu mulai kueri.
-
end: menentukan waktu akhir kueri.
-
step: menentukan interval waktu antar titik data dalam data pemantauan yang dikembalikan.
-
-
Dokumen terkait
Untuk membuat aturan alert menggunakan kueri PromQL kustom, lihat Praktik terbaik untuk mengonfigurasi aturan alert menggunakan Prometheus.