Kueri dan transformasi data - Amazon Managed Grafana
Tentang pertanyaanNavigasikan tab kueriTambahkan kueriKelola kueriOpsi kueri

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Kueri dan transformasi data

Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.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 8.x, lihat. Bekerja di Grafana versi 8

Grafana mendukung banyak jenis sumber data. Kueri sumber data mengembalikan data yang dapat diubah dan divisualisasikan oleh Grafana. Setiap sumber data menggunakan bahasa kueri sendiri, dan plugin sumber data masing-masing menerapkan antarmuka pengguna yang membangun kueri yang disebut editor kueri.

Tentang pertanyaan

Panel Grafana berkomunikasi dengan sumber data melalui kueri, yang mengambil data untuk visualisasi. Query adalah pertanyaan yang ditulis dalam bahasa query yang digunakan oleh sumber data.

Anda dapat mengonfigurasi frekuensi kueri dan batas pengumpulan data dalam opsi sumber data panel. Grafana mendukung hingga 26 kueri per panel.

Anda dapat menemukan informasi selengkapnya tentang bahasa kueri setiap sumber data di bagian Sumber data.

Editor kueri

Setiap editor kueri sumber data menyediakan antarmuka pengguna yang disesuaikan yang membantu Anda menulis kueri yang memanfaatkan kemampuan uniknya.

Karena perbedaan antara bahasa kueri, setiap editor kueri sumber data terlihat dan berfungsi secara berbeda. Bergantung pada sumber data Anda, editor kueri mungkin menyediakan fitur pelengkapan otomatis, nama metrik, saran variabel, atau antarmuka pembuatan kueri visual.

Untuk detail tentang fitur editor kueri unik sumber data tertentu, lihat dokumentasinya:

Sintaks kueri

Sumber data menggunakan bahasa kueri yang berbeda untuk meminta data. Untuk detail tentang bahasa kueri unik sumber data tertentu, lihat dokumentasinya.

Contoh PostgreSQL:

SELECT hostname FROM host WHERE region IN($region)

Contoh PromQL:

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

Sumber data khusus

Grafana juga mencakup tiga sumber data khusus: Grafana, Campuran, dan Dasbor. Untuk detailnya, lihat Sumber data

Navigasikan tab kueri

Tab Query panel terdiri dari elemen-elemen berikut:

  • Pemilih sumber data - Memilih sumber data untuk kueri.

  • Opsi kueri: — Menetapkan parameter pengambilan data maksimum dan interval waktu menjalankan kueri.

  • Tombol inspektur kueri: — Membuka panel inspektur kueri, tempat Anda dapat melihat dan mengoptimalkan kueri Anda.

  • Daftar editor kueri: — Daftar kueri yang telah Anda tulis.

  • Ekspresi: — Menggunakan pembuat ekspresi untuk membuat ekspresi peringatan. Untuk informasi selengkapnya tentang ekspresi, lihatTulis kueri ekspresi.

Tambahkan kueri

Kueri mengembalikan data yang divisualisasikan Grafana di panel dasbor. Saat Anda membuat panel, Grafana secara otomatis memilih sumber data default.

Untuk menambahkan kueri

  1. Edit panel tempat Anda menambahkan kueri.

  2. Pilih tab Kueri.

  3. Pilih menu tarik-turun Sumber data dan pilih sumber data.

  4. Pilih opsi Kueri untuk mengonfigurasi jumlah maksimum titik data yang Anda butuhkan. Untuk informasi selengkapnya tentang opsi kueri, lihatOpsi kueri.

  5. Tulis kueri menggunakan editor kueri.

  6. Pilih Terapkan.

Grafana menanyakan sumber data dan memvisualisasikan data.

Kelola kueri

Grafana mengatur kueri dalam baris kueri yang dapat dilipat. Setiap baris kueri berisi editor kueri dan diidentifikasi dengan huruf (A, B, C, dan sebagainya).

Untuk mengelola kueri, Anda dapat menyalin kueri, menyembunyikan kueri, menghapus kueri, menyusun ulang kueri, dan beralih bantuan untuk editor kueri.

Opsi kueri

Pilih Opsi kueri di sebelah pemilih sumber data untuk melihat pengaturan sumber data yang dipilih. Perubahan yang Anda buat di sini hanya memengaruhi kueri yang dibuat di panel ini.

Grafana menetapkan default yang ditampilkan dalam teks abu-abu gelap. Perubahan ditampilkan dalam teks putih. Untuk mengembalikan bidang ke pengaturan default, hapus teks putih dari bidang.

Opsi kueri sumber data panel meliputi:

  • Titik data maksimum - Jika sumber data mendukungnya, ini menetapkan jumlah maksimum titik data untuk setiap seri yang dikembalikan. Jika kueri mengembalikan lebih banyak titik data daripada pengaturan titik data maks, maka sumber data mengurangi jumlah poin yang dikembalikan dengan menggabungkannya bersama dengan rata-rata, maks, atau fungsi lain.

    Anda dapat membatasi jumlah poin untuk meningkatkan kinerja kueri atau menghaluskan garis yang divisualisasikan. Nilai default adalah lebar (atau jumlah piksel) grafik, karena Anda hanya dapat memvisualisasikan titik data sebanyak panel grafik memiliki ruang untuk ditampilkan.

    Dengan streaming data, Grafana menggunakan nilai titik data maksimal untuk buffer bergulir. Streaming adalah aliran data yang berkelanjutan, dan buffering membagi aliran menjadi beberapa bagian. Misalnya, Loki mengalirkan data dalam mode tailing langsungnya.

  • Interval min - Menetapkan batas minimum untuk interval yang dihitung secara otomatis, yang biasanya merupakan interval pengikisan minimum. Jika titik data disimpan setiap 15 detik, Anda tidak mendapat manfaat dari interval yang lebih rendah dari itu. Anda juga dapat mengatur ini ke minimum yang lebih tinggi daripada interval scrape untuk mengambil kueri yang lebih kasar dan berfungsi dengan baik.

  • Interval - Menetapkan rentang waktu yang dapat Anda gunakan saat menggabungkan atau mengelompokkan titik data berdasarkan waktu.

    Grafana secara otomatis menghitung interval yang sesuai yang dapat Anda gunakan sebagai variabel dalam kueri templat. Variabel diukur dalam detik ($__interval) atau milidetik ($__interval_ms).

    Interval biasanya digunakan dalam fungsi agregasi seperti jumlah atau rata-rata. Misalnya, ini adalah kueri Prometheus yang menggunakan variabel interval:. rate(http_requests_total[$__interval])

    Interval otomatis ini dihitung berdasarkan lebar grafik. Saat pengguna memperkecil visualisasi, interval tumbuh, menghasilkan agregasi yang lebih kasar. Demikian juga, jika pengguna memperbesar, intervalnya berkurang, menghasilkan agregasi yang lebih halus.

    Untuk informasi selengkapnya, lihat Variabel global.

  • Waktu relatif — Mengganti rentang waktu relatif untuk panel individu, yang menyebabkannya berbeda dari apa yang dipilih di pemilih waktu dasbor di sudut kanan atas dasbor. Anda dapat menggunakan ini untuk menampilkan metrik dari periode waktu atau hari yang berbeda di dasbor yang sama.

    catatan

    Penggantian waktu panel tidak berpengaruh ketika rentang waktu dasbor mutlak.

    Contoh Bidang waktu relatif

    5 menit terakhir

    now-5m

    Hari sejauh ini

    now/d

    5 hari terakhir

    now-5d/d

    Minggu ini sejauh ini

    now/w

    2 tahun terakhir

    now-2y/y

  • Pergeseran waktu — Mengganti rentang waktu untuk panel individu dengan menggeser awal dan akhir relatif terhadap pemilih waktu. Misalnya, Anda dapat menggeser rentang waktu panel menjadi dua jam lebih awal dari pemilih waktu dasbor.

    catatan

    Penggantian waktu panel tidak berpengaruh ketika rentang waktu dasbor mutlak.

    Contoh Bidang pergeseran waktu

    Seluruh minggu terakhir

    1w/w

    Dua minggu yang lalu

    2w/w

    Seluruh bulan terakhir

    1M/M

    Sepanjang tahun ini

    1d/y

    Sepanjang tahun lalu

    1y/y

  • Batas waktu cache — (Terlihat hanya jika tersedia di sumber data) Mengganti batas waktu cache default jika toko deret waktu Anda memiliki cache kueri. Tentukan nilai ini sebagai nilai numerik dalam hitungan detik.