Alibaba Cloud Kibana は、オープンソースコミュニティのプラグインをベースにした2つの組み込みプラグイン、BSearch-QueryBuilder (高度なクエリ) と bsearch_label (データラベリング) を提供します。本トピックでは、これらの Kibana プラグインのインストールとアンインストール方法について説明します。
プラグインのインストール
注意事項
Kibana プラグインは、Alibaba Cloud Elasticsearch V6.3 および V6.7 のインスタンスでのみサポートされています。
プラグインをインストールする前に、Kibana ノードに少なくとも 2 vCPU と 4 GB のメモリがあることを確認してください。そうでない場合は、Kibana ノードのスペックをアップグレードしてください。詳細については、「クラスター構成のアップグレード」をご参照ください。
カスタム Kibana プラグインはサポートされていません。
操作手順
Alibaba Cloud Elasticsearch コンソールにログインします。
左側のナビゲーションウィンドウで、Elasticsearch クラスター をクリックします。
上部のナビゲーションバーで、リソースグループとリージョンを選択します。
Elasticsearch クラスター ページで、ターゲットインスタンスの ID をクリックします。
左側のナビゲーションウィンドウで、データ可視化 をクリックします。
Kibana セクションで、設定の編集 をクリックします。
プラグインの設定 セクションで、インストールするプラグインを見つけ、アクション 列の インストール をクリックします。
重要プラグインをインストールすると Kibana ノードが再起動し、その間 Kibana は利用できなくなります。この操作はオフピーク時間に実行することを推奨します。
[インストール] 確認ダイアログボックスで、OK をクリックします。
ノードが正常に再起動すると、プラグインがインストールされます。プラグインのステータスは インストール済み に変わります。
BSearch-QueryBuilder を使用したデータのクエリ
BSearch-QueryBuilder は、複雑なドメイン固有言語 (DSL) 文を作成することなく、視覚的に複雑なクエリを作成できるフロントエンドプラグインです。
背景情報
Query DSL は、型安全な SQL ライクなクエリを構築するためのオープンソースの Java フレームワークです。文字列を連結する代わりに、その fluent API を使用してクエリを構築できます。Query DSL は、JPA、JDO、SQL、Java Collections、RDF、Lucene、Hibernate Search などのプラットフォームをサポートしています。
この DSL は、抽象的なクエリ式で構成されています。特定のクエリには、bool クエリなどの他のクエリを含めることができます。一部のクエリには、constant_score クエリなどのフィルターを含めることができ、filtered クエリのようにクエリとフィルターの両方を含めることができるものもあります。これらの式とフィルターを組み合わせて、複雑なクエリを構築できます。しかし、DSL クエリの作成はエラーが発生しやすく、通常は専門知識が必要です。QueryBuilder は、Elasticsearch DSL に不慣れなユーザーや、DSL クエリをより効率的に作成したいユーザーを支援します。
BSearch-QueryBuilder プラグインは、以下の特徴を備えています：
使いやすさ： BSearch-QueryBuilder は、Elasticsearch DSL クエリを構築するための視覚的なポイントアンドクリックのインターフェイスを提供します。コードを一切書かずに、カスタム条件に基づいてデータをクエリできます。これにより、複雑な DSL クエリの学習曲線を短縮します。このプラグインは、開発者が DSL 文を作成または検証するのにも役立ちます。
利便性： Kibana で定義した複雑なクエリ条件を保存して再利用できます。
軽量： このプラグインが占有するディスク領域は約 14 MB のみで、メモリに常駐して実行されることはありません。Kibana や Elasticsearch のパフォーマンスには影響しません。
安全性と信頼性： BSearch-QueryBuilder は、お客様のデータを変更、保存、または転送することはありません。そのソースコードは Alibaba Cloud のセキュリティ監査に合格しています。
BSearch-QueryBuilder は、Alibaba Cloud Elasticsearch V6.3 および V6.7 のインスタンスでのみ動作します。
操作手順
ご利用の Alibaba Cloud Elasticsearch インスタンスの Kibana コンソールにログインします。
詳細については、「Kibana コンソールへのログイン」をご参照ください。
任意： 左側のナビゲーションウィンドウで [管理] をクリックし、次の手順に従ってインデックスパターンを作成します。
重要既存のインデックスパターンがある場合は、このステップをスキップしてください。
[管理] ページで、[Kibana] セクションの [インデックスパターン] をクリックします。
[インデックスパターンの作成] ページで、インデックスパターン名を入力します。名前はクエリしたいインデックスと一致する必要があります。
[次のステップ] をクリックします。
[インデックスパターンの作成] をクリックします。
左側のナビゲーションウィンドウで、[Discover] をクリックします。
[Discover] ページで、右上隅の [クエリ] をクリックします。
クエリ領域で、クエリ条件とフィルター条件を追加し、[送信] をクリックします。
アイコンをクリックして、クエリ条件を追加します。
アイコンをクリックして、クエリにネストされたフィルター条件を追加します。
アイコンをクリックして、クエリまたはフィルター条件を削除します。
BSearch-QueryBuilder は、あいまい検索、複数条件クエリ、カスタム時間範囲クエリなど、複数のクエリメソッドをサポートしています。以下の例では、これらのメソッドを示します。
あいまい検索
次の図は、[email] フィールドでのあいまい検索を示しています。ここで、[email] は [iga] とあいまい一致する必要があります。
次の図は、一致する結果を示しています。
複数条件でのクエリ
次の図のクエリ条件では、[インデックス] を [tryme_book] に指定し、[type] フィールドにフィルターを適用しています。[type] は [大学の補助教材]、[数学]、[外国語としての中国語教育]、または [大学の教科書] のいずれかである必要があります。
次の図は、一致する結果を示しています。
カスタム時間範囲でのクエリ
時間フィールドでデータをフィルタリングするには、時間ベースのフィルタリング機能を使用します。次の例では、[utc_time] フィールドをフィルタリングして、
[now-240d, now]の範囲内のデータをクエリします。
次の図は、一致する結果を示しています。
bsearch_label を使用したデータのラベリング
bsearch_label は、フロントエンドのデータラベリングプラグインです。このプラグインを使用すると、DSL 文を記述することなく、視覚的にデータをラベリングできます。データをラベリングすることにより、特定のタグ値をフィールドまたは新しいフィールドに割り当てることができます。これにより、集計統計を実行したり、ラベルでデータをすばやくフィルタリングしたりできます。
操作手順
ターゲットの Alibaba Cloud Elasticsearch インスタンスの Kibana コンソールにログインします。詳細については、「Kibana コンソールへのログイン」をご参照ください。
任意： 左側のナビゲーションウィンドウで [管理] をクリックし、次の手順に従ってインデックスパターンを作成します。既存のインデックスパターンがある場合は、このステップをスキップできます。
[管理] ページで、[Kibana] セクションの [インデックスパターン] をクリックします。
[インデックスパターンの作成] ページで、インデックスパターン名を入力します。名前はクエリしたいインデックスと一致する必要があります。
[次のステップ] をクリックします。
[インデックスパターンの作成] をクリックします。
左側のナビゲーションウィンドウで、[Discover] をクリックします。
[Discover] ページで、右上隅の [ラベル] をクリックします。
[ラベル] ボタンは、bsearch_label プラグインをインストールした後にのみ使用可能になります。
次のいずれかのメソッドを選択して、データをラベリングします。
既存フィールドのラベリング
ラベリングしたいデータをクエリします。たとえば、名前が田中太郎であるデータをクエリします。
ageフィールドを選択し、18に設定します。[ラベリングの確認] をクリックします。
[ラベリング履歴] スイッチを有効にして、ラベリング履歴を表示します。
新規フィールドのラベリング
ラベリングしたいデータをクエリします。たとえば、名前が田中太郎であるデータをクエリします。
[カスタムラベリングフィールド] チェックボックスを選択します。
tagフィールドを追加し、ティーンエイジャーとしてマークします。[ラベリングの確認] をクリックして、ラベリング結果を表示します。
プラグインのアンインストール
プラグインの設定 セクションで、アンインストールするプラグインを見つけ、アクション 列の アンインストール をクリックし、画面の指示に従います。
プラグインをアンインストールする場合も Kibana ノードが再起動し、その間 Kibana は利用できなくなります。この操作はオフピーク時間に実行することを推奨します。