Benutzer mit Administratorberechtigung

Bei der Bereitstellung eines Databases for Elasticsearch wird automatisch ein ' admin-Benutzer erstellt.

Legen Sie das Admin-Passwort fest, bevor Sie die Verbindung herstellen.

Vorbereitende Schritte

• Installieren Docker, damit Sie das Kibana-Container-Image herunterladen können, um eine Verbindung zu Databases for Elasticsearch herzustellen.
• Wenn Sie die lokale Ausführung von Kibana vermeiden und Dockerinstallieren möchten, können Sie Kibana auch mithilfe von IBM Cloud® Code Enginebereitstellen. Weitere Informationen finden Sie unter Deploy Kibana using Code Engine and connect to your Databases for Elasticsearch instance.

Um eine Verbindung herzustellen, benötigt Kibana den Benutzernamen, das Passwort, die URL und den Port für Ihren Elasticsearch. Außerdem benötigt es das Zertifikat „ Elasticsearch “ ( TLS ), um auf die Datenbank zugreifen zu können. Kopieren Sie dazu die Zertifikatsinformationen aus dem Abschnitt " Endpunkte" auf der Seite "Übersicht" der von Ihnen erstellten Instanz Elasticsearch. Laden Sie dann das Zertifikat in einen lokalen Ordner herunter. Sie können den im Download angegebenen Namen oder einen eigenen Dateinamen verwenden.

Merken Sie sich, wo Sie das Zertifikat im Dateisystem speichern. Wenn Sie Kibana lokal ausführen und nicht unter Docker, dann muss das Zertifikat in $KIBANA_HOME/config/<filename> abgelegt werden.

Kibana einrichten

Erstellen Sie vor der Ausführung des Docker-Containers, der Kibana enthält, eine Konfigurationsdatei in demselben Ordner mit dem heruntergeladenen Elasticsearch-Zertifikat aus Schritt 1. Die Konfigurationsdatei enthält einige grundlegende Kibana-Einstellungen wie folgt.

Erstellen Sie eine YAML-Datei mit dem Namen kibana.yml. Innerhalb der Datei benötigen Sie die folgenden Kibana-Konfigurationseinstellungen:

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"

Die erste Einstellung, elasticsearch.ssl.certificateAuthorities, ist die Position, an der Docker das Elasticsearch-Zertifikat speichert. Das Zertifikat wird an dieser Position gespeichert, wenn Sie Docker zum ersten Mal ausführen. Sie können den Pfad nach Belieben ändern, der im Beispiel angegebene Pfad ist jedoch das Konfigurationsverzeichnis von Kibana. Stellen Sie sicher, dass der Zertifikatsname (in unserem Beispiel "cert") in kibana.yml und die in Schritt 1 gespeicherte Zertifikatsnamensdatei denselben Namen haben.

Als Nächstes werden elasticsearch.username und elasticsearch.password verwendet. Verwenden Sie den Benutzernamen und das Kennwort des Administrators der Bereitstellung. Stellen Sie sicher, dass Sie das Administratorkennwort festgelegt haben, bevor Sie versuchen, eine Verbindung herzustellen. Geben Sie für „ elasticsearch.hosts “ den Hostnamen und den Port der Bereitstellung ein, getrennt durch „ : “.

Abschließend sei angemerkt, dass „ server.name “ ein maschinenlesbarer Name für die Kibana-Instanz ist und „ server.hosts “ der Host des Backend-Servers ist, über den Sie in Ihrem Webbrowser eine Verbindung zu Kibana herstellen können.

Diese Einstellungen sind nur ein vereinfachtes Beispiel für den Einstieg. Weitere Informationen finden Sie unter Konfigurieren von Kibana.

Wenn Sie Kibana lokal ausführen und nicht unter Docker, dann muss die YAML-Datei im Verzeichnis $KIBANA_HOME/config/kibana.yml abgelegt werden, da Kibana dort seine Konfiguration liest.

Kibana-Container ausführen

Nachdem die Datei „ kibana.yml “ nun eingerichtet ist, verwenden Sie den Befehl „ Docker “, um die YAML-Datei und Ihre Zertifikatsdatei an den Container „ Docker “ anzuhängen und gleichzeitig das Image „ <kibana_version> “ aus dem Image-Repository „ Docker “ abzurufen.

Verwenden Sie ein Image mit einer Kibana-Version, die mit der in Ihrer Bereitstellung verwendeten Version von „ Elasticsearch “ kompatibel ist. Rufen Sie die Version Elasticsearch über den API-Endpunkt https_endpoint ab, indem Sie Ihren bevorzugten http-Client verwenden. Weitere Informationen finden Sie in der Kompatibilitätsmatrix Elasticsearch.

Hier ist ein Beispiel mit curl. Wenn das Zertifikat nicht installiert ist, verwenden Sie das Flag --insecure, um die Peer-Verifizierung zu inaktivieren. Die <http_endpoint> finden Sie in der Benutzerschnittstelle Endpunkte Ihrer Instanz:

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

Führen Sie anschließend in Ihrem Terminal den Befehl „ Docker “ aus, um den Kibana-Container zu starten.

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>

Der Befehl Docker hat einen Datenträger, der mit dem Flag -v angehängt wird. Diese werden im Kibana-Container unter dem Pfad „ /usr/share/kibana/config/ “ abgelegt. Dabei handelt es sich um ein Konfigurationsverzeichnis, in dem Kibana nach Konfigurationsdateien sucht.

• Die Datei „ -p “ legt fest, welcher Port vom Container nach außen freigegeben wird und über welchen Port Sie auf Kibana zugreifen.
• Die Kibana-Version sollte der verwendeten Elasticsearch-Version entsprechen.

Beim Ausführen des Befehls über den Terminal wird das Kibana-Docker-Image heruntergeladen und Kibana ausgeführt. Sobald Kibana mit Ihrer Databases for Elasticsearch-Bereitstellung verbunden ist und erfolgreich ausgeführt wird, sehen Sie die folgende Ausgabe in Ihrem 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

Wenn Sie die Ausgabe von Kibana in Ihrem Terminal nicht anzeigen wollen, verwenden Sie das Flag -d, um die Zuordnung des Containers aufzuheben.

Besuchen Sie http://0.0.0.0:5601 in Ihrem Browser, um Kibana anzuzeigen. 0.0.0.0 ist der server.host in kibana.yml und 5601 ist der Port, der vom Container zugänglich gemacht wird. Wenn Sie die URL aufrufen, werden Sie in einem Popup-Fenster aufgefordert, Ihren Benutzernamen und Ihr Kennwort einzugeben. Verwenden Sie die Administratorberechtigungsnachweise oder andere Berechtigungsnachweise, die Sie erstellt haben, um auf Ihre Bereitstellung zuzugreifen. Die Anmeldedaten müssen nicht unbedingt mit dem Benutzernamen und dem Passwort übereinstimmen, die Sie in der Datei „ kibana.yml “ angegeben haben.