Mengubah data

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

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

Transformasi adalah cara ampuh untuk memanipulasi data yang dikembalikan oleh kueri sebelum sistem menerapkan visualisasi. Menggunakan transformasi, Anda dapat:

Untuk pengguna yang mengandalkan beberapa tampilan dari kumpulan data yang sama, transformasi menawarkan metode yang efisien untuk membuat dan memelihara banyak dasbor.

Anda juga dapat menggunakan output dari satu transformasi sebagai masukan ke transformasi lain, yang menghasilkan peningkatan kinerja.

Jenis transformasi

Grafana menyediakan sejumlah cara agar Anda dapat mengubah data. Ada daftar lengkap fungsi transformasi di bawah ini.

Urutan transformasi

Ketika ada beberapa transformasi, Grafana menerapkannya dalam urutan yang terdaftar. Setiap transformasi menciptakan set hasil yang kemudian diteruskan ke transformasi berikutnya dalam pipa pemrosesan.

Urutan di mana Grafana menerapkan transformasi secara langsung berdampak pada hasil. Misalnya, jika Anda menggunakan transformasi Reduce untuk memadatkan semua hasil dari satu kolom menjadi satu nilai, maka Anda hanya dapat menerapkan transformasi ke nilai tunggal itu.

Menambahkan fungsi transformasi ke data

Langkah-langkah berikut memandu Anda dalam menambahkan transformasi ke data.

Debug transformasi

Untuk melihat input dan set hasil output transformasi, pilih ikon bug di sisi kanan baris transformasi.

Set hasil input dan output dapat membantu Anda men-debug transformasi.

Hapus transformasi

Kami menyarankan Anda menghapus transformasi yang tidak Anda butuhkan. Saat Anda menghapus transformasi, Anda menghapus data dari visualisasi.

Prasyarat:

Identifikasi semua dasbor yang bergantung pada transformasi dan informasikan pengguna dasbor yang terkena dampak.

Fungsi transformasi

Anda dapat melakukan transformasi berikut pada data Anda.

Tambahkan bidang dari perhitungan

Gunakan transformasi ini untuk menambahkan bidang baru yang dihitung dari dua bidang lainnya. Setiap transformasi memungkinkan Anda menambahkan satu bidang baru.

Bidang gabungan

Transformasi ini menggabungkan semua bidang dari semua frame menjadi satu hasil. Pertimbangkan dua pertanyaan ini.

Kueri A:

Kueri B:

Setelah Anda menggabungkan bidang, bingkai data akan menjadi:

Config dari hasil kueri

Transformasi ini memungkinkan Anda untuk memilih satu query dan dari itu mengekstrak opsi standar seperti Min, Max, Unit dan Thresholds dan menerapkannya ke hasil query lainnya. Ini memungkinkan konfigurasi visualisasi berbasis kueri dinamis.

Jika Anda ingin mengekstrak konfigurasi unik untuk setiap baris dalam hasil kueri konfigurasi, cobalah transformasi baris ke bidang.

Pilihan

Mengkonversi jenis bidang

Transformasi ini mengubah jenis bidang bidang yang ditentukan.

Misalnya kueri berikut dapat dimodifikasi dengan memilih bidang waktu, sebagai Waktu, dan Format Tanggal sebagai YYYY.

Hasilnya:

Filter data berdasarkan nama

Gunakan transformasi ini untuk menghapus bagian dari hasil kueri.

Grafana menampilkan bidang Identifier, diikuti oleh bidang yang dikembalikan oleh kueri Anda.

Anda dapat menerapkan filter dengan salah satu dari dua cara:

Filter data berdasarkan kueri

Gunakan transformasi ini di panel yang memiliki beberapa kueri, jika Anda ingin menyembunyikan satu atau beberapa kueri.

Grafana menampilkan surat identifikasi kueri dalam teks abu-abu gelap. Klik pengenal kueri untuk beralih pemfilteran. Jika surat kueri berwarna putih, maka hasilnya akan ditampilkan. Jika surat kueri gelap, maka hasilnya disembunyikan.

Filter data berdasarkan nilai

Transformasi ini memungkinkan Anda untuk memfilter data Anda secara langsung di Grafana dan menghapus beberapa titik data dari hasil kueri Anda. Anda memiliki opsi untuk menyertakan atau mengecualikan data yang cocok dengan satu atau beberapa kondisi yang Anda tentukan. Kondisi diterapkan pada bidang yang dipilih.

Transformasi ini berguna jika sumber data Anda tidak memfilter secara native berdasarkan nilai. Anda juga dapat menggunakan ini untuk mempersempit nilai untuk ditampilkan jika Anda menggunakan kueri bersama.

Kondisi yang tersedia untuk semua bidang adalah:

Kondisi yang tersedia untuk bidang angka adalah:

Pertimbangkan kumpulan data berikut:

Jika Anda Sertakan titik data yang memiliki suhu di bawah 30° C, konfigurasi akan terlihat sebagai berikut:

Dan Anda akan mendapatkan hasil berikut, di mana hanya suhu di bawah 30° C yang disertakan:

Anda dapat menambahkan lebih dari satu kondisi ke filter. Misalnya, Anda mungkin ingin memasukkan data hanya jika ketinggiannya lebih besar dari 100. Untuk melakukannya, tambahkan kondisi itu ke konfigurasi berikut:

Bila Anda memiliki lebih dari satu kondisi, Anda dapat memilih apakah Anda ingin tindakan (sertakan/kecualikan) diterapkan pada baris yang Cocokkan semua kondisi atau Cocokkan salah satu kondisi yang Anda tambahkan.

Pada contoh di atas kami memilih Match all karena kami ingin memasukkan baris yang memiliki suhu lebih rendah dari 30 DAN ketinggian lebih tinggi dari 100. Jika kita ingin memasukkan baris yang memiliki suhu lebih rendah dari 30 ATAU ketinggian lebih tinggi dari 100 sebagai gantinya, maka kita akan memilih Match any. Ini akan mencakup baris pertama dalam data asli, yang memiliki suhu 32° C (tidak cocok dengan kondisi pertama) tetapi ketinggian 101 (yang cocok dengan kondisi kedua), sehingga disertakan.

Kondisi yang tidak valid atau tidak lengkap dikonfigurasi diabaikan.

Grup oleh

Transformasi ini mengelompokkan data dengan nilai bidang (kolom) tertentu dan memproses perhitungan pada setiap grup. Klik untuk melihat daftar pilihan perhitungan.

Berikut adalah contoh data asli.

Transformasi ini berjalan dalam dua langkah. Pertama, Anda menentukan satu atau beberapa bidang untuk mengelompokkan data berdasarkan. Ini akan mengelompokkan semua nilai yang sama dari bidang tersebut bersama-sama, seolah-olah Anda mengurutkannya. Misalnya jika kita mengelompokkan berdasarkan bidang ID Server, maka itu akan mengelompokkan data dengan cara ini:

Semua baris dengan nilai ID Server yang sama dikelompokkan bersama.

Setelah memilih bidang mana Anda ingin mengelompokkan data Anda, Anda dapat menambahkan berbagai perhitungan pada bidang lain, dan menerapkan perhitungan untuk setiap kelompok baris. Misalnya, kita bisa menghitung suhu CPU rata-rata untuk masing-masing server tersebut. Jadi kita dapat menambahkan perhitungan rata-rata yang diterapkan pada bidang Suhu CPU untuk mendapatkan yang berikut:

Dan kita dapat menambahkan lebih dari satu perhitungan. Misalnya:

Kami kemudian akan mendapatkan:

Transformasi ini memungkinkan Anda untuk mengekstrak informasi penting dari deret waktu Anda dan menampilkannya dengan cara yang nyaman.

Bergabung dengan bidang

Gunakan transformasi ini untuk menggabungkan beberapa hasil menjadi satu tabel. Ini sangat berguna untuk mengubah beberapa hasil deret waktu menjadi satu tabel lebar dengan bidang waktu bersama.

Gabung batin

Gabungan bagian dalam menggabungkan data dari beberapa tabel di mana semua tabel berbagi nilai yang sama dari bidang yang dipilih. Jenis gabungan ini mengecualikan data di mana nilai tidak cocok di setiap hasil.

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri (menggabungkan pada bidang gabungan yang diteruskan atau kolom pertama kali) menjadi satu hasil, dan jatuhkan baris di mana gabungan yang berhasil tidak dapat terjadi.

Dalam contoh berikut, dua query mengembalikan data tabel. Ini divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi gabungan batin.

Kueri A:

Kueri B:

Hasil setelah menerapkan transformasi gabungan batin terlihat seperti berikut:

Bergabung di luar

Gabungan luar mencakup semua data dari gabungan dalam dan baris di mana nilai tidak cocok di setiap input. Sementara gabungan bagian dalam bergabung dengan Kueri A dan Kueri B pada bidang waktu, gabungan luar mencakup semua baris yang tidak cocok di bidang waktu.

Dalam contoh berikut, dua query mengembalikan data tabel. Ini divisualisasikan sebagai dua tabel sebelum menerapkan transformasi gabungan luar.

Kueri A:

Kueri B:

Hasil setelah menerapkan transformasi gabungan luar terlihat seperti berikut:

Label ke bidang

Transformasi ini mengubah hasil deret waktu yang menyertakan label atau tag ke dalam tabel di mana setiap kunci label dan nilai disertakan dalam hasil tabel. Label dapat ditampilkan baik sebagai kolom atau sebagai nilai baris.

Diberikan hasil query dari dua deret waktu:

Dalam mode Kolom, hasilnya terlihat seperti ini:

Dalam mode “Baris”, hasilnya memiliki tabel untuk setiap seri dan menunjukkan setiap nilai label seperti ini:

Nama bidang nilai

Jika Anda memilih Server sebagai nama bidang Nilai, maka Anda akan mendapatkan satu bidang untuk setiap nilai label Server.

Perilaku penggabungan

Label ke bidang transformator secara internal adalah dua transformasi terpisah. Tindakan pertama pada seri tunggal dan mengekstrak label ke bidang. Yang kedua adalah transformasi gabungan yang menggabungkan semua hasil menjadi satu tabel. Transformasi gabungan mencoba bergabung di semua bidang yang cocok. Langkah penggabungan ini diperlukan dan tidak dapat dimatikan.

Untuk mengilustrasikan hal ini, berikut adalah contoh di mana Anda memiliki dua kueri yang mengembalikan deret waktu tanpa label yang tumpang tindih.

Ini pertama-tama akan menghasilkan dua tabel ini:

Setelah bergabung:

Gabungkan

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri menjadi satu hasil tunggal. Ini sangat membantu saat menggunakan visualisasi panel tabel. Nilai yang dapat digabungkan digabungkan ke dalam baris yang sama. Nilai dapat digabungkan jika bidang bersama berisi data yang sama.

Dalam contoh di bawah ini, kita memiliki dua query mengembalikan data tabel. Ini divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi.

Kueri A:

Kueri B:

Berikut adalah hasilnya setelah menerapkan transformasi Merge:

Mengatur bidang

Gunakan transformasi ini untuk mengganti nama, menyusun ulang, atau menyembunyikan bidang yang dikembalikan oleh kueri.

Grafana menampilkan daftar bidang yang dikembalikan oleh kueri. Anda dapat:

Partisi berdasarkan nilai

Transformasi ini dapat membantu menghilangkan kebutuhan akan beberapa kueri ke sumber data yang sama dengan WHERE klausa yang berbeda saat membuat grafik beberapa seri. Pertimbangkan tabel SQL metrik dengan data berikut:

Sebelum v9.3, jika Anda ingin merencanakan garis tren merah untuk AS dan yang biru untuk UE di TimeSeries panel yang sama, Anda mungkin harus membaginya menjadi dua kueri:

SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'

Ini juga mengharuskan Anda untuk mengetahui sebelumnya wilayah mana yang benar-benar ada dalam tabel metrik.

Dengan transformator Partition by values, Anda sekarang dapat mengeluarkan satu kueri dan membagi hasilnya dengan nilai unik dalam satu atau lebih kolom (fields) pilihan Anda. Contoh berikut menggunakan Region.

SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'

Kurangi

Transformasi Reduce menerapkan perhitungan untuk setiap bidang dalam frame dan mengembalikan nilai tunggal. Bidang waktu dihapus saat menerapkan transformasi ini.

Pertimbangkan masukannya:

Kueri A:

Kueri B:

Trafo reduksi memiliki dua mode:

Misalnya, jika Anda menggunakan perhitungan Pertama dan Terakhir dengan transformasi Seri ke baris, maka hasilnya adalah:

Kolom Reduce dengan perhitungan Terakhir, menghasilkan dua frame, masing-masing dengan satu baris:

Kueri A:

Kueri B:

Ganti nama dengan regex

Gunakan transformasi ini untuk mengganti nama bagian dari hasil kueri menggunakan ekspresi reguler dan pola penggantian.

Anda dapat menentukan ekspresi reguler, yang hanya diterapkan pada kecocokan, bersama dengan pola pengganti yang mendukung referensi kembali. Misalnya, bayangkan Anda memvisualisasikan penggunaan CPU per host dan Anda ingin menghapus nama domain. Anda dapat mengatur regex ke ([^\.]+)\..+ dan pola penggantian ke$1, web-01.example.com akan menjadi. web-01

Baris ke bidang

Transformasi baris ke bidang mengubah baris menjadi bidang terpisah. Ini dapat berguna karena bidang dapat ditata dan dikonfigurasi secara individual. Ini juga dapat menggunakan bidang tambahan sebagai sumber untuk konfigurasi bidang dinamis atau memetakannya ke label bidang. Label tambahan kemudian dapat digunakan untuk menentukan nama tampilan yang lebih baik untuk bidang yang dihasilkan.

Transformasi ini mencakup tabel bidang yang mencantumkan semua bidang dalam data yang dikembalikan oleh kueri konfigurasi. Tabel ini memberi Anda kontrol atas bidang apa yang harus dipetakan ke setiap properti konfigurasi (opsi *Gunakan sebagai**). Anda juga dapat memilih nilai mana yang akan dipilih jika ada beberapa baris dalam data yang dikembalikan.

Transformasi ini membutuhkan:

Berguna saat memvisualisasikan data di:

Petakan bidang tambahan ke label

Jika bidang tidak dipetakan ke properti konfigurasi Grafana akan secara otomatis menggunakannya sebagai sumber untuk label pada bidang keluaran-

Contoh:

Output:

Label tambahan sekarang dapat digunakan dalam nama tampilan bidang memberikan nama bidang yang lebih lengkap.

Jika Anda ingin mengekstrak konfigurasi dari satu kueri dan menerapkannya ke kueri lain, Anda harus menggunakan konfigurasi dari transformasi hasil kueri.

Contoh

Masukan:

Output:

Seperti yang Anda lihat setiap baris dalam data sumber menjadi bidang terpisah. Setiap bidang sekarang juga memiliki set opsi konfigurasi maks. Opsi seperti Min, Max, Unit dan Thresholds adalah bagian dari konfigurasi bidang dan jika diatur seperti ini akan digunakan oleh visualisasi alih-alih opsi apa pun yang dikonfigurasi secara manual di panel opsi editor panel.

Siapkan deret waktu

Mempersiapkan transformasi deret waktu berguna ketika sumber data mengembalikan data deret waktu dalam format yang tidak didukung oleh panel yang ingin Anda gunakan.

Transformasi ini membantu Anda mengatasi masalah ini dengan mengonversi data deret waktu dari format lebar ke format panjang atau sebaliknya.

Pilih opsi deret waktu Multi-frame untuk mengubah kerangka data deret waktu dari format lebar ke format panjang.

Pilih opsi Wide time series untuk mengubah kerangka data deret waktu dari format panjang ke format lebar.

Seri ke baris

Gunakan transformasi ini untuk menggabungkan hasil dari beberapa kueri data deret waktu menjadi satu hasil tunggal. Ini sangat membantu saat menggunakan visualisasi panel tabel.

Hasil dari transformasi ini akan berisi tiga kolom: Waktu, Metrik, dan Nilai. Kolom Metrik ditambahkan sehingga Anda dapat dengan mudah melihat dari mana kueri metrik berasal. Sesuaikan nilai ini dengan mendefinisikan Label pada kueri sumber.

Pada contoh di bawah ini, kami memiliki dua pertanyaan yang mengembalikan data deret waktu. Ini divisualisasikan sebagai dua tabel terpisah sebelum menerapkan transformasi.

Kueri A:

Kueri B:

Berikut adalah hasil setelah menerapkan Seri ke transformasi baris.

Urutkan berdasarkan

Transformasi ini akan mengurutkan setiap frame dengan bidang yang dikonfigurasi, Ketika reverse dicentang, nilai akan kembali dalam urutan yang berlawanan.

Batasi

Gunakan transformasi ini untuk membatasi jumlah baris yang ditampilkan.

Pada contoh di bawah ini, kami memiliki respons berikut dari sumber data:

Berikut adalah hasil setelah menambahkan transformasi Limit dengan nilai '3':