El usuario administrador

Cuando se aprovisiona un despliegue Databases for Elasticsearch, se crea automáticamente un usuario ' admin '.

Establezca la contraseña de administrador antes de utilizarla para conectarse.

Antes de empezar

• Instala Docker para que puedas extraer la imagen del contenedor Kibana para conectarte a Databases for Elasticsearch.
• Si prefiere evitar ejecutar Kibana localmente e instalar Docker, también puede desplegar Kibana utilizando IBM Cloud® Code Engine. Para obtener más información, consulte Despliegue de Kibana utilizando la instancia de Code Engine y conéctese a la instancia de Databases for Elasticsearch.

Para conectarse, Kibana necesita el nombre de usuario, la contraseña, la URL y el puerto de su implementación Elasticsearch. También necesita el certificado TLS Elasticsearch para acceder a la base de datos. Para obtenerlo, copie la información del certificado de la sección Endpoints de la página Overview de su instancia de Elasticsearch creada. A continuación, descargue el certificado en una carpeta local. Puede utilizar el nombre que se proporciona en la descarga o su propio nombre de archivo.

Recuerde dónde guarda el certificado en el sistema de archivos. Si está ejecutando Kibana localmente, no en Docker, entonces el certificado va en $KIBANA_HOME/config/<filename>.

Configurar Kibana

Antes de ejecutar el contenedor Docker que incluye Kibana, cree un archivo de configuración en la misma carpeta con el certificado Elasticsearch descargado del paso 1. El archivo de configuración contendrá algunos valores básicos de Kibana como se indica a continuación.

Cree un archivo YAML denominado kibana.yml. Dentro de este archivo, necesita los siguientes valores de configuración de 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"

El primer valor, elasticsearch.ssl.certificateAuthorities, es la ubicación donde Docker almacenará el certificado Elasticsearch. Se coloca en esta ubicación cuando se ejecuta por primera vez Docker. Puede cambiarlo a una ubicación de su elección, pero la ruta de ejemplo es el directorio de configuración de Kibana. Asegúrese de que el nombre de certificado (en nuestro ejemplo "cert") dentro de kibana.yml y el archivo de nombre de certificado almacenado en el paso 1 tengan el mismo nombre.

A continuación van elasticsearch.username y elasticsearch.password. Utilice el nombre de usuario y la contraseña del administrador del despliegue. Asegúrese de establecer la contraseña de administrador antes de intentar establecer la conexión. En elasticsearch.hosts, introduzca el nombre de host y el puerto de la implantación, separados por :.

Por último, server.name es un nombre legible por máquina para la instancia de Kibana y server.hosts es el host del servidor backend donde puede conectarse a Kibana en su navegador web.

Estos ajustes son sólo un ejemplo simplificado para empezar. Para obtener más información, consulte Configurar Kibana.

Si está ejecutando Kibana localmente, no en Docker, entonces el archivo YAML va en $KIBANA_HOME/config/kibana.yml, donde Kibana lee su configuración.

Ejecutar el contenedor de Kibana

Ahora que el archivo kibana.yml está configurado, utilice Docker para adjuntar el archivo YAML y su archivo de certificado al contenedor Docker, mientras extrae la imagen <kibana_version> del repositorio de imágenes Docker.

Utilice una imagen con una versión de Kibana que sea compatible con la versión de Elasticsearch que se está ejecutando. Recupere la versión de Elasticsearch del punto final de API de https_endpoint utilizando el cliente http preferido. Para obtener más información, consulte la matriz de compatibilidadElasticsearch.

Aquí hay un ejemplo con curl. Si no tiene instalado el certificado, utilice el distintivo --insecure para inhabilitar la verificación de igual. <http_endpoint> se puede encontrar en la interfaz de usuario de Puntos finales de la instancia:

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

A continuación, ejecute el comando Docker en su terminal para iniciar el contenedor 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>

El mandato Docker tiene un volumen conectado con el distintivo -v. Estos se montan en el contenedor de Kibana en la ruta /usr/share/kibana/config/, que es un directorio de configuración donde Kibana busca los archivos de configuración.

• El -p especifica qué puerto se expone desde el contenedor, y el puerto que se utiliza para acceder a Kibana.
• La versión de Kibana debe corresponder a la versión de Elasticsearch que está utilizando.

Cuando ejecuta el mandato desde el terminal, se descarga la imagen de Kibana Docker y se ejecuta Kibana. Una vez que Kibana se haya conectado a su despliegue de Databases for Elasticsearch y se esté ejecutando satisfactoriamente, verá la salida en el 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 no desea ver la salida de Kibana en el terminal, utilice el distintivo -d para desconectar el contenedor.

Visite http://0.0.0.0:5601 en el navegador para ver Kibana. 0.0.0.0 es server.host en kibana.yml y 5601 es el puerto que se expone desde el contenedor. Una vez que siga el URL, una ventana emergente le solicitará el nombre de usuario y la contraseña. Utilice las credenciales de administrador, o cualquier otra credencial que haya realizado, para acceder al despliegue. Las credenciales no tienen por qué ser el mismo nombre de usuario y contraseña que proporcionó en el archivo kibana.yml.