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 descargar la imagen del contenedor de Kibana y 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. Además, necesita el certificado Elasticsearch TLS 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 la instancia Elasticsearch creada. A continuación, descargue el certificado en una carpeta local. Puedes utilizar el nombre que aparece en la descarga o el nombre que tú mismo le quieras dar al archivo.

Recuerde dónde guarda el certificado en el sistema de archivos. Si estás ejecutando Kibana de forma local, y no en Docker, el certificado debe colocarse 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. Puedes cambiarlo por la ubicación que prefieras, pero la ruta del 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 el campo « elasticsearch.hosts », introduce el nombre de host y el puerto de la implementació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 al que puedes conectarte desde tu navegador web para acceder a Kibana.

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

Si estás ejecutando Kibana de forma local, y no en Docker, el archivo YAML debe colocarse en $KIBANA_HOME/config/kibana.yml, que es donde Kibana lee su configuración.

Ejecutar el contenedor de Kibana

Ahora que ya tienes configurado el archivo « kibana.yml », utiliza Docker para adjuntar el archivo YAML y tu archivo de certificado al contenedor Docker, al tiempo que descargas la imagen <kibana_version> del repositorio de imágenes Docker.

Utiliza una imagen con una versión de Kibana que sea compatible con la versión de Elasticsearch que se está ejecutando en tu entorno. Recupere la versión Elasticsearch desde el punto final de la API https_endpoint utilizando su cliente http preferido. Para más información, consulte la matriz de compatibilidad Elasticsearch.

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, ejecuta el comando « Docker » en tu terminal para iniciar el contenedor de 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 en el que Kibana busca los archivos de configuración.

• El archivo « -p » especifica qué puerto queda expuesto 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. No es necesario que las credenciales coincidan con el nombre de usuario y la contraseña que has indicado en el archivo « kibana.yml ».