Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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$__interval $__rate_interval Batasnya mutlak dan tidak dimodifikasi oleh pengaturan Resolusi. |
Resolution
|
1/1menetapkan $__interval variabel dan stepparameter kueri rentang Prometheus1/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. |
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 Prometheuss (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.
