All Products
Search

This Product

    Application Real-Time Monitoring Service:Buat dasbor Grafana kustom

    Document Center

    Application Real-Time Monitoring Service:Buat dasbor Grafana kustom

    Last Updated:Mar 11, 2026

    Application Real-Time Monitoring Service (ARMS) menyimpan data pemantauan aplikasi di Managed Service for Prometheus, yang sepenuhnya kompatibel dengan Grafana open-source dan PromQL. Fitur ini memungkinkan Anda membuat dasbor Grafana kustom yang menggabungkan metrik aplikasi ARMS dengan data dari sumber apa pun yang kompatibel dengan Prometheus—memberikan tampilan terpadu mengenai kesehatan aplikasi, infrastruktur, dan metrik bisnis.

    Kasus penggunaan

    • Membuat dasbor operasi terpadu yang menggabungkan metrik aplikasi dengan metrik infrastruktur atau bisnis dari sumber data lain

    • Membuat dasbor jam puncak yang mengorelasikan kinerja aplikasi dengan metrik layanan hulu dan hilir

    • Melihat data Pemantauan Aplikasi ARMS di instans Grafana yang dikelola sendiri bersama dasbor yang sudah ada

    • Mengkueri metrik ARMS secara terprogram melalui API HTTP Prometheus untuk pelaporan kustom atau otomatisasi

    • Menggunakan data Pemantauan Aplikasi ARMS untuk pengembangan sekunder berdasarkan kebutuhan bisnis Anda

    Cara kerja

    Saat Anda mengaktifkan Pemantauan Aplikasi untuk suatu aplikasi, ARMS secara otomatis membuat instans Prometheus gratis di wilayah yang sama. Misalnya, aplikasi yang dipantau di wilayah China (Hangzhou) menyimpan metriknya di instans Prometheus bernama arms_metrics_cn-hangzhou_cloud_hangzhou.

    image

    Untuk memvisualisasikan metrik tersebut di Grafana, tambahkan instans Prometheus sebagai data source, lalu buat panel yang melakukan kueri terhadap metrik menggunakan PromQL atau pembuat kueri Grafana.

    Prasyarat

    Sebelum memulai, pastikan Anda telah memiliki:

    • Agen ARMS yang terpasang untuk aplikasi Anda. Untuk detailnya, lihat Ikhtisar Pemantauan Aplikasi

    • Salah satu lingkungan Grafana berikut:

      • Instalasi Grafana yang dikelola sendiri (lokal atau di server)

      • Managed Service for Grafana ruang kerja

    Langkah 1: Tambahkan ARMS sebagai data source di Grafana

    Managed Service for Prometheus terintegrasi dengan Pemantauan Aplikasi secara default. Untuk memvisualisasikan data di Grafana, tambahkan instans Prometheus yang menyimpan metrik aplikasi Anda sebagai data source.

    Pilih salah satu jalur berikut berdasarkan lingkungan Grafana Anda.

    Tambahkan data source ke Grafana yang dikelola sendiri

    Dapatkan URL API HTTP Prometheus

    1. Masuk ke Konsol ARMS. Di panel navigasi sebelah kiri, pilih Managed Service for Prometheus > Instances. Di bilah navigasi atas, pilih wilayah tempat aplikasi Anda dideploy. Instans dengan tipe Prometheus Instance for Application Monitoring menyimpan data pemantauan untuk aplikasi di wilayah tersebut.

      2024-10-29_11-56-55

    2. Klik nama instans, lalu klik Settings di panel navigasi sebelah kiri untuk melihat URL API HTTP.

      2024-10-29_11-59-24

    3. (Opsional) Klik Generate Token untuk membuat token otentikasi untuk instans Prometheus. Token ini mengamankan akses data saat Grafana membaca dari instans ini.

      Penting

      Setelah Anda menghasilkan token, Anda harus menyertakannya sebagai header HTTP kustom saat menambahkan data source ini. Jika tidak, Grafana tidak dapat membaca data dari instans tersebut.

    Konfigurasikan data source di Grafana

    Contoh ini menggunakan Grafana 10.x. Untuk versi lain, lihat dokumentasi Grafana.

    1. Masuk ke Grafana sebagai administrator.

    2. Arahkan kursor ke ikon image di pojok kiri atas dan klik Data sources.

    3. Klik Add data source dan pilih Prometheus.

    4. Di tab Settings, konfigurasikan bidang berikut:

      FieldValue
      NameNama deskriptif untuk data source ini
      Prometheus server URL (di bagian HTTP)URL API HTTP yang diperoleh pada langkah sebelumnya

      image

    5. (Opsional) Jika Anda menghasilkan token otentikasi, tambahkan sebagai header kustom: di bagian Custom HTTP Headers, klik + Add header. Atur Header ke Authorization dan Value ke token tersebut.

      image

    6. Klik Save & test untuk memverifikasi koneksi.

    Tambahkan data source ke Managed Service for Grafana

    Managed Service for Grafana menyediakan integrasi satu klik untuk data Pemantauan Aplikasi ARMS.

    1. Masuk ke Konsol ARMS. Di panel navigasi sebelah kiri, pilih Managed Service for Grafana > Workspace Management. Klik ID ruang kerja.

    2. Di halaman Workspace Information, di bagian Cloud Service Integration, klik ARMS Application Monitoring. Temukan instans Prometheus di wilayah target dan klik Integrations di kolom Actions.

    3. Klik OK di kotak dialog konfirmasi.

    4. Setelah integrasi selesai, klik Folder di kolom Actions.

    5. Di tab Dashboards, klik nama dasbor untuk melihat dasbor Pemantauan Aplikasi yang telah ditetapkan sebelumnya.

      Application Monitoring dashboard

    6. Untuk memverifikasi data source, arahkan kursor ke ikon image di pojok kiri atas dan klik Data sources.

      2024-10-29_17-35-10

    Langkah 2: Buat dasbor kustom

    1. Arahkan kursor ke ikon image di pojok kiri atas dan klik Dashboards.

    2. Klik New Dashboard, lalu klik Add an empty panel.

    3. Di kotak dialog Select data source, pilih data source tersebut. Format penamaan default adalah arms_metrics_{regionid}_cloud.

      Penting

      Verifikasi bahwa data source berisi data sebelum melanjutkan. Jika tidak ada data yang muncul, pastikan aplikasi Anda aktif melaporkan metrik.

    4. Konfigurasikan kueri menggunakan salah satu metode berikut:

      Tulis kueri PromQL (Mode Code)

      Beralih ke mode Code dan masukkan ekspresi PromQL di samping Metrics browser.

      image.png

      Tip: Untuk menemukan ekspresi PromQL untuk metrik tertentu, buka halaman detail aplikasi di modul Pemantauan Aplikasi dan klik ikon image di samping metrik tersebut. Untuk detailnya, lihat Ikhtisar aplikasi.

      image

      Untuk referensi sintaks PromQL, lihat dokumentasi Prometheus.

      Pilih metrik secara visual (Mode Builder)

      Di mode Builder, pilih metrik dari daftar drop-down Metric. Misalnya, pilih arms_jvm_threads_count untuk mengkueri jumlah thread JVM.

      Gunakan bagian Label filters untuk mempersempit hasil dengan menentukan label dan nilainya.

      Use query

      Untuk daftar lengkap metrik yang tersedia, lihat Metrik pemantauan aplikasi.

    5. Di tab Panel (sisi kanan), atur judul panel dan pilih jenis grafik.

      Catatan

      Jenis grafik yang berbeda untuk metrik yang sama dapat mengungkap data pada tingkat granularitas yang berbeda.

      image.png

    6. Klik Apply di pojok kanan atas untuk menyimpan panel ke dasbor.

    Kueri metrik melalui API HTTP Prometheus

    Selain dasbor Grafana, metrik ARMS juga dapat diakses melalui API HTTP Prometheus. Hal ini memungkinkan pelaporan otomatis, peringatan kustom, dan integrasi dengan alat Anda sendiri.

    Buat URL kueri

    Gabungkan URL API HTTP Prometheus (dari Langkah 1) dengan ekspresi PromQL menggunakan format berikut:

    <Prometheus-HTTP-API-URL>/api/v1/query_range?query=<PromQL>&start=<startTime>&end=<endTime>&step=<step>

    Parameter kueri

    ParameterDescriptionExample
    queryEkspresi PromQLarms_jvm_threads_count{pid="xxx"}
    startWaktu mulai dalam bentuk timestamp Unix (detik)1728719399
    endWaktu akhir dalam bentuk timestamp Unix (detik)1728722999
    stepLangkah resolusi kueri60s

    Otentikasi

    Jika otentikasi berbasis token diaktifkan pada instans Prometheus, sertakan token otentikasi sebagai header Authorization dalam permintaan HTTP Anda. Skrip shell, Python, Java, atau klien HTTP apa pun dapat menjalankan kueri ini.

    Contoh

    URL berikut mengkueri jumlah total permintaan untuk suatu aplikasi, dikelompokkan berdasarkan jenis panggilan:

    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

    Kueri tersebut mengembalikan data yang mirip dengan berikut:

    image

    FAQ

    Apakah ada biaya untuk mengkueri data?

    Tidak. Kueri data tidak dikenai biaya.

    Apakah ada batas laju untuk kueri PromQL?

    Perlindungan throttling tersedia tetapi tidak membatasi permintaan per detik (QPS) secara langsung. Untuk menghindari timeout, pertahankan laju kueri di bawah 50 QPS dan hindari kueri mahal seperti mengkueri semua operasi atau mengambil data yang lebih tua dari 30 hari. Jika Anda memerlukan kueri volume tinggi yang berkelanjutan, kirim tiket untuk meminta kuota yang lebih tinggi.

    Langkah selanjutnya