Kompatibel dengan Grafana sumber terbuka dan Prometheus, Application Real-Time Monitoring Service (ARMS) menyediakan solusi observabilitas berbasis Grafana dan Prometheus untuk mendukung pembuatan dasbor kustom. Topik ini menjelaskan cara membuat dasbor Grafana kustom serta cara menulis pernyataan kueri untuk mengimpor data ke dasbor.
Informasi Latar Belakang
Managed Service for Prometheus mengintegrasikan data pemantauan Application Monitoring untuk memvisualisasikan metrik. Anda dapat mengakses data pemantauan aplikasi, melihat dasbor preset, dan melakukan pengembangan sekunder sesuai kebutuhan bisnis di Managed Service for Prometheus.
Prasyarat
Application Monitoring secara otomatis membuat instans Prometheus gratis di wilayah tempat aplikasi diterapkan. Seperti yang ditunjukkan pada gambar berikut, semua metrik aplikasi yang dipantau di wilayah China (Hangzhou) disimpan dalam instans Prometheus bernama arms_metrics_cn-hangzhou_cloud_hangzhou.
Skenario
Anda ingin membuat ulang dasbor berdasarkan metrik Application Monitoring.
Dalam operasi & pemeliharaan harian, Anda ingin menggabungkan metrik Application Monitoring dengan metrik dari sumber data lain untuk membuat dasbor khusus.
Di awal jam puncak, Anda ingin menggabungkan metrik Application Monitoring dengan metrik layanan hulu atau hilir untuk membuat dasbor khusus.
Anda dapat melihat data pemantauan aplikasi yang diperoleh di Managed Service for Prometheus dalam sistem Grafana yang dikelola sendiri.
Anda dapat menggunakan data pemantauan aplikasi yang diperoleh di Managed Service for Prometheus untuk pengembangan sekunder.
Prasyarat
Sebuah agen ARMS telah diinstal untuk aplikasi. Untuk informasi lebih lanjut, lihat Ikhtisar Pemantauan Aplikasi.
Grafana telah diinstal di komputer lokal Anda atau sebuah Managed Service for Grafana ruang kerja telah dibuat.
Buat Dasbor Kustom
Langkah 1: Integrasikan data pemantauan aplikasi Application Monitoring ke Grafana
Secara default, Managed Service for Prometheus mengintegrasikan data pemantauan Application Monitoring. Anda hanya perlu mengintegrasikan instans Prometheus yang digunakan untuk menyimpan data pemantauan aplikasi Anda ke Grafana.
Tambahkan Sumber Data ke Sistem Grafana yang Dikelola Sendiri
Peroleh alamat API HTTP dari instans Prometheus.
Masuk ke Konsol ARMS. Di panel navigasi sisi kiri, pilih . Di bilah navigasi atas, pilih wilayah tempat aplikasi diterapkan.
Instans bertipe Prometheus Instance for Application Monitoring digunakan untuk menyimpan data pemantauan aplikasi yang dipantau di Application Monitoring.

Klik nama instans Prometheus tersebut. Di halaman yang muncul, klik Pengaturan di panel navigasi sisi kiri untuk melihat alamat API HTTP.

Opsional. Klik Generate Token untuk mendapatkan token otentikasi untuk instans Prometheus. Token digunakan untuk memastikan keamanan data ketika data pemantauan diimpor ke Grafana.
PentingSetelah token otentikasi dibuat, Anda harus menentukan token saat menambahkan instans Prometheus ke sistem Grafana sebagai sumber data. Jika tidak, data pemantauan tidak dapat dibaca dari instans Prometheus.
Tambahkan instans Prometheus sebagai sumber data ke sistem Grafana.
Dalam contoh ini, Grafana 10.x digunakan. Untuk informasi tentang cara menambahkan sumber data di versi Grafana lainnya, lihat Dokumentasi Grafana.
Masuk ke sistem Grafana sebagai administrator.
Arahkan pointer ke ikon
di sudut kiri atas dan klik Data sources.Klik Add data source dan pilih Prometheus sebagai tipe sumber data.
Di tab Settings, masukkan nama kustom di bidang Name dan masukkan alamat API HTTP yang diperoleh pada langkah sebelumnya di bidang Prometheus server URL bagian HTTP.

Opsional. Di bagian Custom HTTP Headers, klik + Add header. Atur parameter Header menjadi Authorization dan parameter Value menjadi token yang dihasilkan pada langkah sebelumnya.

Klik Save & test.
Tambahkan Sumber Data ke Managed Service for Grafana
Anda dapat mengintegrasikan data pemantauan aplikasi yang dipantau di Application Monitoring ke Managed Service for Grafana.
Masuk ke Konsol ARMS. Di panel navigasi sisi kiri, pilih . Di halaman Manajemen Ruang Kerja, klik ID ruang kerja.
Di halaman Workspace Information, klik ARMS Application Monitoring di bagian Cloud Service Integration. Temukan instans Prometheus di wilayah tujuan dan klik Integrations di kolom Actions.
Di pesan yang muncul, klik OK.
Setelah sinkronisasi selesai, klik Folder di kolom Actions.
Di tab Dashboards halaman yang muncul, klik nama dasbor untuk melihat dasbor Pemantauan Aplikasi yang telah diatur sebelumnya.

Arahkan pointer ke ikon
di sudut kiri atas dan klik Data sources untuk melihat sumber data.
Langkah 2: Buat Dasbor Kustom
Arahkan pointer ke ikon
di sudut kiri atas dan klik Dasbor.Di halaman Dasbor, klik New Dashboard. Di halaman Dasbor Baru, klik Tambah Panel Kosong untuk membuat panel dasbor.
Di kotak dialog Pilih Sumber Data, pilih sumber data. Format default nama sumber data adalah arms_metrics_{regionid}_cloud.
PentingPastikan data tersedia di sumber data saat ini.
Konfigurasikan parameter kueri berikut di bagian A.
Tentukan Pernyataan Kueri PromQL
Dalam mode Kode, masukkan pernyataan PromQL di sebelah kanan Metrics browser.

Di halaman detail aplikasi di modul Pemantauan Aplikasi, temukan metrik dan klik ikon
untuk melihat pernyataan PromQL yang sesuai dengan metrik. Untuk informasi lebih lanjut, lihat Ikhtisar Aplikasi.
Untuk informasi lebih lanjut tentang pernyataan PromQL, lihat Dokumentasi Prometheus.
Tentukan Metrik Aplikasi
Dalam mode Pembuat, pilih metrik dari daftar drop-down Metric, seperti
arms_jvm_threads_count, untuk menanyakan jumlah thread JVM. Untuk informasi tentang metrik yang didukung oleh Pemantauan Aplikasi, lihat Metrik Pemantauan Aplikasi.Di bagian Label filters, tentukan label dan nilai.

Di tab Panel di sebelah kanan, atur judul panel dan pilih jenis grafik.
CatatanAnda dapat memilih beberapa jenis grafik untuk metrik untuk mendapatkan visualisasi dengan granularitas berbeda.

Klik Apply di pojok kanan atas.
Buat Pernyataan Kueri Kustom
Berdasarkan Alamat API HTTP Prometheus dan Pernyataan PromQL yang diperoleh di Konsol ARMS, Anda dapat menggunakan skrip shell atau Java untuk membuat permintaan HTTP guna menyesuaikan data pemantauan.
Sebagai contoh, alamat API HTTP Prometheus adalah https://cn-hangzhou.arms.aliyuncs.com:9443/api/v1/prometheus/7a8f8e783c66a44a0f6a1dc9a0b8f1/1277589232893727/arms-metrics-99214ff7de7d0b2d/cn-hangzhou. Gabungkan dengan pernyataan PromQL dalam format berikut:
{{API HTTP Prometheus}}/api/v1/query_range?query={{PromQL}}&start={{startTime}}&end={{endTime}}&step={{step}}
Pernyataan kueri keluaran:
https://cn-hangzhou.arms.aliyuncs.com:9443/api/v1/prometheus/7a8f8e783c66a44a0f6a1dc9a0b8f1/1277589232893727/arms-metrics-99214ff7de7d0b2d/cn-hangzhou/api/v1/query_range?query=sum by (callType,)(sum_over_time_lorc(arms_app_requests_count_ign_destid_endpoint_ppid_prpc{pid="ckv8e2vzfj@7e393063f3fd6ad",serverIp=~".*",callKind=~"http|rpc|custom_entry|server|consumer|schedule",source="apm", }[1m]))&start=1728719399&end=1728722999&step=60s
Data berikut dikueri dengan pernyataan tersebut.

FAQ
Apakah saya dikenakan biaya untuk kueri data?
Tidak, kueri data gratis.
Apakah pembatasan kecepatan dipicu saat saya menjalankan pernyataan PromQL?
Perlindungan pembatasan kecepatan tersedia tetapi tidak berlaku untuk jumlah permintaan per detik (QPS). Kami merekomendasikan untuk menghindari kueri yang memakan waktu, seperti menanyakansemua operasi atau mengambil data yang lebih lama dari 30 hari, serta menjaga laju kueri masuk Anda di bawah 50 QPS. Jika Anda perlu menjalankan kueri konsumsi tinggi secara terus-menerus, ajukan tiket untuk meningkatkan kuota.