Kibanaのローカルインスタンスを設定する方法

今日は、リモートElasticsearchクラスターに接続するためのKibanaのローカルインスタンスのセットアップについて説明します。 ObjectRocket for Elasticsearchインスタンスには、無料のホストされたKibanaインストールが含まれていますが、ローカルマシンでKibanaを実行すると、柔軟性が向上する場合があります。また、ホストされたKibanaを提供しない環境またはサービスで実行している場合、このウォークスルーは、マシンに対してローカルでKibanaを簡単に実行するのに役立ちます。

Kibanaのローカルインスタンスを実行する理由

他のKibanaユーザーと共有されない視覚化のカスタムセットを作成したいと思ったことはありませんか？または、Kibanaの共有インスタンスにインストールせずに新しいKibanaプラグインを試してみませんか？ Kibanaをローカルで実行すると、これらすべてのことやそれ以上のことができます。

Kibanaはローカルに何も保存せず、デフォルトでは、同じインデックスを使用してその構成をElasticsearchクラスターに保存します。つまり、Kibanaのインスタンスを必要な数だけ実行することも、Kibanaを使用しているときにのみ実行することもできます。共有状態/構成により、1つのインスタンスでビジュアライゼーションを作成および変更でき、クラスターに接続しているすべてのKibanaインスタンスで新しいコンテンツが表示されます。これには、優れたコラボレーションを可能にするという利点がありますが、1人のユーザーによるミスによって、すべてのユーザーの視覚化が削除または変更される可能性があるという欠点もあります。

Kibanaインスタンスを使用しているユーザーが多数いる場合は、別のインデックスを使用して独自のインスタンスを実行することをお勧めします。これにより、別のユーザーが踏みにじるリスクなしに、カスタムの視覚化を行うことができます。または、準備が整うまで他のすべてのユーザーにアクセスを提供せずに、独自のKibanaインストールで視覚化またはプラグインを試してみることもできます。

柔軟性が役立つので、セットアップにジャンプしましょう。

Kibanaのセットアップ

Kibanaは他のElasticsearchクライアントと同じようにElasticsearchに接続するだけなので、ローカルシステムをElasticsearchに接続できれば、Kibanaをローカルで実行できます。ローカルにインストールするコンポーネントの数を最小限に抑え、物事を適切に封じ込めるために、Docker化バージョンのKibanaをお勧めします。そのため、少なくともローカルシステムにDockerとDockerComposeをインストールする必要があります。

Dockerをセットアップしたら、local-kibanaGitHubリポジトリをシステム上のディレクトリに複製します。

次に、含まれているkibana.ymlファイルを必要に応じて構成します。以下は、リポジトリに含まれているバージョンのコピーです：

---
## Default Kibana configuration from kibana-docker.
## from https://github.com/elastic/kibana-docker/blob/master/build/kibana/config/kibana.yml
#
# Kibana server name and host. You shouldn't need to change these
server.name: kibana
server.host: "0"

# These are the settings you must set to your target Elasticsearch cluster and user.
elasticsearch.url: "https://your-host.es.objectrocket.com:yourport"
elasticsearch.username: "youruser"
elasticsearch.password: "yourpassword"

# The index Kibana should use. By default, Kibana will use an index named ".kibana".
# If you want to isolate your visualizations/dashboards/index patterns from others, change This
#kibana.index: ".kibana"

構成ファイルには、elasticsearch。*設定とkibana.index設定の2つのセクションに焦点を当てる必要があります。

Elasticsearch。*設定は、接続するターゲットElasticsearchクラスターを決定します。 ObjectRocketサービスを使用している場合は、UIの[接続]セクションで、これを入力するために必要なすべてのものを見つけることができます。それ以外の場合は、これらをElasticsearchホストと、Elasticsearchへの接続に使用するユーザー名とパスワードに設定します。 Kibanaは複数のElasticsearchホスト名を受け入れないため、複数のホストがある場合は、このKibanaインスタンスが接続するホストを1つだけ選択する必要があることに注意してください。

焦点を当てる2番目のセクションはkibana.index設定です。他の人と同じ視覚化とダッシュボードで作業したい場合は、これをそのままにしておきます。独自のカスタム設定で作業する場合は、コメントを外して別の設定に変更し、自分や他の人がそれをKibana設定として識別できるようにします。

実行中のKibana

これで、Kibanaを起動する準備が整いました。ネットワークセキュリティ/ACLを使用するサービスを利用している場合は、最初にローカルマシンからElasticsearchに接続できることを確認してください。

local-kibanaディレクトリから次のコマンドを実行します：

$ docker-compose build --no-cache
$ docker-compose up

Kibanaの起動と構成には数分かかりますが、最終的には、ターミナルでKibanaの状態が「緑」に更新されるはずです。これで、接続する準備が整いました。

接続

Kibanaコンテナーが稼働しているので、ブラウザーでlocalhost：5601に移動できます。 Kibanaはユーザー名とパスワード（これは上記の構成ファイルに入力したものと同じユーザー/パスワード）をもう一度要求し、その後すべてが読み込まれます。 Kibanaインデックスをデフォルトから変更した場合は、最初のログイン時にインデックスパターンとデフォルトのインデックスパターンも設定する必要があります。

まとめ

ローカルのKibanaインスタンスをすばやく簡単に起動するために必要なのはこれだけです。詳細な手順については、ドキュメントをご覧ください。