Skip to content

Latest commit

 

History

History
96 lines (66 loc) · 4.67 KB

2016-02-29-using-kibana-with-laas.md

File metadata and controls

96 lines (66 loc) · 4.67 KB
layout title categories author lang
post
Using Kibana with PaaS Logs
Logs
Babacar Diassé
en

You want to unleash the full power of Kibana and be able to craft some beautiful Dashboards from your logs. Rest assured, you have come to the right place. Kibana is a powerful weapon, the knowledge you are about to read needs you to have reached a certain level (but way below 9000) in the understanding of PaaS Logs. This is what you need to know to get you started :

After some training you will be able to do this kind of Dashboard : Kibana Dashboard

#1 Setup your Kibana index Kibana requires an index where to store your dashboards and other settings. To create it in our Elasticsearch cluster:

  1. Sign in on https://www.runabove.com
  2. On PaaS Logs lab section, click on link Enable Kibana indice

Enable indice

That was easy right ? If you are not too tired, proceed with the next section.

#2 Select your Stream Alias

To access your logs from Kibana, you will need to setup an Elasticsearch Alias and link them to your Graylog streams, so here we go again :

  1. Sign in on https://www.runabove.com, PaaS Logs lab section (skip this step if you are already in ;-)
  2. On alias zone, click on blue + button
  3. Choose a name, define a description
  4. Save the entry
  5. Once status marked as OK (refresh page if necessary) click on Associate link
  6. Define there the graylog streams you want to associate to your alias
  7. That's it.

Alias creation

So here you have, now PaaS Logs knows what is the streams you wnat to browse. Now let's configure Kibana and see if it works !

#3 Setup your own kibana Get last Kibana 4.1.X for Elasticsearch 1.x here (do NOT try to use 4.2 and 4.3 since they are made for incompatible version of Elasticsearch) https://www.elastic.co/downloads/kibana (4.1.6 at the time of writing). Here are some direct links for your convenience.

Unzip the archive anywhere on your machine. To configure the Kibana, edit config/kibana.yml and set the following properties:

port: 5601
# The host to bind the server to.
host: "0.0.0.0"

 
# The Elasticsearch instance to use for all your queries.
elasticsearch_url: https://laas.runabove.com:9200
 
# preserve_elasticsearch_host true will send the hostname specified in `elasticsearch`. If you set it to false,
# then the host you use to connect to *this* Kibana instance will be sent.
elasticsearch_preserve_host: true
 
# 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_index: kibana-ra-logs-XXXXX
 
# If your Elasticsearch is protected with basic auth, this is the user credentials
# used by the Kibana server to perform maintenance on the kibana_index at startup. Your Kibana
# users will still need to authenticate with Elasticsearch (which is proxyfied through
# the Kibana server)
kibana_elasticsearch_username: ra-logs-XXXXX
kibana_elasticsearch_password: YOUR_PAAS_LOGS_PASSWORD

#4 Launch it !

If everything is setup properly, you should be able to start it by calling bin/kibana. Launch your favorite browser, and point it to http://localhost:5601 On first page, for Index name or pattern give the name of your alias. Choose timestamp for Time-field name then click on Discover tab to read your log entries.

If you want to know what you can do with Kibana, you can fly to the very good Elastic documentation

#Getting Help