Berdasarkan plugin komunitas open-source, Alibaba Cloud Kibana menyediakan dua plugin pra-instal: BSearch-QueryBuilder dan bsearch_label. Topik ini menjelaskan cara menginstal dan menghapus plugin Kibana tersebut.
Instal plugin
Catatan penggunaan
Plugin Kibana hanya didukung pada versi Alibaba Cloud Elasticsearch 6.3 dan 6.7.
Sebelum menginstal plugin, pastikan node Kibana Anda memiliki setidaknya 2 vCPU dan memori 4 GB. Jika node Kibana Anda tidak memenuhi persyaratan ini, lakukan upgrade. Untuk informasi selengkapnya, lihat upgrade konfigurasi kluster.
Anda tidak dapat menginstal plugin Kibana kustom.
Prosedur
Masuk ke Konsol Alibaba Cloud Elasticsearch.
Di panel navigasi sebelah kiri, klik Elasticsearch Clusters.
Di bilah navigasi atas, pilih kelompok sumber daya dan wilayah.
Pada halaman Elasticsearch Clusters, klik ID kluster target.
Di panel navigasi sebelah kiri, klik Data Visualization.
Pada bagian Kibana, klik Modify Configuration.
Pada bagian Plug-in Configuration, temukan plugin yang ingin Anda instal dan klik Install di kolom Actions.
PentingMenginstal plugin akan memicu restart node Kibana. Selama proses restart, layanan Kibana tidak tersedia. Disarankan untuk melakukan operasi ini pada jam sepi.
Pada kotak dialog Installation Prompt, klik OK.
Setelah node direstart, plugin akan terinstal. Status plugin berubah menjadi Installed.
Kueri data menggunakan BSearch-QueryBuilder
BSearch-QueryBuilder adalah plugin front-end saja yang memungkinkan Anda membuat permintaan pencarian kompleks secara visual tanpa menulis pernyataan DSL yang rumit. Bagian ini menjelaskan cara menggunakan plugin BSearch-QueryBuilder untuk mengkueri data.
Informasi latar belakang
Query DSL adalah framework Java open-source untuk membangun kueri SQL yang aman dari segi tipe. Framework ini memungkinkan Anda menyusun kueri menggunakan API alih-alih menggabungkan string. Query DSL mendukung platform seperti JPA, JDO, SQL, Java Collections, RDF, Lucene, dan Hibernate Search.
Elasticsearch menyediakan DSL berbasis JSON yang komprehensif untuk mendefinisikan kueri. Query DSL terdiri dari serangkaian ekspresi kueri abstrak. Kueri tertentu dapat berisi kueri lain (seperti bool), beberapa kueri dapat berisi filter (seperti constant_score), dan yang lainnya dapat berisi kueri maupun filter (seperti filtered). Anda dapat menggabungkan ekspresi kueri dan filter apa pun yang didukung oleh Elasticsearch untuk membangun kueri kompleks. Namun, penulisan pernyataan DSL rentan terhadap kesalahan dan memerlukan pengetahuan khusus. BSearch-QueryBuilder membantu pengguna yang tidak terbiasa dengan DSL Elasticsearch untuk menghasilkan pernyataan DSL dengan cepat.
Plugin BSearch-QueryBuilder memiliki fitur-fitur berikut:
Mudah digunakan: Plugin BSearch-QueryBuilder menyediakan antarmuka visual berbasis klik untuk menyusun permintaan kueri DSL Elasticsearch. Anda dapat melakukan kueri data kustom tanpa coding, sehingga mengurangi kurva pembelajaran untuk DSL kompleks. Plugin ini juga dapat membantu developer menulis atau memvalidasi pernyataan DSL.
Praktis dan cepat: Anda dapat menyimpan kondisi kueri kompleks di Kibana agar tidak perlu membuatnya ulang.
Ringan: Plugin ini menempati ruang disk sekitar 14 MB dan tidak berjalan terus-menerus di memori. Plugin ini tidak memengaruhi operasi normal Kibana dan Elasticsearch.
Aman dan andal: Plugin BSearch-QueryBuilder tidak memodifikasi, menyimpan, atau meneruskan data Anda. Kode sumbernya telah lolos audit keamanan Alibaba Cloud.
Plugin BSearch-QueryBuilder hanya didukung pada kluster Alibaba Cloud Elasticsearch yang menjalankan versi 6.3 atau 6.7.
Prosedur
Masuk ke konsol Kibana kluster Alibaba Cloud Elasticsearch Anda.
Untuk informasi selengkapnya, lihat Masuk ke konsol Kibana.
Opsi: Di panel navigasi sebelah kiri, klik Management dan buat pola indeks.
PentingJika Anda sudah membuat pola indeks, lewati langkah ini.
Pada halaman Management, klik Index Patterns di bagian Kibana.
Pada halaman Create index pattern, masukkan nama pola indeks. Nama tersebut harus sesuai dengan indeks yang ingin Anda kueri.
Klik Next step.
Pada halaman Create index pattern, masukkan
product_infodi bidang Index pattern. Muncul pesan bahwa satu indeks cocok.Klik Create index pattern.
Di panel navigasi sebelah kiri, klik Discover.
Pada halaman Discover, di pojok kanan atas, klik Query.
Tambahkan kondisi kueri dan filter, lalu klik Submit.
Klik ikon
untuk menambahkan kondisi kueri.Klik ikon
untuk menambahkan kondisi sub-filter ke dalam kueri.Klik ikon
untuk menghapus kondisi kueri atau filter.
BSearch-QueryBuilder mendukung berbagai jenis kueri, seperti kueri wildcard, kueri multi-kondisi, dan kueri dengan rentang waktu kustom. Contoh berikut menunjukkan cara melakukan kueri tersebut:
Kueri wildcard
Contoh berikut menunjukkan pencarian fuzzy pada bidang Email. Bidang Email harus melakukan pencocokan kabur terhadap iga. Pada kondisi filter, atur bidang menjadi email, pilih Wildcard sebagai tipe pencocokan, masukkan
*iga*sebagai nilai pencocokan, lalu klik Submit untuk menjalankan kueri.Kueri ini mengembalikan semua catatan di mana email berisi
iga, sepertiabigail@salazar-family.zzzdanabigail@banks-family.zzz. Hasilnya juga menampilkan bidang seperti customer_first_name, customer_gender, dan taxful_total_price.Kueri multi-kondisi
Kondisi kueri pada contoh berikut menetapkan bahwa index harus berupa tryme_book, dan filter harus diterapkan pada bidang Type. Type harus berupa University Teaching Aids, Math , Teaching Chinese to Speakers of Other Languages, atau University Textbooks. Di Query Builder, pilih indeks
tryme_book, dan pilih Match sebagai tipe pencocokan. Tambahkan grup logika OR yang berisi empat kondisi pencocokan untuk bidang type dengan nilaiUniversity Teaching Aids,Mathematics,Teaching Chinese to Speakers of Other Languages, danUniversity Textbooks. Klik submit untuk mengirimkan kueri.Kueri ini mengembalikan beberapa dokumen buku yang cocok. Setiap catatan menampilkan bidang seperti
author,price,publish,name, daninfodalam format JSON.Kueri dengan rentang waktu kustom
Anda dapat melakukan filter berdasarkan bidang waktu. Contoh ini menunjukkan cara memfilter bidang utc_time untuk mengkueri data dalam rentang
[now-240d, now]. Atur bidang filter menjadi utc_time, pilih In the last sebagai tipe kondisi, masukkan nilai240hari, lalu klik Submit.Kueri ini mengembalikan semua catatan data yang sesuai dengan rentang waktu yang ditentukan (240 hari terakhir).
Beri label data menggunakan bsearch_label
bsearch_label adalah plugin pelabelan data front-end saja yang memungkinkan Anda memberi label data secara visual tanpa menulis pernyataan DSL. Dengan memberi label data, Anda dapat menetapkan nilai khusus ke suatu bidang atau menambahkan bidang baru dengan nilai tertentu. Label tersebut kemudian dapat digunakan untuk agregasi, klasifikasi, analisis statistik, atau pemfilteran cepat.
Prosedur
Masuk ke konsol Kibana kluster Alibaba Cloud Elasticsearch target Anda. Untuk informasi selengkapnya, lihat Terhubung ke kluster menggunakan Kibana.
Opsi: Di panel navigasi sebelah kiri, klik Management dan buat pola indeks. Jika Anda sudah membuat pola indeks, lewati langkah ini.
Pada halaman Management, klik Index Patterns di bagian Kibana.
Pada halaman Create index pattern, masukkan nama pola indeks. Nama tersebut harus sesuai dengan indeks yang ingin Anda kueri.
Klik Next step.
Klik Create index pattern.
Di panel navigasi sebelah kiri, klik Discover.
Pada halaman Discover, di pojok kanan atas, klik Label.
Tombol Label hanya muncul setelah Anda menginstal plugin bsearch_label.
Beri label data Anda menggunakan salah satu metode berikut.
Beri label bidang yang sudah ada
Sebagai contoh, cari catatan di mana nama adalah John Doe.
Pilih bidang
agedan atur nilainya menjadi18.Klik Confirm Labeling.
Aktifkan sakelar Labeling History untuk melihat riwayat pelabelan.
Beri label bidang baru
Sebagai contoh, cari catatan di mana nama adalah John Doe.
Pilih kotak centang Custom Labeling Field.
Tambahkan bidang baru bernama
tagdan atur nilainya menjaditeenager.Klik Confirm Labeling untuk melihat hasilnya.
Hapus plugin
Pada bagian Plug-in Configuration, temukan plugin yang ingin Anda hapus, klik Remove di kolom Actions, lalu ikuti petunjuk di layar.
Menghapus plugin juga memerlukan restart node Kibana. Selama proses restart, layanan Kibana tidak tersedia. Disarankan untuk melakukan operasi ini pada jam sepi.