KIBANA

İmajını yaptığım Kibana nedir ve neler yapar kısaca bundan bahsedicem.

Kibana veriyi birden fazla boyutta gösterim sağlayan ve bu bağlamda veriyle etkileşime geçip kullanıcıya güçlü ve çarpıcı dashboardlar sunan açık kaynak kodlu veri görüntüleme platformudur. 

Bu kibana imajı ile neler yapabiliriz?

Bunu da kibana imajını çalıştırırken eğer istersek verebildiğimiz çevresel değişkenlerle anlatmak istiyorum.  

Aslında kibananın official imajı var ama imajı çalıştırırken bize sadece url ayarı yapabilme imkanı veriyor. Benim imajımda da bütün config dosyasındaki ayarları çevresel değişkenlerle ayarlayabiliyoruz.

Bu çevresel değişkenler nelerdir?

SERVER_BASEPATH

Bu değişkeni eğer proxy arkasında çalıştırmak ve bunun yolunu belirtmek istiyorsanız kullanırsınız. eğik çizgi ile bitirmeyin.

SERVER_MAX_PAYLOAD_BYTES

Eğer gelen sunucu isteklerinin maksimum yük boyutunu ayarlamak istiyorsanız kullanılır.

http://ELASTICSEARCH_HOST:ELASTICSEARCH_PORT

ELASTICSEARCH_HOST: hostunuzu bu değişkenle

ELASTICSEARCH_PORT: portunuzu da bu değişkenle belirtebilirsiniz.

KIBANA_INDEX

Kibana kayıtlı aramaları ve görsellikleri saklamak için Elasticsearch indeksini kullanır. Eğer bu indeks yoksa yeni bir indeks yaratır.

KIBANA_DEFAULT_APP_ID
Varsayılan uygulamayı yüklemek için.

ELASTICSEARCH_PING_TIMEOUT
Elasticsearh un pinglere cevap vermesi için milisaniye cinsinden zaman girilmesi beklenir.

ELASTICSEARCH_REQUEST_TIMEOUT
Elasticsearch ten gelen yanıtları beklemek geriye cevap verilmesi için de milisaniye cinsinden zaman girilmesi beklenir.

ELASTICSEARCH_STARTUP_TIMEOUT
tekrar deneme öncesinde 

PID_FILE
Yaratılması istenen işlem ıd dosyasının bulunmasını istediğiniz dizin.

LOGGING_DEST 
Log çıktı dosyasının yer almasını istediğiniz hedef dizin bununla  belirtilir.

LOGGING_SILENT

Log çıktılarının oluşmasını durdurmak için kullanılır.

LOGGING_QUIET

Hata mesajları dışındaki tüm log çıktılarının oluşmasını durdurmak için kullanılır.

LOGGING_VERBOSE

Tüm sistem kullanım bilgileri talepler ve etkinliklerin loglanması için kullanılır.

İmajı Çalıştırma

İmajı çalıştırmak için en temel komut :

docker run -d -p 5601:5601 -e
ELASTICSEARCH_HOST=your_elasticsearch_host burcina/kibana

Eğer çevresel değişkenler eklemek istiyorsanız -e parametresini kullanmanız gerekir.

Eğer kullanıcı değişkenini kullanmak istiyorsanız parola değişkenini de kesinlikle kullanmanız gerekir, aynı işlem tam tersi içinde geçerlidir. Bu girilen kimlik doğrulaması elasticsearch e ait olan kimlik doğrulamasıdır.
docker run -d -p 5601:5601 -e ELASTICSEARCH_HOST=your_elasticsearch_host -e ELASTICSEARCH_USER=your_user -e ELASTICSEARCH_PASS=your_password burcina/kibana

Gelen istekler için kendi ssl inizi kullanmak istiyorsanız volume kullanmanız gerekir. Bunu da -v parametresiyle belirtmeniz gerekir:

docker run -d -p 5601:5601 -e ELASTICSEARCH_HOST=your_elasticsearch_host -e SERVER_SSL_CERT=/path/to/your/container/server.crt 

-e SERVER_SSL_KEY=/path/to/your/container/server.key 

-v /path/to/your/host/cert/:/path/to/container/cert/ -v /path/to/your/host/key/:/path/to/your/container/key/ kibana

Aslında -v ile belirtilen sizin kendi bilgisayarınızda bulunan bir dosya yoludur. Böylece kendi bilgisayarınızda bulunan bir dosyayı imajı çalıştırırken kullanabilirsiniz.

Burada SERVER_SSL_CERT değişkeninde belirtmiş olduğunuz yol(path/to/your/container/) ile -v ile belirtmiş olduğumuz yerelimizde bulunan imajda kullanacağımız dosya yolu ile aynı olmalıdır. Aynı işlem SERVER_SSL_KEY içinde geçerlidir.

yani

/path/to/your/host/cert/:/path/to/container/cert/
Burda : önceki yol yerelimizde bulunan dosyanın yolu, : den sonraki yolda bu dosyanın kopyalanması gereken yeri temsil ediyor. Burda da

SERVER_SSL_CERT=/path/to/your/container/server.crt  konteynera kopyaladığımız yerden kullanmamızı sağlayan değişken.

Not: Bu kibana imajının sürümü 4.5.4
İmaj için ayrıntılar:
Github
Dockerhub

KIBANA

What is Kibana?

Kibana is an open source data visualization platform that allows you to interact with your data through stunning, powerful graphics that can be combined into custom dashboards that help you share insights from your data far and wide.

What can we do with this Kibana image?

Actually there is an official Kibana image you can only set the host environment. But you can set all environments with this Kibana image I coded. 

What are these environment variables that we give?

SERVER_BASEPATH
If you are running kibana behind a proxy and want to mount it at a path, specify that path here. The basePath can't end in a slash.

SERVER_MAX_PAYLOAD_BYTES

The maximum payload size in bytes on incoming server requests.

ELASTICSEARCH_PRESERVE_HOST

Preserve_elasticsearch_host true will send the hostname specified in `elasticsearch`.

KIBANA_INDEX

Kibana uses an index in Elasticsearch to store saved searches, visualizations and dashboards. It will create a new index if it doesn't already exist.

KIBANA_DEFAULT_APP_ID

The default application to load.

ELASTICSEARCH_PING_TIMEOUT

Time in milliseconds to wait for elasticsearch to respond to pings, defaults to request_timeout setting

ELASTICSEARCH_REQUEST_TIMEOUT

Time in milliseconds to wait for responses from the back end or elasticsearch.

ELASTICSEARCH_SHARD_TIMEOUT

Time in milliseconds for Elasticsearch to wait for responses from shards.

ELASTICSEARCH_STARTUP_TIMEOUT

Time in milliseconds to wait for Elasticsearch at Kibana startup before retrying

PID_FILE

Set the path to where you would like the process id file to be created.

LOGGING_DEST

If you would like to send the log output to a file you can set the path below.

LOGGING_SILENT

Set this to true to suppress all logging output.

LOGGING_QUIET

Set this to true to suppress all logging output except for error messages.

LOGGING_VERBOSE

Set this to true to log all events, including system usage information and all requests.

Usage

The basic commands that can be executed:

docker run -d -p 5601:5601 -e ELASTICSEARCH_HOST=your_elasticsearch_host burcina/kibana

If you enter user environment variable, you must enter password environment. 

If you enter password environment variable, you must enter user environment.

docker run -d -p 5601:5601 -e ELASTICSEARCH_HOST=your_elasticsearch_host -e ELASTICSEARCH_USER=your_user -e ELASTICSEARCH_PASS=your_password burcina/kibana

docker run -d -p 5601:5601 -e ELASTICSEARCH_HOST=your_elasticsearch_host -e SERVER_SSL_CERT=/path/to/your/container/server.crt -e SERVER_SSL_KEY=/path/to/your/container/server.key -v /path/to/your/host/cert/:/path/to/container/cert/ -v /path/to/your/host/key/:/path/to/your/container/key/ kibana

The local file path that use in the image (-v) and path(path/to/your/container/) which we define with SERVER_SSL_CERT must be same. The same process is approved also for SERVER_SSL_KEY. 

/path/to/your/host/cert/:/path/to/container/cert/

Before ":" source is the path in our local pc. After ":" is target means that file to be stored.

SERVER_SSL_CERT=/path/to/your/container/server.crt

We can use it as we store in container.

Note: This is Kibana 4.5.4