Menggunakan sumber data Prometheus

Pengaturan Prometheus

Nama	Penjelasan
Name	Nama sumber data. Ini adalah bagaimana Anda melihat sumber data di panel dan kueri.
Default	Sumber data default berarti bahwa itu akan dipilih sebelumnya untuk panel baru.
Url	URL server Prometheus Anda; misalnya,. https://prometheus.example.org:9090
Access	Server (default) = URL harus dapat diakses dari backend/server Grafana.
Basic Auth	Aktifkan otentikasi dasar ke sumber data Prometheus.
User	Nama pengguna untuk otentikasi dasar.
Password	Kata sandi untuk otentikasi dasar.
Scrape interval	Setel ini ke interval gesekan dan evaluasi khas yang dikonfigurasi di Prometheus. Default ke 15 detik.
Disable metrics lookup	Memeriksa opsi ini akan menonaktifkan pemilih metrik dan dukungan metrik/label di pelengkapan otomatis bidang kueri. Ini membantu jika Anda memiliki masalah kinerja dengan instance Prometheus yang lebih besar.
Custom Query Parameters	Tambahkan parameter khusus ke URL kueri Prometheus. Misalnyatimeout,partial_response,dedup, ataumax_source_resolution. Beberapa parameter harus digabungkan bersama dengan “&”.

Editor kueri Prometheus

Bagian berikut memberikan informasi dan opsi untuk editor kueri Prometheus di dasbor dan di Jelajahi.

Editor kueri di dasbor

Buka grafik dalam mode edit dengan memilih judul dan kemudian memilih Edit (atau dengan menekan tombol e sambil berhenti di panel).

Nama	Penjelasan
Query expression	Untuk informasi selengkapnya tentang ekspresi kueri Prometheus, lihat dokumentasi Prometheus.
Legend format	Mengontrol nama deret waktu, menggunakan nama atau pola. Misalnya {{hostname}} diganti dengan nilai label untuk labelhostname.
Min step	Batas bawah tambahan untuk stepparameter kueri rentang Prometheus dan untuk variabel dan. $__interval $__rate_interval Batasnya mutlak dan tidak dimodifikasi oleh pengaturan Resolusi.
Resolution	1/1menetapkan $__interval variabel dan stepparameter kueri rentang Prometheus sedemikian rupa sehingga setiap piksel sesuai dengan satu titik data. Untuk kinerja yang lebih baik, gunakan resolusi yang lebih rendah. 1/2hanya mengambil titik data untuk setiap piksel lainnya, dan 1/10 mengambil satu titik data per 10 piksel. Perhatikan bahwa interval waktu Min dan langkah Min membatasi nilai akhir $__interval danstep.
Metric lookup	Cari nama metrik di kolom input ini.
Format as	Beralih antaraTable,Time series, atauHeatmap. Tablehanya berfungsi di panel tabel. Heatmapcocok untuk menampilkan metrik tipe histogram pada panel peta panas. Ini mengubah histogram kumulatif menjadi histogram biasa dan mengurutkan seri dengan terikat ember.
Instant	Lakukan kueri “instan”, untuk mengembalikan hanya nilai terbaru yang telah dikikis Prometheus untuk deret waktu yang diminta. Kueri instan mengembalikan hasil jauh lebih cepat daripada kueri rentang normal. Gunakan mereka untuk mencari set label.
Min time interval	Nilai ini dikalikan dengan penyebut dari pengaturan Resolusi menetapkan batas bawah untuk $__interval variabel dan parameter step kueri rentang Prometheus. Default untuk Scrape interval seperti yang diatur dalam opsi sumber data.

catatan

Grafana Terkelola Amazon memodifikasi tanggal permintaan kueri untuk menyelaraskannya dengan langkah yang dihitung secara dinamis. Ini memastikan tampilan data metrik yang konsisten, tetapi dapat menghasilkan celah kecil data di tepi kanan grafik.

Kueri instan di dasbor

Sumber data Prometheus memungkinkan Anda menjalankan kueri instan, yang hanya menanyakan nilai terbaru. Anda dapat memvisualisasikan hasil dalam panel tabel untuk melihat semua label yang tersedia dari deret waktu.

Hasil kueri instan hanya terdiri dari satu titik data per seri. Mereka dapat ditampilkan di panel grafik dengan bantuan penggantian seri. Untuk menunjukkannya dalam grafik sebagai titik nilai terbaru, tambahkan penggantian seri dan pilihPoints > true. Untuk menampilkan garis horizontal di seluruh grafik, tambahkan penggantian seri dan pilih Transform > constant Untuk informasi selengkapnya tentang penggantian seri, lihat. Penggantian seri

Editor kueri di Jelajahi

Nama	Penjelasan
Query expression	Untuk informasi selengkapnya tentang ekspresi kueri Prometheus, lihat dokumentasi Prometheus.
Step	Stepparameter dari kueri rentang Prometheus. Satuan waktu dapat digunakan di sini, misalnya: 5s, 1m, 3h, 1d, 1y. Unit default jika tidak ada unit yang ditentukan adalah s (detik).
Query type	Range, Instant, atau Both. Saat menjalankan kueri Rentang, hasil kueri ditampilkan dalam grafik dan tabel. Kueri instan hanya mengembalikan nilai terbaru yang Prometheus telah tergores untuk deret waktu yang diminta dan ditampilkan dalam tabel. Ketika Keduanya dipilih, kueri instan dan kueri rentang dijalankan. Hasil kueri rentang ditampilkan dalam grafik dan hasil kueri instan ditampilkan dalam tabel.

Browser metrik

Browser metrik memungkinkan Anda menemukan metrik dengan cepat dan memilih label yang relevan untuk membuat kueri dasar. Saat Anda membuka browser, Anda akan melihat semua metrik dan label yang tersedia. Jika didukung oleh instance Prometheus Anda, setiap metrik akan menampilkan HELP dan TYPE sebagai tooltip.

Saat Anda memilih metrik, browser mempersempit label yang tersedia untuk hanya menampilkan label yang berlaku untuk metrik. Anda kemudian dapat memilih satu atau beberapa label yang nilai label yang tersedia ditampilkan dalam daftar di bagian bawah. Pilih satu atau beberapa nilai untuk setiap label untuk memperketat cakupan kueri Anda.

catatan

Jika Anda tidak ingat nama metrik untuk memulai, Anda juga dapat memilih beberapa label terlebih dahulu, untuk mempersempit daftar dan kemudian menemukan nilai label yang relevan.

Semua daftar di browser metrik memiliki bidang pencarian di atasnya untuk dengan cepat memfilter metrik atau label yang cocok dengan string tertentu. Bagian nilai hanya memiliki satu bidang pencarian. Pemfilterannya berlaku untuk semua label untuk membantu Anda menemukan nilai di seluruh label setelah dipilih, misalnya, di antara aplikasi label Anda, job, job_name hanya satu yang mungkin dengan nilai yang Anda cari.

Setelah Anda puas dengan kueri Anda, klik “Gunakan kueri” untuk menjalankan kueri. Tombol Use as rate query menambahkan rate (...) [$__interval] di sekitar kueri Anda untuk membantu menulis kueri untuk metrik penghitung. Tombol “Validasi pemilih” akan memeriksa dengan Prometheus berapa banyak deret waktu yang tersedia untuk pemilih itu.

Batasan

Browser metrik memiliki batas keras 10.000 label (kunci) dan 50.000 nilai label (termasuk nama metrik). Jika instance Prometheus Anda mengembalikan lebih banyak hasil, browser akan terus berfungsi. Namun, set hasil akan terpotong di atas batas maksimum tersebut.

Templating

Alih-alih melakukan hardcoding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel sebagai gantinya. Variabel ditampilkan sebagai kotak pilih dropdown di bagian atas dasbor. Anda dapat menggunakan kotak dropdown ini untuk mengubah data yang ditampilkan di dasbor Anda.

Untuk informasi selengkapnya tentang variabel template dan template, lihatTemplate dan variabel.

Variabel kueri

Variabel tipe Query memungkinkan Anda untuk query Prometheus untuk daftar metrik, label, atau nilai label. Plugin sumber data Prometheus menyediakan fungsi-fungsi berikut yang dapat Anda gunakan di bidang input Query.

Nama	Penjelasan
label_names()	Mengembalikan daftar nama label.
label_values(label)	Mengembalikan daftar nilai label untuk label dalam setiap metrik.
label_values(metric, label)	Mengembalikan daftar nilai label untuk label dalam metrik tertentu.
metrics(metric)	Mengembalikan daftar metrik yang cocok dengan metric regex tertentu.
query_result(query)	Mengembalikan daftar Prometheus hasil query untuk. query

Untuk informasi tentang nama metrik, nama label, dan nilai label, lihat dokumentasi Prometheus.

Menggunakan variabel interval dan rentang

catatan

Support untuk$__range,$__range_s, dan hanya $__range_ms tersedia dari Grafana v5.3.

Anda dapat menggunakan beberapa variabel global dalam variabel kueri:$__interval,$__interval_ms,$__range,$__range_s, dan$__range_ms. Untuk informasi selengkapnya, lihat Variabel global. Ini dapat nyaman digunakan dengan query_result fungsi ketika Anda harus memfilter kueri variabel karena label_values fungsi tidak mendukung kueri.

Untuk mendapatkan instance yang benar saat mengubah rentang waktu di dasbor, pastikan untuk mengatur refresh pemicu variabel menjadiOn Time Range Change.

Contoh kode berikut menunjukkan cara mengisi variabel dengan lima instance permintaan tersibuk berdasarkan QPS rata-rata selama rentang waktu yang ditunjukkan di dasbor.

Query: query_result(topk(5, sum(rate(http_requests_total[$__range])) by (instance)))
Regex: /"([^"]+)"/

Contoh kode berikut menunjukkan cara mengisi variabel dengan instance yang memiliki status tertentu selama rentang waktu yang ditunjukkan di dasbor, menggunakan. $__range_s

Query: query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
Regex:

Menggunakan $__rate_interval variabel

$__rate_intervalVariabel dimaksudkan untuk digunakan dalam fungsi laju. Hal ini didefinisikan sebagai max ($__interval+ Scrape interval, 4 * Scrape interval). Interval scrape adalah pengaturan langkah Min (AKA query_interval, pengaturan per kueri promQL), jika ada yang disetel, dan sebaliknya interval Scrape seperti yang diatur dalam sumber data Prometheus (tetapi mengabaikan pengaturan interval Min apa pun di panel, karena yang terakhir dimodifikasi oleh pengaturan resolusi).

Menggunakan variabel dalam kueri

Ada dua sintaks:

• $<varname>Contoh: tingkat (http_requests_total {job=~"$job "} [5m])

• [[varname]]Contoh: rate (http_requests_total {job=~ "[[job]]"} [5m])

Mengapa dua cara? Sintaks pertama lebih mudah dibaca dan ditulis tetapi tidak memungkinkan Anda menggunakan variabel di tengah kata. Saat opsi Multi-nilai atau Sertakan semua nilai diaktifkan, Grafana mengonversi label dari teks biasa menjadi string yang kompatibel dengan regex. Yang berarti Anda harus menggunakan =~ alih-alih=.

Anotasi

Anda dapat menggunakan anotasi untuk melapisi informasi acara yang kaya di atas grafik. Anda menambahkan kueri anotasi menggunakan menu Dasbor atau tampilan Anotasi. Untuk informasi selengkapnya, lihat Anotasi.

Prometheus mendukung dua cara untuk menanyakan anotasi.

• Kueri metrik biasa

• Permintaan Prometheus untuk peringatan tertunda dan penembakan. Untuk informasi selengkapnya, lihat Memeriksa peringatan selama runtime).

Opsi langkah berguna untuk membatasi jumlah peristiwa yang dikembalikan dari kueri Anda.