Computer >> Hướng Dẫn Máy Tính >  >> Lập Trình >> Cơ Sở Dữ Liệu

Getting Started với Kibana 4 trên ObjectRocket Elasticsearch

Nếu muốn transform millions (hoặc billions!) Elasticsearch documents thành eye-catching charts, graphs, tables, Kibana là câu trả lời. As Elastic product, integrates closely với Elasticsearch và provides easy-to-use interface cho making sense của mounds of data.

Hiện tại, all ObjectRocket Elasticsearch instances come pre-loaded với Kibana 3, access tại /_plugin/kibana trên any Elasticsearch HTTP endpoints. Tuy nhiên, Kibana 4 introduces improvements và new features, nên chúng tôi working hard provide it alongside every Elasticsearch instance tạo với ObjectRocket. Meantime, tutorial này walk through connecting to Elasticsearch instance dùng Kibana 4 running in Docker container.

Prerequisites

Nếu đã có Docker installed và Elasticsearch instance với chúng tôi, good to go. Chỉ ensure Docker host's IP address whitelisted trên Elasticsearch instance và take connection information đến section "Running Kibana 4 in Docker" dưới.

Elasticsearch

Để bắt đầu, cần Elasticsearch instance trên ObjectRocket. Nếu chưa có, excellent documentation getting started with Elasticsearch. Chạy Docker locally, so whitelist current IP address (từ icanhazip.com) trong ACLs. Instance up, cần thông tin sau connect từ Kibana 4:

  • HTTPS connection string cho instance, e.g. https://iad1-19999-0.es.objectrocket.com:29999. Cho HA purposes, mỗi instance có 4 client nodes connect được, nhưng chỉ cần one trong case này.
  • Username/password combination cho admin user trên instance.

Docker

Easiest way get started Docker nowadays là Docker Machine. Getting installed và configured out of scope article, nhưng getting started guide good place start.

Running Kibana 4 in Docker

Elasticsearch instance online và Docker installed, time get Kibana 4 up and running!

Nếu dùng Docker Machine, ensure setup environment appropriately:

$ docker-machine ls
NAME ACTIVE DRIVER STATE URL SWARM
dockerbox virtualbox Running tcp://192.168.99.100:2376
$ eval "$(docker-machine env dockerbox)"
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES

Create the environment file

Kibana 4 Docker image (objectrocket/kibana) yêu cầu ELASTICSEARCH_URL environment variable set để biết connect Elasticsearch. Example này connect host iad1-19999-3.es.objectrocket.com port 29999 (HTTPS) với username alice password password.

$ echo 'ELASTICSEARCH_URL=https://alice:password@iad1-19999-3.es.objectrocket.com:29999' > kibana4.env

Note: Could pass env variables với -e flag, nhưng vì contain sensitive credentials, wise place them in env file.

Start the container

Start Kibana 4 container:

# Use `-p $PORT:5601` nếu wish change bind port
$ docker run -d --name kibana4 -p 5601:5601 --env-file kibana4.env objectrocket/kibana:4.1.2
Unable to find image 'objectrocket/kibana:4.1.2' locally
4.1.2: Pulling from objectrocket/kibana
...
Status: Downloaded newer image for objectrocket/kibana:4.1.2
cc341ff14d492a30e106007896201639964bdef6a93d03d497957a2738f5ac24

Update: Nếu chạy Elasticsearch 2.0+, cần dùng objectrocket/kibana:4.2.0 (hoặc higher) image.

Sau container created, visible in docker ps output:

$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
cc341ff14d49 objectrocket/kibana "/opt/kibana/run.sh" About a minute ago Up About a minute 0.0.0.0:5601->5601/tcp kibana4

Nếu issues getting container running, double check ELASTICSEARCH_URL variable và ensure each portion URL correct. Also worth noting passwords với symbols như @ hoặc : can break URL scheme. Có thể run docker logs kibana4 show error messages Kibana sent to stdout/stderr.

Connect to Kibana 4

Nên able connect Kibana 4 on port 5601 (hoặc port chose previous step) on Docker host. Nếu running locally, dùng https://localhost:5601. Nếu Docker Machine, dùng IP address Docker Machine VM từ docker-machine ip, e.g. https://192.168.99.100:5601.

Sau successfully connected, config Kibana dùng indices từ Elasticsearch instance. Xem Connect Kibana with Elasticsearch documentation từ Elastic. Cũng want read Getting Started with Kibana guide để learn more key features Kibana 4.

Wrapping Up

Khi done crafting visualizations in Kibana, stop Docker container:

$ docker stop kibana4
kibana4

Next time wish connect again, just run docker start kibana4 và ready to go.

Như mentioned earlier, hosted Kibana 4 already in works cho Elasticsearch product offering, nhưng chạy Kibana locally allow quickly get started meantime. Vì Kibana store all config trong Elasticsearch indices, won't lose precious dashboards hoặc visualizations khi switch!