Mengajukan Kueri

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

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

Panel ruang kerja Grafana menggunakan Kueri untuk berkomunikasi dengan sumber data untuk mendapatkan data untuk visualisasi. Query adalah pertanyaan yang ditulis dalam bahasa query yang digunakan oleh sumber data. Jika kueri terbentuk dengan benar, sumber data merespons. Dalam opsi sumber data panel, Anda dapat menyesuaikan seberapa sering kueri dikirim ke sumber data dan berapa banyak titik data yang dikumpulkan.

Ruang kerja Grafana mendukung hingga 26 kueri per panel.

Editor kueri

Editor kueri adalah formulir yang membantu Anda menulis kueri. Bergantung pada sumber data Anda, editor kueri mungkin memberikan penyelesaian otomatis, nama metrik, atau saran variabel.

Karena perbedaan antara bahasa kueri, sumber data mungkin memiliki editor kueri yang terlihat berbeda.

Sintaks kueri

Sumber data memiliki bahasa kueri dan sintaks yang berbeda untuk meminta data. Berikut adalah dua contoh kueri.

PostgreSQL

SELECT hostname FROM host WHERE region IN($region)

PromQL

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

Untuk informasi selengkapnya tentang menulis kueri untuk sumber data Anda, lihat dokumentasi untuk sumber data tersebut. Sumber data tercantum dalamSumber data.

Tab kueri UI

Tab Query terdiri dari elemen-elemen berikut:

• Pemilih sumber data

• Opsi kueri

• Tombol inspektur kueri

• Daftar editor kueri

Pemilih sumber data

Pemilih sumber data adalah daftar dropdown. Pilih untuk memilih sumber data yang telah Anda tambahkan. Saat Anda membuat panel, Grafana Terkelola Amazon secara otomatis memilih sumber data default Anda. Untuk informasi selengkapnya tentang sumber data, lihatSumber data.

Selain sumber data yang telah Anda konfigurasikan di ruang kerja Grafana Anda, tiga sumber data khusus tersedia.

• TestDataDB — Sumber data bawaan yang menghasilkan data berjalan acak. Sumber data Grafana berguna untuk menguji visualisasi dan menjalankan eksperimen.

• Campuran — Sumber data untuk menanyakan beberapa sumber data di panel yang sama. Saat sumber data ini dipilih, Anda dapat memilih sumber data untuk setiap kueri baru yang Anda tambahkan.

  • Kueri pertama akan menggunakan sumber data yang dipilih sebelum Anda memilih Mixed.

  • Anda tidak dapat mengubah kueri yang ada untuk menggunakan sumber data Campuran.

• Dasbor —Sumber data untuk menggunakan set hasil dari panel lain di dasbor yang sama.

Opsi kueri

Untuk melihat setelan sumber data yang dipilih, pilih Opsi kueri di sebelah pemilih sumber data. Perubahan yang Anda buat di sini hanya memengaruhi kueri yang dibuat di panel ini.

Grafana Terkelola Amazon 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.

Anda dapat menggunakan opsi kueri sumber data panel berikut:

• Titik data maks - Jika sumber data mendukungnya, tetapkan jumlah maksimum titik data untuk setiap seri yang dikembalikan. Jika kueri mengembalikan lebih banyak titik data daripada pengaturan titik data maks, sumber data mengkonsolidasikannya (mengurangi jumlah poin yang dikembalikan dengan menggabungkannya bersama dengan rata-rata atau maks atau fungsi lainnya).

  Ada dua alasan utama untuk membatasi jumlah poin: kinerja dan menghaluskan garis. Nilai default adalah lebar (atau jumlah piksel) grafik, yang menghindari memiliki lebih banyak titik data daripada yang dapat ditampilkan panel grafik.

  Dengan data streaming, nilai titik data maks digunakan untuk buffer bergulir. (Streaming adalah aliran data yang berkelanjutan, dan buffering adalah cara untuk membagi aliran menjadi beberapa bagian).

• Interval min - Menetapkan batas minimum untuk interval yang dihitung secara otomatis, biasanya interval pengikisan minimum. Jika titik data disimpan setiap 15 detik, Anda tidak perlu memiliki interval yang lebih rendah dari itu. Kasus penggunaan lainnya adalah mengaturnya ke minimum yang lebih tinggi daripada interval pengikisan untuk mendapatkan kueri yang lebih kasar dan berfungsi dengan baik.

• Interval — Rentang waktu yang dapat Anda gunakan saat menggabungkan atau mengelompokkan titik data berdasarkan waktu.

  Grafana yang Dikelola Amazon secara otomatis menghitung interval yang sesuai yang dapat digunakan sebagai variabel dalam kueri templat. Variabelnya dalam detik:$__interval; atau dalam milidetik:$__interval_ms. Hal ini biasanya digunakan dalam fungsi agregasi seperti sum atauaverage. Misalnya, ini adalah kueri Prometheus menggunakan variabel interval:. rate(http_requests_total[$__interval])

  Interval otomatis ini dihitung berdasarkan lebar grafik. Jika pengguna memperkecil banyak, interval menjadi lebih besar sehingga menghasilkan agregasi yang lebih kasar. Jika pengguna memperbesar, interval berkurang sehingga menghasilkan agregasi yang lebih halus.

  Untuk informasi selengkapnya, lihat Variabel global.

• Waktu relatif — Ganti rentang waktu relatif untuk panel individu yang menyebabkannya berbeda dari apa yang dipilih di pemilih waktu dasbor di sudut kanan atas dasbor. Ini memungkinkan Anda menampilkan metrik dari periode waktu atau hari yang berbeda di dasbor yang sama.

• Pergeseran waktu - Menyediakan cara lain untuk mengganti rentang waktu untuk panel individu. Fungsi ini hanya berfungsi dengan rentang waktu relatif, dan Anda dapat menyesuaikan rentang waktu.

  Misalnya, Anda dapat menggeser rentang waktu panel menjadi 2 jam lebih awal dari pemilih waktu dasbor. Untuk informasi selengkapnya, lihat Kontrol rentang waktu.

• Cache timeout — (Bidang ini hanya terlihat jika tersedia di sumber data Anda.) Mengganti batas waktu cache default jika toko deret waktu Anda memiliki cache kueri. Ini ditentukan sebagai nilai numerik dalam hitungan detik.

Tombol inspektur kueri

Anda dapat memilih Query inspector untuk membuka tab Query dari panel inspector. Pada tab Query, Anda dapat melihat permintaan kueri yang dikirim oleh panel dan responsnya.

Pilih Segarkan untuk melihat teks lengkap permintaan yang dikirim oleh panel ini ke server.

catatan

Anda perlu menambahkan setidaknya satu kueri sebelum inspektur Kueri dapat mengembalikan hasil.

Untuk informasi lebih lanjut tentang inspektur panel, lihatPeriksa panel.

Daftar editor kueri

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

Berbagi hasil kueri antar panel

Dengan Amazon Managed Grafana, Anda dapat menggunakan hasil kueri dari satu panel untuk panel lain di dasbor. Berbagi hasil kueri di seluruh panel mengurangi jumlah kueri yang dibuat ke sumber data Anda, yang dapat meningkatkan kinerja dasbor Anda.

Sumber data Dasbor memungkinkan Anda memilih panel di dasbor yang berisi kueri yang ingin Anda bagikan hasilnya. Alih-alih mengirim kueri terpisah untuk setiap panel, Amazon Managed Grafana mengirimkan satu kueri, dan panel lainnya menggunakan hasil kueri untuk membuat visualisasi.

Strategi ini dapat secara drastis mengurangi jumlah kueri yang dibuat ketika, misalnya, Anda memiliki beberapa panel yang memvisualisasikan data yang sama.

Untuk berbagi kueri sumber data dengan panel lain

1. Buat dasbor. Untuk informasi selengkapnya, lihat Membuat dasbor.

2. Tambahkan panel. Untuk informasi selengkapnya, lihat Menambahkan panel.

3. Ubah judul menjadiSource panel. Anda akan menggunakan panel ini sebagai sumber untuk panel lainnya. Tentukan kueri atau kueri yang akan dibagikan. Jika Anda tidak memiliki sumber data yang tersedia saat ini, Anda dapat menggunakan sumber data Grafana, yang mengembalikan deret waktu acak yang dapat Anda gunakan untuk pengujian.

4. Tambahkan panel kedua, lalu pilih sumber data Dasbor di editor kueri.

5. Di Gunakan hasil dari daftar panel, pilih panel pertama yang Anda buat.

Semua query didefinisikan dalam panel sumber sekarang tersedia untuk panel baru. Kueri yang dibuat di panel sumber dapat dibagikan dengan beberapa panel.

Untuk pergi ke panel di mana kueri didefinisikan, pilih kueri itu.