Installation Elasticsearch & Kibana

Installation Elasticsearch


Se reporter à la documentation officielle pour des environnements de production.

Cette partie décrit comment installer Elasticsearch afin de l’utiliser comme backend Flower.


Afin d’installer Elasticsearch, il est nécessaire de :

  • Télécharger Elasticsearch à partir du site officiel

  • Extraire l’archive elasticsearch-5.2.1.zip dans un répertoire ${ES_HOME}


Ensuite, pour configurer Elasticsearch, éditer le fichier ${ES_HOME}/config/elasticsearch.yml tel que :

  • Pour définir le nom du cluster Elasticsearch, dé-commenter la propriété cluster.name et modifier sa valeur par flower-es-dev
  • Dans le cas d’un cluster Elasticsearch, dé-commenter la propriété node.name et modifier sa valeur par celle de votre choix (ex: node-1)
  • Si plusieurs noeud Elasticsearch sont déployés sur la même machine, il est nécessaire de modifier la valeur de la propriété http.port
  • Ajouter la propriété action.auto_create_index: false
  • Pour accéder à Elasticsearch depuis un serveur distant, il est nécessaire de décommenter la propriété network.host et de définir une des valeurs suivantes :
    • 0.0.0.0
    • nom DNS
    • adresse IP


Pour terminer, démarrer Elasticsearch en allant dans le dossier ${ES_HOME}/bin puis en exécutant le script elasticsearch ou elasticsearch.bat (selon le système d’exploitation)



Pour vérifier son bon fonctionnement, aller sur la page http://localhost:9200/

Installation Kibana


Se reporter à la documentation officielle pour des environnements de production.

Cette partie décrit comment installer Kibana afin de faire du reporting dans Flower.


Afin d’installer Kibana, il est nécessaire de :

  • Télécharger Kibana à partir du site officiel

  • Extraire l’archive dans un répertoire ${KIBANA_HOME}


Ensuite, pour configurer Kibana, éditer le fichier ${KIBANA_HOME}/config/kibana.yml tel que :

  • Dans le cas d’un Kibana sur un serveur différent d’Elasticsearch, dé-commenter la propriété elasticsearch.url et renseigner pour valeur l’url d’accès à Elasticsearch (par défaut http://localhost:9200)
  • Dé-commenter la propriété server.basePath et modifier sa valeur par /flower-docs-gui/plugins/reporting.


Pour terminer, démarrer Kibana en allant dans le dossier ${KIBANA_HOME}/bin puis en exécutant le script kibana ou kibana.bat (selon le système d’exploitation)



Pour vérifier son bon fonctionnement, aller sur la page http://localhost:5601/

Configuration

Afin de configurer l’accès de Flower à Elasticsearch et Kibana, modifier le fichier flowerdocs.properties en fonction des paramètres renseignés lors de l’installation :

Propriété Valeur par défaut Description
es.nodes localhost:9300 Adresses des différents noeuds Elasticsearch séparées par une ,
es.cluster flower-es-dev Le nom du cluster Elasticsearch
es.username Le nom de l’utilisateur (optionnel)
es.password Le mot de passe de l’utilisateur (optionnel)
es.conflict.version true Utilise la notion de version pour gérer les modifications concurrentes
es.aggregation.max.size 100 Nombre de buckets maximum remontées par aggrégation
kibana.url http://localhost:5601 URL d’accès à Kibana à partir du Core