Alibaba Cloud Managed Service for Prometheus menyediakan URL API HTTP yang memungkinkan Anda mengakses data pemantauan Prometheus dari Grafana atau mengambil data menggunakan API Prometheus untuk pengembangan kustom.
Prasyarat
Anda telah mengintegrasikan sumber data dengan Prometheus. Untuk informasi lebih lanjut, lihat topik berikut:
Langkah 1: Dapatkan URL API HTTP
-
Masuk ke Konsol CloudMonitor. Di bilah navigasi kiri, pilih Prometheus Monitoring > Instance List untuk membuka halaman Instance List.
-
Di bilah navigasi atas, pilih Prometheus tempat instans Prometheus ditempatkan. Temukan instans target dan klik Settings di kolom Actions.
-
Di tab Settings, salin URL API HTTP untuk jaringan publik atau internal sesuai kebutuhan.
Anda juga dapat mengklik Generate token untuk meningkatkan keamanan pembacaan data.
-
Untuk instans Prometheus V1, jika Anda perlu meningkatkan keamanan pembacaan data di Grafana, klik Generate token untuk mendapatkan token otentikasi untuk instans Prometheus tersebut.
Penting-
Instans V1: Setelah membuat token, Anda harus mengonfigurasikannya saat menambahkan sumber data di Grafana. Jika tidak, data pemantauan tidak dapat dibaca dari instans Prometheus.
-
Instans 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.
-
Langkah 2: Tambahkan sumber data di Grafana
Grafana yang Dikelola Sendiri
Bagian ini menggunakan Grafana v10.x sebagai contoh. Untuk informasi tentang cara menambahkan sumber data di versi lain, lihat dokumentasi resmi Grafana.
-
Konfigurasikan sumber data Grafana.
-
Masuk ke Grafana yang Anda kelola sendiri sebagai administrator.
-
Di pojok kiri atas halaman, klik ikon menu
dan pilih Administration > Data sources. -
Klik + Add new data source dan pilih Prometheus sebagai jenis sumber data.
-
Di tab Settings, masukkan nama kustom di bidang Name. Di bidang Prometheus server URL, tempel URL API HTTP yang Anda peroleh di Langkah 1.
-
Konfigurasikan otentikasi.
Instans V1 (opsional)
Klik + Add header. Di bagian Custom HTTP Headers, klik +Add header, atur Header menjadi Authorization, dan atur Value menjadi token otentikasi yang diperoleh di Langkah 1.
Instans V2
Aktifkan Basic auth. Atur User menjadi ID AccessKey Anda dan Password menjadi rahasia AccessKey Anda.
-
-
Di bagian bawah halaman, klik Save & Test.
-
Kueri metrik Prometheus.
-
Masuk ke sistem Grafana Anda.
-
Di pojok kiri atas halaman, klik ikon menu
lalu klik Dashboards di panel navigasi kiri. -
Di halaman Dashboards, klik New di pojok kanan atas, lalu klik New dashboard di menu tarik-turun.
-
Klik + Add visualization. Di halaman Select data source, pilih sumber data yang telah Anda buat.
-
Di halaman Edit Panel, buka tab Query. Di bagian A, masukkan nama dan nilai metrik di bidang Metrics dan Label filters, lalu klik Run queries.
Jika grafik untuk metrik tersebut muncul, berarti pengaturan berhasil. Jika tidak, pastikan URL API dan token sudah benar serta sumber data berisi data pemantauan Prometheus.

-
Managed Service for Grafana
Managed Service for Grafana menyediakan integrasi satu-klik untuk sumber data dan dasbor Prometheus.
-
Masuk ke Konsol ARMS. Di panel navigasi kiri, pilih Managed Service for Grafana > Workspace Management, lalu klik ID ruang kerja Anda.
-
Di halaman Workspace Information, temukan bagian Cloud Service Integration dan klik Prometheus Monitoring Service. Lalu, temukan instans Anda dan klik Integrate.
-
Pada kotak dialog yang muncul, klik OK.
Jika Anda mengintegrasikan instans Prometheus V2, Anda harus memasukkan ID AccessKey untuk sumber data tersebut.
-
Setelah sinkronisasi selesai, klik ikon folder di sebelah kanan.
-
Di Grafana, pada tab Dashboards, klik nama dasbor untuk melihat dasbor default bawaan untuk pemantauan aplikasi.
-
Di pojok kiri atas halaman, klik ikon menu
dan pilih Administration > Data sources untuk melihat sumber data pemantauan aplikasi yang telah ditambahkan. -
Kueri metrik Prometheus.
-
Masuk ke sistem Grafana Anda.
-
Di pojok kiri atas halaman, klik ikon menu
lalu klik Dashboards di panel navigasi kiri. -
Di halaman Dashboards, klik New di pojok kanan atas, lalu klik New dashboard di menu tarik-turun.
-
Klik + Add visualization. Di halaman Select data source, pilih sumber data yang telah Anda buat.
-
Di halaman Edit Panel, buka tab Query. Di bagian A, masukkan nama dan nilai metrik di bidang Metrics dan Label filters, lalu klik Run queries.
Jika grafik untuk metrik tersebut muncul, berarti pengaturan berhasil. Jika tidak, pastikan URL API dan token sudah benar serta sumber data berisi data pemantauan Prometheus.

-
Langkah 3: Ambil data Prometheus
Kode berikut menunjukkan contoh permintaan untuk mengambil data pemantauan Prometheus. Untuk informasi lebih lanjut tentang penggunaan API HTTP, lihat dokumentasi API HTTP Prometheus open-source.
Instans 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"
}
Ganti {HTTP API URL} dan {Token} dengan URL API HTTP dan token otentikasi yang Anda peroleh di Langkah 1.
Instans 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"
}
-
Ganti
{HTTP API URL}dengan URL API HTTP yang Anda peroleh di Langkah 1. -
API ini mendukung otentikasi STS. Jika Anda menggunakan metode ini, rahasia AccessKey dalam
BasicAuthharus dalam format berikut:{AccessKey secret}${STS Token}. Untuk informasi lebih lanjut, lihat Apa itu STS?.
Contoh respons: