Pengatur dan Pemvalidasi Permintaan PromQL

Format dan Validasi Permintaan PromQL Prometheus secara langsung

Pengaturan PromQL Query Formatter & Validator membersihkan query yang Anda tulis terhadap Prometheus dan database waktu-seri lainnya. Tempelkan ekspresi metrik dan alat ini akan menormalisasi spasi di sekitar operator biner, mengatur agregasi, panggilan fungsi, dan pencocokan label ke baris terpisah saat query menjadi panjang, serta menunjukkan kesalahan tanda kurung yang tidak seimbang, kurung yang tidak cocok, durasi yang hilang, dan masalah sintaks lainnya sebelum Anda menempelkan query ke dashboard atau aturan peringatan. Semua proses berjalan secara lokal di browser Anda, sehingga query-query yang sering mengungkapkan nama metrik dan label internal tidak pernah meninggalkan perangkat Anda.

Cara Penggunaan

1. Tempel query PromQL Anda ke area input, atau unggah .promql atau file teks menggunakan picker file.
2. Pilih lebar indentasi — 2 spasi, 4 spasi, atau karakter tab literal — untuk ekspansi multi-baris.
3. Atur panjang maksimum baris. Panggilan fungsi, set pencocokan label, dan operator boolean berat (and, or, unless) akan dipindahkan ke baris terpisah jika panjang baris yang telah diformat melebihi lebar ini.
4. Beralih Selalu pecah jika Anda ingin setiap agregasi, daftar argumen panggilan fungsi, dan set pencocokan label berada di baris terpisah terlepas dari panjangnya.
5. Beralih Wrap sebagai aturan pencatatan dan berikan nama metrik (seperti job:http_errors:rate5m) untuk menghasilkan query yang telah diformat sebagai aturan pencatatan siap dipasang dalam format YAML Prometheus.
6. Salin hasil format atau unduh sebagai .promql file.

Fitur

• Pengaturan jarak yang sadar terhadap PromQL – Menambahkan satu spasi di sekitar operator aritmatika, perbandingan, dan boolean sambil mempertahankan pencocokan label ketat di dalam { } kurung.
• Pengaturan tata letak multi-baris cerdas – Memecah query panjang di and / or / unless pertama, lalu di batas argumen fungsi, lalu di setiap pencocokan label sehingga hasilnya tetap mudah dipantau.
• Dukungan agregasi dan pencocokan vektor – Mengenali sum, avg, topk, quantile dan teman-temannya bersama dengan by, without, on, ignoring, group_left dan group_right modifikasi.
• Pemecah durasi dan subquery – Membaca rentang kompleks seperti 1h30m dan subquery seperti [5m:1m] sebagai unit tunggal sehingga tidak pernah dibagi di tengah token.
• Validasi sintaks – Mendeteksi tanda kurung, kurung, dan kurung yang tidak seimbang, pembuka dan penutup yang tidak cocok, tubuh pencocokan label yang tidak valid, rentang indeks yang tidak valid, dan string yang tidak ditutup, masing-masing dilaporkan dengan nomor baris.
• Ekspor aturan pencatatan – Secara opsional memformat query yang telah diformat sebagai blok aturan pencatatan Prometheus dalam format YAML, menggunakan blok skalar literal YAML untuk ekspresi multi-baris sehingga indentasi tetap dipertahankan.

Kasus Penggunaan Umum

• Membersihkan query PromQL sementara yang dikopi dari editor panel Grafana sebelum dimasukkan ke dashboard atau aturan peringatan.
• Mempersiapkan ekspresi PromQL untuk review kode — query error rate atau saturasi panjang menjadi perbedaan yang mudah dibaca setelah setiap cabang berada di baris terpisah.
• Mendeteksi kesalahan sintaks halus (durasi yang hilang, koma yang tidak sesuai, kurung yang tidak tertutup { setelah mengedit pencocokan label) tanpa memerlukan perjalanan melalui instance Prometheus yang hidup.
• Mengonversi query mentah menjadi format YAML aturan pencatatan Prometheus untuk pipeline pra-agregasi.
• Mengajarkan PromQL — output yang telah dinormalisasi membuat urutan operator dan pengelompokan agregasi langsung jelas bagi pembaca yang belajar bahasa ini.