
======
Kibana
======

Kibana is an open source (Apache Licensed), browser based analytics and search interface to Logstash and other timestamped data sets stored in ElasticSearch. With those in place Kibana is a snap to setup and start using (seriously). Kibana strives to be easy to get started with, while also being flexible and powerful

Sample pillar
=============

.. code-block:: yaml

    kibana:
      server:
        addrepo: true
        enabled: true
        bind:
          address: 0.0.0.0
          port: 5601
        database:
          engine: elasticsearch
          host: localhost
          port: 9200

Or without adding elasticsearch kibana repository, but with modified path to config file

.. code-block:: yaml

    kibana:
      server:
        configpath: /usr/share/kibana/config/kibana.yml
        enabled: true
        bind:
          address: 0.0.0.0
          port: 5601
        database:
          engine: elasticsearch
          host: localhost
          port: 9200


Client setup
------------

Client with host and port (Kibana use Elasticsearch to store its data):

.. code-block:: yaml

    kibana:
      client:
        enabled: true
        server:
          host: elasticsearch.host
          port: 9200

Client where you download a Kibana object that is stored in the directory
*files/*:

.. code-block:: yaml

    kibana:
      client:
        enabled: true
        server:
          host: elasticsearch.host
          port: 9200
        object:
          logs:
            enabled: true
            name: Logs
            template: kibana/files/objects/dashboard_logs.json
            type: 'dashboard'

Client directly use a Kibana object that is stored in model:

 .. code-block:: yaml

     kibana:
       client:
         enabled: true
         server:
           host: elasticsearch.host
           port: 9200
         object:
           logs:
             enabled: true
             name: Logs
             type: 'dashboard'
             content:
               title: "Logs"
               hits: 0
               description: ""
               ...

Read more
=========

* https://github.com/elasticsearch/kibana/blob/master/src/config.js

Documentation and Bugs
======================

To learn how to install and update salt-formulas, consult the documentation
available online at:

    http://salt-formulas.readthedocs.io/

In the unfortunate event that bugs are discovered, they should be reported to
the appropriate issue tracker. Use Github issue tracker for specific salt
formula:

    https://github.com/salt-formulas/salt-formula-kibana/issues

For feature requests, bug reports or blueprints affecting entire ecosystem,
use Launchpad salt-formulas project:

    https://launchpad.net/salt-formulas

You can also join salt-formulas-users team and subscribe to mailing list:

    https://launchpad.net/~salt-formulas-users

Developers wishing to work on the salt-formulas projects should always base
their work on master branch and submit pull request against specific formula.

    https://github.com/salt-formulas/salt-formula-kibana

Any questions or feedback is always welcome so feel free to join our IRC
channel:

    #salt-formulas @ irc.freenode.net