Connect ke sumber data Graphite

Grafana memiliki editor kueri Grafit canggih yang memungkinkan Anda menavigasi ruang metrik dengan cepat, menambahkan fungsi, mengubah parameter fungsi, dan banyak lagi. Editor dapat menangani semua jenis kueri grafit. Bahkan dapat menangani kueri bersarang yang kompleks melalui penggunaan referensi kueri.

Pengaturan grafit

Untuk mengakses pengaturan Graphite, jeda pada ikon Konfigurasi (roda gigi), lalu pilih Sumber Data, lalu pilih sumber data grafit.

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	Protokol HTTP, IP, dan port instalasi graphite-web atau grafit-api Anda.
Access	Server (default) = URL harus dapat diakses dari backend/server Grafana.
Auth
Basic Auth	Aktifkan otentikasi dasar ke sumber data.
User	Nama pengguna untuk otentikasi dasar.
Password	Kata sandi untuk otentikasi dasar.
Custom HTTP Headers	Pilih Tambahkan header untuk menambahkan header HTTP kustom.
Header	Masukkan nama header kustom.
Value	Masukkan nilai header kustom.
Graphite details
Version	Pilih versi Graphite Anda.
Type	Pilih jenis Grafit Anda.

Mode akses mengontrol bagaimana permintaan ke sumber data akan ditangani. Server harus menjadi cara yang disukai jika tidak ada hal lain yang dinyatakan.

Mode akses server (default)

Semua permintaan dibuat dari browser ke Amazon Managed Grafana, yang meneruskan permintaan ke sumber data, menghindari kemungkinan persyaratan Cross-Origin Resource Sharing (CORS). Jika Anda memilih mode akses ini, URL harus dapat diakses dari Grafana Terkelola Amazon.

Mode akses browser

Grafana yang Dikelola Amazon tidak mendukung akses langsung browser untuk sumber data Graphite.

Editor kueri grafit

Grafana menyertakan editor kueri khusus Graphite untuk membantu Anda membangun kueri.

Untuk melihat teks mentah dari kueri yang dikirim ke Graphite, pilih ikon Toggle text edit mode (pensil).

Memilih metrik untuk kueri

Pilih Pilih metrik untuk menavigasi ruang metrik. Setelah Anda mulai, Anda dapat terus menggunakan tombol panah penunjuk atau keyboard. Anda dapat memilih karakter wildcard dan masih melanjutkan.

Fungsi

Untuk menambahkan fungsi, pilih ikon plus di sebelah Fungsi. Anda dapat mencari fungsi atau memilihnya dari menu. Setelah fungsi dipilih, itu akan ditambahkan dan fokus Anda akan berada di kotak teks parameter pertama. Untuk mengedit atau mengubah parameter, pilih dan itu akan berubah menjadi kotak teks. - Untuk menghapus fungsi, pilih nama fungsi diikuti oleh ikon x.

Beberapa fungsi, sepertialiasByNode, mendukung argumen kedua opsional. Untuk menambahkan argumen, jeda pada argumen pertama, lalu pilih + simbol yang muncul. Untuk menghapus parameter opsional kedua, pilih dan biarkan kosong. Editor akan menghapusnya.

Urutkan label

Jika Anda ingin pemesanan yang konsisten, gunakansortByName. Ini bisa mengganggu ketika Anda memiliki label yang sama pada beberapa grafik, dan keduanya diurutkan secara berbeda dan menggunakan warna yang berbeda. Untuk memperbaikinya, gunakansortByName().

Kueri bersarang

Anda dapat mereferensikan kueri dengan huruf baris yang mereka gunakan (mirip dengan Microsoft Excel). Jika Anda menambahkan kueri kedua ke grafik, Anda dapat mereferensikan kueri pertama dengan mengetik #A. Ini menyediakan cara mudah untuk membuat kueri gabungan.

Menghindari banyak pertanyaan dengan menggunakan karakter wildcard

Kadang-kadang, Anda mungkin ingin melihat beberapa deret waktu diplot pada grafik yang sama. Misalnya, Anda mungkin ingin melihat bagaimana CPU digunakan pada mesin. Anda mungkin awalnya membuat grafik dengan menambahkan kueri untuk setiap deret waktu, seperti cpu.percent.user.gcpu.percent.system.g,, dan sebagainya. Ini menghasilkan n kueri yang dibuat ke sumber data, yang tidak efisien.

Agar lebih efisien, seseorang dapat menggunakan karakter wildcard dalam pencarian Anda, mengembalikan semua deret waktu dalam satu kueri. Misalnya, cpu.percent.*.g.

Memodifikasi nama metrik dalam tabel atau bagan

Gunakan alias fungsi untuk mengubah nama metrik pada tabel atau grafik Grafana; misalnya, atau. aliasByNode() aliasSub()

Konsolidasi titik

Semua metrik Graphite dikonsolidasikan sehingga Graphite tidak mengembalikan lebih banyak titik data daripada piksel dalam grafik. Secara default, konsolidasi ini dilakukan dengan menggunakan avg fungsi. Anda dapat mengontrol bagaimana Graphite mengkonsolidasikan metrik dengan menambahkan fungsi Graphite ConsolidateBy.

catatan

Ini berarti bahwa nilai ringkasan legenda (maks, min, total) tidak dapat semuanya benar pada saat yang bersamaan. Mereka dihitung sisi klien oleh Grafana. Dan tergantung pada fungsi konsolidasi Anda, hanya satu atau dua yang bisa benar pada saat yang bersamaan.

Menggabungkan deret waktu

Untuk menggabungkan deret waktu, pilih Gabungkan dalam daftar Fungsi.

Eksplorasi data dan tag

Dalam Graphite, semuanya adalah tag.

Saat menjelajahi data, tag yang dipilih sebelumnya digunakan untuk memfilter kumpulan hasil yang tersisa. Untuk memilih data, Anda menggunakan seriesByTag fungsi, yang mengambil ekspresi tag (=,, !==~,!=~) untuk memfilter deret waktu.

Pembuat kueri Grafana melakukan ini untuk Anda secara otomatis saat Anda memilih tag.

catatan

Tip: Pencarian ekspresi reguler bisa lambat pada tag kardinalitas tinggi, jadi coba gunakan tag lain untuk mengurangi cakupan terlebih dahulu. Memulai dengan nama atau namespace tertentu membantu mengurangi hasilnya.

Variabel template

Alih-alih melakukan hardcoding hal-hal seperti server, aplikasi, dan nama sensor dalam kueri metrik Anda, Anda dapat menggunakan variabel di tempatnya. 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.

Untuk membuat variabel menggunakan nilai tag, gunakan fungsi tags Grafana dan. tag_values

Kueri	Deskripsi
tags()	Mengembalikan semua tag.
tags(server=~backend\*)	Mengembalikan hanya tag yang terjadi dalam seri yang cocok dengan ekspresi filter.
tag_values(server)	Mengembalikan nilai tag untuk tag yang ditentukan.
tag_values(server, server=~backend\*)	Mengembalikan nilai tag yang disaring yang terjadi untuk tag tertentu dalam seri yang cocok dengan ekspresi tersebut.
tag_values(server, server=~backend\*, app=~${apps:regex})	Beberapa ekspresi dan ekspresi filter dapat berisi variabel lain.

Untuk detail selengkapnya, lihat Dokumen grafit pada API pelengkapan otomatis untuk tag.

Variabel kueri

Kueri yang Anda tentukan di bidang kueri harus berupa jenis kueri pencarian metrik. Misalnya, kueri seperti prod.servers.* akan mengisi variabel dengan semua nilai yang mungkin ada di posisi wildcard.

Anda juga dapat membuat variabel bersarang yang menggunakan variabel lain dalam definisi mereka. Misalnya apps.$app.servers.* menggunakan variabel $app dalam definisi query nya.

Menggunakan __searchFilter untuk memfilter hasil variabel kueri

Menggunakan __searchFilter di bidang kueri akan memfilter hasil kueri berdasarkan apa yang Anda masukkan di kotak pilih tarik-turun. Ketika Anda tidak memasukkan apa-apa, nilai default untuk __searchFilter adalah * dan ``ketika digunakan sebagai bagian dari ekspresi reguler.

Contoh berikut menunjukkan cara menggunakan __searchFilter sebagai bagian dari bidang query untuk mengaktifkan pencarian server sementara pengguna memasukkan teks dalam kotak pilih dropdown.

Kueri

apps.$app.servers.$__searchFilter

TagValues

tag_values(server, server=~${__searchFilter:regex})

Penggunaan variabel

Anda dapat menggunakan variabel dalam jalur simpul metrik atau sebagai parameter untuk suatu fungsi.

Ada dua sintaks:

• $<varname>Contoh: apps.frontend. $ server.requests.count

• ${varname}Contoh: apps.frontend. $ {server} .requests.count

Mengapa dua cara? Sintaks pertama lebih mudah dibaca dan ditulis tetapi tidak memungkinkan Anda menggunakan variabel di tengah kata. Gunakan sintaks kedua dalam ekspresi sepertimy.server${serverNumber}.count.

Penggunaan variabel dalam kueri tag

Variabel multi-nilai dalam kueri tag menggunakan sintaks pemformatan lanjutan yang diperkenalkan di Grafana 5.0 untuk variabel:. {var:regex} Kueri non-tag akan menggunakan pemformatan glob default untuk variabel multi-nilai.

Contoh kode berikut menunjukkan ekspresi tag dengan pemformatan regex dan menggunakan operator Equal Tilde,. =~

server=~${servers:regex}

Untuk informasi selengkapnya, lihat Opsi format variabel lanjutan.

Anotasi

Anotasi memungkinkan Anda untuk melapisi informasi peristiwa yang kaya di atas grafik. Anda menambahkan kueri anotasi melalui menu Dasbor/tampilan Anotasi. Untuk informasi selengkapnya, lihat Anotasi.

Graphite mendukung dua cara untuk menanyakan anotasi:

• Kueri metrik reguler. Untuk ini, Anda menggunakan kotak teks kueri Graphite.

• Sebuah query peristiwa grafit. Untuk ini, Anda menggunakan kotak Graphite event tags teks, dan menentukan tag atau karakter wildcard (menjaganya tetap kosong juga harus berfungsi).