Administrateur

Lorsque vous provisionnez un déploiement Databases for Elasticsearch, un utilisateur 'admin est automatiquement créé.

Définissez le mot de passe administrateur avant de l'utiliser pour vous connecter.

Avant de commencer

• Installez Docker afin de pouvoir récupérer l'image du conteneur Kibana pour vous connecter à Databases for Elasticsearch.
• Si vous préférez éviter d'exécuter Kibana localement et d'installer Docker, vous pouvez également déployer Kibana à l'aide de IBM Cloud® Code Engine. Pour plus d'informations, voir Déploiement de Kibana à l'aide de Code Engine et connexion à votre instance Databases for Elasticsearch.

Pour se connecter, Kibana a besoin du nom d'utilisateur, du mot de passe, de l' URL et du port de votre déploiement Elasticsearch. Il a également besoin du certificat Elasticsearch TLS pour accéder à la base de données. Pour ce faire, copiez les informations relatives au certificat dans la section Endpoints de la page Overview de l'instance Elasticsearch que vous avez créée. Ensuite, téléchargez le certificat dans un dossier local. Vous pouvez utiliser le nom indiqué dans le fichier téléchargé ou choisir votre propre nom de fichier.

Mémorisez l'endroit où vous sauvegardez le certificat sur votre système de fichiers. Si vous exécutez Kibana en local, et non sur Docker, le certificat doit alors être placé dans $KIBANA_HOME/config/<filename>.

Configuration de Kibana

Avant d'exécuter le conteneur Docker qui inclut Kibana, créez un fichier de configuration dans le même dossier avec le certificat Elasticsearch téléchargé à l'étape 1. Le fichier de configuration contient des paramètres Kibana de base comme suit.

Créez un fichier YAML nommé kibana.yml. Ce fichier doit contenir les paramètres de configuration suivants pour Kibana :

elasticsearch.ssl.certificateAuthorities: "/usr/share/kibana/config/cacert"
elasticsearch.username: "admin"
elasticsearch.password: "<password>"
elasticsearch.hosts: ["https://<hostname:port>"]
server.name: "kibana"
server.host: "0.0.0.0"

Le premier paramètre, elasticsearch.ssl.certificateAuthorities, est l'emplacement où Docker stockera le certificat Elasticsearch. Le certificat du déploiement est placé là lorsque vous exécutez Docker pour la première fois. Vous pouvez le remplacer par l'emplacement de votre choix, mais le chemin indiqué dans l'exemple correspond au répertoire de configuration de Kibana. Vérifiez que le nom de certificat (dans notre exemple "cert") dans le fichier kibana.yml et le fichier de nom de certificat stocké à l'étape 1 portent le même nom.

Viennent ensuite les paramètres elasticsearch.username et elasticsearch.password. Utilisez le nom d'utilisateur et le mot de passe d'administrateur du déploiement. Prenez soin de définir le mot de passe d'administrateur avant de tenter de vous connecter. Pour « elasticsearch.hosts », saisissez le nom d'hôte et le port du déploiement, séparés par un « : ».

Enfin, « server.name » est le nom lisible par machine de l'instance Kibana, et « server.hosts » correspond à l'adresse du serveur backend auquel vous pouvez vous connecter via votre navigateur web pour accéder à Kibana.

Ces paramètres ne constituent qu'un exemple simplifié destiné à vous aider à démarrer. Pour plus d'informations, voir Configurer Kibana.

Si vous exécutez Kibana en local, et non sur Docker, le fichier YAML doit alors être placé dans $KIBANA_HOME/config/kibana.yml, d'où Kibana lit sa configuration.

Exécution du conteneur Kibana

Maintenant que le fichier « kibana.yml » est configuré, utilisez la commande « Docker » pour associer le fichier YAML et votre fichier de certificat au conteneur « Docker », tout en récupérant l'image « <kibana_version> » depuis le référentiel d'images « Docker ».

Utilisez une image contenant une version de Kibana compatible avec la version d' Elasticsearch sur laquelle votre déploiement est exécuté. Récupérez la version Elasticsearch à partir du point de terminaison de l'API https_endpoint en utilisant votre client http préféré. Pour plus d'informations, voir la matrice de compatibilité Elasticsearch.

Voici un exemple avec curl. Si le certificat n'est pas installé, utilisez l'indicateur --insecure pour désactiver la vérification homologue. Le <http_endpoint> se trouve dans l'interface utilisateur Endpoints de votre instance:

curl --cacert <path-to-cert> <https_endpoint>

Ensuite, exécutez la commande « Docker » dans votre terminal pour démarrer le conteneur Kibana.

docker container run -it --name kibana \
-v <path_to_config_folder_created_in_step_1>:/usr/share/kibana/config \
-p 5601:5601 docker.elastic.co/kibana/kibana:<kibana_version>

La commande Docker possède un volume connecté avec l'indicateur -v. Ils sont installés dans le conteneur Kibana à l'emplacement /usr/share/kibana/config/, qui est un répertoire de configuration dans lequel Kibana recherche les fichiers de configuration.

• Le paramètre « -p » permet de définir le port exposé depuis le conteneur, ainsi que le port que vous utilisez pour accéder à Kibana.
• La version de Kibana doit correspondre à la version d'Elasticsearch que vous utilisez.

Lorsque vous exécutez la commande à partir de votre terminal, elle télécharge l'image Kibana Docker et exécute Kibana. Une fois que Kibana est connecté à votre déploiement Databases for Elasticsearch et s'exécute correctement, la sortie apparaît dans votre terminal.

log   [01:19:31.839] [info][status][plugin:<kibana_version>] Status changed from uninitialized to green - Ready
log   [01:19:31.925] [info][status][plugin:elasticsearch@<kibana_version>] Status changed from uninitialized to yellow - Waiting for Elasticsearch
log   [01:19:32.120] [info][status][plugin:timelion@<kibana_version>] Status changed from uninitialized to green - Ready
log   [01:19:32.134] [info][status][plugin:console@<kibana_version>] Status changed from uninitialized to green - Ready
log   [01:19:32.147] [info][status][plugin:metrics@<kibana_version>] Status changed from uninitialized to green - Ready
log   [01:19:33.132] [info][status][plugin:elasticsearch@<kibana_version>] Status changed from yellow to green - Ready
log   [01:19:33.378] [info][listening] Server running at http://0.0.0.0:5601

Si vous ne souhaitez pas que la sortie de Kibana s'affiche sur votre terminal, utilisez l'indicateur -d pour détacher le conteneur.

Visitez http://0.0.0.0:5601 dans votre navigateur pour voir Kibana. 0.0.0.0 correspond à server.host dans kibana.yml et 5601 au port qui est exposé à partir du conteneur. Une fois que vous avez accédé à l'URL, une fenêtre en incrustation vous invite à entrer votre nom d'utilisateur et votre mot de passe. Utilisez les données d'identification d'administrateur ou toute autre donnée d'identification que vous avez effectuée pour accéder à votre déploiement. Les identifiants utilisés ne doivent pas nécessairement correspondre au nom d'utilisateur et au mot de passe que vous avez indiqués dans le fichier « kibana.yml ».