Cara menggunakan tool PromQL

PromQL Copilot adalah asisten cerdas yang terintegrasi ke dalam Grafana untuk mengonversi bahasa alami menjadi pernyataan Prometheus Query Language (PromQL). Fitur ini memungkinkan Anda melakukan kueri data Prometheus dan mengonfigurasi alert tanpa perlu mempelajari sintaks PromQL.

Penting

PromQL Copilot kini tersedia di semua ruang kerja Grafana bersama. Jika Anda belum mengaktifkan Managed Service for Grafana, Anda dapat mencoba demo tanpa login kami.

Pengalaman produk:

Jika Anda tertarik menggunakan PromQL untuk metrik pemantauan kinerja aplikasi (APM), klik Portal Grafana tanpa login untuk sumber data APM.
Jika Anda tertarik menggunakan PromQL untuk metrik kontainer, klik Portal Grafana tanpa login untuk sumber data kontainer.

Fitur PromQL Copilot

Mengonversi bahasa alami ke PromQL
Jelaskan data Prometheus yang ingin Anda kueri menggunakan bahasa alami. PromQL Copilot akan mengidentifikasi nama metrik yang relevan, operator Prometheus, serta menyusun pernyataan PromQL lengkap dengan deskripsinya.
Membuat komentar PromQL secara otomatis
PromQL Copilot dapat menghasilkan penjelasan untuk pernyataan PromQL dan menambahkannya sebagai komentar.

Login ke Managed Service for Grafana console. Di panel navigasi sebelah kiri, klik Workspace Management.
Login ke dasbor Grafana bersama. Di panel navigasi sebelah kiri, klik ikon . Lalu, klik ikon bot di pojok kanan bawah.
Pada kotak dialog yang muncul, masukkan deskripsi dalam bahasa alami mengenai kueri PromQL yang Anda butuhkan. Misalnya, Anda dapat memasukkan "Tulis kueri PromQL untuk menemukan 10 aplikasi dengan waktu respons rata-rata terpanjang". Untuk contoh kueri bahasa alami lainnya, lihat Skenario PromQL dan contoh pertanyaan.
Penting
Pastikan pertanyaan Anda mencantumkan kata kunci "PromQL".
Klik Send. Setelah beberapa detik, PromQL Copilot akan memberikan kueri PromQL yang diminta.
Catatan
Jika Anda tidak puas dengan jawaban dari PromQL Copilot, Anda dapat mengklik Click here to submit Text2PromQL feedback.
Setelah mendapatkan kueri PromQL, tempelkan ke halaman Explore di Managed Service for Grafana. Pastikan sumber data untuk dasbor saat ini berisi metrik yang diinginkan.
Kemudian, Anda dapat menggunakan kueri PromQL kustom tersebut untuk mengonfigurasi alert di Managed Service for Prometheus saat membuat aturan alert. Untuk informasi selengkapnya, lihat Buat aturan alert Prometheus menggunakan kueri PromQL kustom.

Video demo

Video berikut menunjukkan cara menggunakan tool PromQL.

Skenario Tanya Jawab yang Didukung untuk Text2PromQL

Text2PromQL mendukung lebih dari 20 skenario umum untuk menghasilkan kueri PromQL. Untuk informasi selengkapnya, lihat bagian Skenario PromQL dan contoh pertanyaan di bawah. Anda dapat mengklik PromQL Copilot untuk melihat skenario dan contoh pertanyaan yang didukung.

Daftar skenario yang didukung untuk menghasilkan kueri PromQL akan ditampilkan.

Skenario PromQL dan contoh kueri

Tabel berikut mencantumkan metrik umum untuk Container Service dan ARMS beserta kueri PromQL-nya.

Container Service

Gunakan fitur ini dengan dasbor Grafana untuk instans Prometheus untuk Container Service. Untuk informasi selengkapnya, lihat Instans Prometheus untuk Container Service.

Skenario	Contoh masalah overwrite (melibatkan PromQL)
Sumber daya tingkat node	Q: Tulis kueri PromQL untuk melihat penggunaan CPU setiap node Kubernetes. Q: Saya ingin melihat penggunaan memori node Kubernetes "172.16.xx.xx:9100". Tuliskan kueri PromQL untuk saya. Q: Saya ingin mengonfigurasi alert yang dipicu jika ada node dalam kluster saat ini berada dalam kondisi abnormal. Bagaimana cara menulis kueri PromQL-nya? Q: Tulis kueri PromQL untuk saya agar dapat melihat semua node yang saat ini dalam kondisi abnormal.
Sumber daya tingkat Pod	Q: Saya ingin mengonfigurasi alert yang dipicu jika sebuah pod melakukan restart lebih dari dua kali dalam 5 menit. Bagaimana cara menulis kueri PromQL-nya? Q: Tulis kueri PromQL untuk melihat ketersediaan pod untuk `namespace="arms", deployment="arms-pop-malaysia"`. Ketersediaan pod. Q: Tulis kueri PromQL untuk menemukan pod dengan anomali terbanyak di kluster Kubernetes saya. Q: Saya ingin melihat pekerjaan mana saja yang gagal. Bagaimana cara menulis kueri PromQL-nya?
Sumber daya tingkat kontainer	Q: Tulis kueri PromQL untuk melihat kontainer dengan penggunaan CPU tertinggi di namespace "default". Q: Tulis kueri PromQL untuk melihat penggunaan memori setiap kontainer dengan `namespace="default", pod_name="arms-xtrace"`. Q: Tulis kueri PromQL untuk melihat 5 kontainer dengan penggunaan memori tertinggi.
Metrik dasbor Lingjun	Q: Tulis kueri PromQL untuk melihat penggunaan GPU setiap node pada dasbor Lingjun. Q: Tulis kueri PromQL untuk melihat penggunaan GPU setiap kluster pada dasbor Lingjun.

Pemantauan kinerja aplikasi ARMS

Gunakan fitur ini dengan dasbor Grafana pemantauan kinerja aplikasi default yang dihasilkan oleh ARMS.

Skenario	Contoh pertanyaan (harus mencantumkan kata kunci "PromQL")
Waktu respons rata-rata	Q: Tulis kueri PromQL untuk melihat waktu respons rata-rata setiap API. Q: Tulis kueri PromQL untuk melihat RT setiap API di aplikasi A. Q: Tulis kueri PromQL untuk menemukan 10 API dengan waktu respons tertinggi di aplikasi A. Q: Tulis kueri PromQL untuk menemukan 10 aplikasi dengan waktu respons terpanjang.
Laju error	Q: Tulis kueri PromQL untuk melihat laju error setiap API di aplikasi A dalam satu menit terakhir. Q: Di ARMS, tulis kueri PromQL untuk menemukan 10 aplikasi dengan laju error tertinggi. Q: Tulis kueri PromQL untuk menemukan 10 API dengan laju error tertinggi di aplikasi A. Q: Tulis kueri PromQL ARMS untuk menemukan 5 API dengan laju error tertinggi di mesin 195.128.xx.xx untuk aplikasi A dalam 2 jam terakhir.
Jumlah panggilan	Q: Tulis kueri PromQL untuk melihat QPS panggilan ke Redis. Q: Tulis kueri PromQL untuk melihat QPS panggilan ke Dubbo. Q: Tulis kueri PromQL untuk melihat QPS setiap API di aplikasi A. Q: Tulis kueri PromQL untuk melihat jumlah panggilan setiap aplikasi dalam satu jam terakhir, dikelompokkan berdasarkan mesin. Q: Tulis kueri PromQL ARMS untuk melihat jumlah panggilan setiap API di aplikasi A dalam 5 menit terakhir. Q: Tulis kueri PromQL untuk melihat jumlah panggilan ke API "payment/coupon" aplikasi A dalam 5 menit terakhir. Q: Tulis kueri PromQL untuk melihat 10 API dengan jumlah panggilan terbanyak. Q: Tulis kueri PromQL untuk melihat 5 API dengan jumlah panggilan terbanyak di aplikasi A.
Jumlah error	Q: Tulis kueri PromQL untuk melihat jumlah error setiap API dalam 5 menit terakhir. Q: Tulis kueri PromQL untuk melihat total jumlah error panggilan HTTP di mesin 10.26.xx.xx dalam 5 menit terakhir. Q: Tulis kueri PromQL untuk menemukan API dengan jumlah error terbanyak dalam satu jam terakhir. Q: Tulis kueri PromQL untuk melihat total jumlah error panggilan di mesin 10.26.xx.xx, tempat layanan Clothservice dideploy, dalam 10 menit terakhir.
Pernyataan SQL lambat	Q: Tulis kueri PromQL untuk melihat panggilan SQL lambat yang terjadi dalam 10 menit terakhir. Q: Tulis kueri PromQL untuk menemukan API di aplikasi A yang melakukan panggilan SQL lambat terbanyak dalam 10 menit terakhir. Q: Tulis kueri PromQL untuk menemukan 10 API di aplikasi A yang melakukan panggilan SQL lambat terbanyak. Q: Tulis kueri PromQL untuk mencantumkan panggilan SQL lambat spesifik yang terjadi dalam satu jam terakhir.
Database	Q: Tulis kueri PromQL untuk menemukan API yang gagal memanggil Redis dalam satu menit terakhir. Q: Tulis kueri PromQL untuk menemukan 5 API yang paling sering gagal memanggil MySQL dalam satu menit terakhir.
Kode status HTTP	Q: Tulis kueri PromQL untuk menghitung jumlah error 4xx atau 5xx. Q: Tulis kueri PromQL untuk menghitung jumlah error 400 dan 500. Q: Tulis kueri PromQL untuk melihat jumlah permintaan 4xx untuk aplikasi A.
Jumlah event GC JVM	Q: Tulis kueri PromQL untuk melihat berapa banyak full GC yang terjadi dalam satu hari terakhir. Q: Tulis kueri PromQL untuk melihat berapa banyak full GC yang terjadi di setiap host dalam satu jam terakhir. Q: Tulis kueri PromQL untuk menemukan host untuk aplikasi A yang sebelumnya mengalami full GC. Q: Tulis kueri PromQL untuk menemukan mesin yang mengalami lebih dari 5 full GC.
Durasi GC JVM	Q: Tulis kueri PromQL untuk melihat durasi full GC di setiap mesin. Q: Tulis kueri PromQL untuk menemukan 5 mesin dengan durasi full GC terpanjang. Q: Tulis kueri PromQL untuk menemukan layanan dengan durasi full GC melebihi 1 detik.
Kenaikan QPS	Q: Tulis kueri PromQL untuk melihat semua aplikasi yang trafiknya meningkat dalam 10 menit terakhir. Q: Tulis kueri PromQL untuk menemukan aplikasi dengan kenaikan trafik terbesar dalam satu hari terakhir. Q: Tulis kueri PromQL untuk menemukan API di aplikasi A dengan pertumbuhan trafik tercepat dalam satu minggu terakhir.
Kenaikan metrik tertentu	Q: Tulis kueri PromQL untuk memantau metrik `arms_mysql_requests_error_count` dan memicu alert saat nilainya melonjak. Q: Tulis kueri PromQL untuk memantau kenaikan metrik `jvm_threads_live_threads`.
Konsol ARMS: Error kumulatif	Q: Tulis kueri PromQL untuk melihat apakah jumlah error kumulatif meningkat atau menurun dibandingkan kemarin.
Konsol ARMS: Permintaan kumulatif	Q: Tulis kueri PromQL untuk melihat seberapa besar perubahan jumlah permintaan kumulatif dibandingkan satu jam terakhir.
Konsol ARMS: Anomali kumulatif	Q: Tulis kueri PromQL untuk melihat apakah jumlah anomali kumulatif meningkat atau menurun dibandingkan kemarin.
Konsol ARMS: Durasi rata-rata	Q: Tulis kueri PromQL untuk melihat apakah durasi rata-rata aplikasi meningkat atau menurun dibandingkan jam sebelumnya. Q: Tulis kueri PromQL untuk melihat perubahan durasi rata-rata dibandingkan kemarin.
Konsol ARMS: Full GC	Q: Tulis kueri PromQL untuk melihat aplikasi mana saja yang terdampak oleh full GC. Q: Tulis kueri PromQL untuk melihat API mana saja yang terdampak oleh full GC.
Konsol ARMS: Panggilan lambat	Q: Tulis kueri PromQL untuk melihat aplikasi mana saja yang terlibat dalam pernyataan SQL lambat. Q: Tulis kueri PromQL untuk melihat API mana saja yang melakukan panggilan SQL lambat.
Anomali atau error baru	Q: Tulis kueri PromQL untuk melihat aplikasi dengan jumlah error yang meningkat. Q: Tulis kueri PromQL untuk melihat mesin mana saja yang jumlah error-nya meningkat. Q: Tulis kueri PromQL untuk melihat API di aplikasi A dengan jumlah error yang meningkat.
Penggunaan CPU	Q: Tulis kueri PromQL untuk melihat penggunaan CPU setiap mesin. Q: Tulis kueri PromQL untuk menemukan 5 mesin dengan penggunaan CPU tertinggi dalam 5 menit terakhir. Q: Tulis kueri PromQL untuk menemukan mesin untuk aplikasi A dengan penggunaan CPU melebihi 70% dalam 5 menit terakhir. Q: Tulis kueri PromQL untuk menemukan 5 mesin dengan pertumbuhan penggunaan CPU tercepat dalam 5 menit terakhir dan cantumkan penggunaan CPU-nya.