Kueri yang direkam

Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.

Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. Bekerja di Grafana versi 10

Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. Bekerja di Grafana versi 9

Anda dapat melihat tren dari waktu ke waktu dengan mengambil snapshot dari titik data pada interval yang ditetapkan menggunakan kueri yang direkam. Ini dapat memberi Anda wawasan tentang tren bersejarah.

Untuk plugin yang tidak mengembalikan deret waktu, mungkin berguna untuk memplot data historis. Misalnya, Anda mungkin ingin melakukan kueri ServiceNowuntuk melihat riwayat waktu respons permintaan tetapi hanya dapat mengembalikan point-in-time metrik saat ini.

Cara kerja kueri yang direkam

Kueri yang direkam hanya berfungsi dengan plugin sumber data backend. Untuk informasi lebih lanjut, lihat Plugin sumber data Backend. Anda dapat merekam tiga jenis kueri:

• single row and column - Sebuah query yang mengembalikan satu baris dan kolom.

• jumlah baris - Kueri yang mengembalikan baris bermakna untuk dihitung.

• ekspresi - Ekspresi apa pun. Untuk mempelajari lebih lanjut tentang membuat dan menggunakan ekspresi, lihat Ekspresi.

Setelah kueri yang direkam dibuat atau diaktifkan, ia segera membuat snapshot dan terus membuat snapshot pada interval yang ditetapkan. Kueri yang direkam berhenti mengambil snapshot saat dinonaktifkan, dihapus, atau saat Grafana tidak berjalan. Titik data dikumpulkan di backend dengan menjalankan kueri yang direkam dan meneruskan setiap hasil ke instance Prometheus yang diaktifkan penulisan jarak jauh.

catatan

Anda harus mengonfigurasi sumber data Prometheus dan mengaitkannya dengan target penulisan Jarak Jauh sebelum kueri yang direkam dapat digunakan.

Buat kueri yang direkam

Untuk membuat kueri yang direkam, selesaikan langkah-langkah berikut:

1. Temukan atau buat kueri yang ingin Anda rekam di dasbor di panel edit. Query hanya harus mengembalikan satu baris dan kolom. Jika mengembalikan lebih banyak, Anda masih dapat mencatat jumlah hasil yang dikembalikan menggunakan opsi hitung. Sumber data kueri harus berupa sumber data backend. Ekspresi dapat digunakan untuk mengumpulkan data dari query deret waktu. Untuk mempelajari lebih lanjut tentang membuat dan menggunakan ekspresi, lihat Ekspresi.

2. Pilih menu kueri rekaman yang terletak di editor kueri.

3. Masukkan informasi kueri yang direkam. Semua bidang diperlukan kecuali dinyatakan lain.

   • Nama - Nama kueri yang direkam.

   • Deskripsi - (opsional) Jelaskan kueri yang direkam sesuai keinginan Anda untuk muncul dalam daftar kueri yang direkam.

   • Interval - Interval di mana snapshot akan diambil. Interval dimulai saat Anda membuat kueri yang direkam dan berhenti jika Anda menjeda atau menghapus kueri yang direkam. Untuk informasi selengkapnya tentang menjeda dan menghapus kueri yang direkam, lihat Mengelola kueri yang direkam.

   • Rentang - Rentang waktu relatif dari kueri. Jika Anda memilih rentang 30m dan interval 1 jam kueri akan mengambil snapshot setiap jam dari 30 menit terakhir.

   • Hitung hasil kueri - Jika Anda ingin menghitung baris yang dikembalikan dari kueri Anda, aktifkan opsi ini. Jika opsi ini tidak aktif, kueri Anda harus mengembalikan satu baris dengan satu nilai.

4. Uji kueri rekaman Anda dengan memilih tombol kueri yang direkam uji.

5. Pilih Mulai merekam kueri.

Menambahkan kueri yang direkam

Anda dapat menambahkan kueri rekaman yang ada ke panel di dasbor. Untuk setiap kueri rekaman yang Anda tambahkan, kueri Prometheus dibuat:. generated_recorded_query_name{id="generated_id", name="recorded query name"} Kueri yang dibuat dari Prometheus mengembalikan semua snapshot yang dikumpulkan dari kueri yang direkam.

1. Arahkan ke panel di dasbor tempat Anda ingin menambahkan kueri yang direkam.

2. Pilih menu + Kueri yang direkam.

3. Jika Anda ingin memfilter kueri yang direkam berdasarkan sumber data, pilih sumber data dari menu tarik-turun filter menurut sumber data.

4. Pilih Tambahkan menu pada kueri yang direkam untuk menambahkannya ke panel.

Setelah menambahkan kueri yang direkam ke panel, sumber data panel akan menjadi-- Mixed --. Kueri rekaman Anda diwakili oleh Prometheus kueri dengan label nama yang cocok dengan nama kueri rekaman Anda. Lihat Prometheus untuk mempelajari lebih lanjut tentang sumber data Prometheus.

Jika setelah menambahkan kueri yang direkam, kueri dengan sumber -- Mixed -- data alih-alih sumber data Prometheus muncul, ini bisa berarti bahwa target penulisan jarak jauh tidak disiapkan Prometheus untuk kueri yang direkam. Lihat target penulisan jarak jauh untuk mengatur titik tulis jarak jauh.

Menggunakan kueri yang direkam

Untuk menggunakan kueri yang direkam, buat dan tambahkan ke dasbor. Setelah itu, dapat dikelola di Preferensi dari tab Kueri yang direkam.

Mengelola kueri yang direkam

Kueri yang direkam dapat dijeda atau diaktifkan dan dihapus dari tab Kueri yang direkam di Preferensi. Menghapus kueri yang direkam akan menghapusnya dari Grafana, tetapi informasi yang dikumpulkan di Prometheus akan tetap ada di sana. Menjeda kueri yang direkam tidak akan lagi mengumpulkan titik data baru sampai dilanjutkan.

Target tulis jarak jauh

Target penulisan jarak jauh adalah sumber data Prometheus tempat titik data kueri yang direkam ditulis. Anda akan memerlukan Prometheus dengan penulisan jarak jauh diaktifkan dan Anda perlu membuat sumber data untuk Prometheus ini.

Untuk mengedit target penulisan jarak jauh pilih Edit Target Tulis Jarak Jauh di menu konsol pada tab Kueri Rekaman di Preferensi. Pilih sumber data Prometheus yang mengaktifkan penulisan jarak jauh dan masukkan jalur tulis jarak jauh.