1. 1
Instalar Stack ELK Windows 10.
Elastic search es un software libre escrito en Java, es un motor de búsqueda y análisis, trabaja con un motor
de recopilación de datos (Logstash) y una plataforma de análisis y visualización de datos (Kibana), los tres
productos están diseñados para trabajar unidos bajo el nombre de ELK.
Procesos llevados a cabo en el stack ELK
Notas
Se utiliza Windows 10 Profesional con 8GB RAM.
Se recomienda instalar la misma versión de todos los componentes, en este caso la 7.2.
Se recomienda descomprimir e instalar todos los componentes en una misma ruta, en este ejemplo
E:ELK.
Requisitos
JDK V8 instalado y funcionando.
Descargar software:
o Elastic/kibana/logstash/ https://www.elastic.co/es/downloads
o Winpcap https://www.winpcap.org/install/default.htm
o Nssm https://nssm.cc/download
Una vez descargado todos los componentes, descomprimir en un directorio, en este caso E:ELK.
2. Instalar ELK Windows| Moisés Araya
[2]
Parte 1 – Instalar Elasticsearch.
• Instalar servicio elasticsearch.
o Ir a la ruta E:ELKelasticsearch-7.2.0bin>elasticsearch.bat install
o Asignar nombre a servicio: elasticsearch-service-x64.
o Iniciar servicio.
o Validar acceso.
3. Instalar ELK Windows| Moisés Araya
[3]
Al iniciar el servicio, da un error con el directorio temporal.
[2019-07-11T18:25:54,348][ERROR][o.e.b.Bootstrap ] [DESKTOP-IOQAV6P] Exception
java.lang.SecurityException: Security misconfiguration: cannot access java.io.tmpdir
at org.elasticsearch.bootstrap.Security.selfTest(Security.java:423) ~[elasticsearch-7.2.0.jar:7.2.0]
at org.elasticsearch.bootstrap.Security.configure(Security.java:133) ~[elasticsearch-7.2.0.jar:7.2.0]
at org.elasticsearch.bootstrap.Bootstrap.setup(Bootstrap.java:216) ~[elasticsearch-7.2.0.jar:7.2.0]
at org.elasticsearch.bootstrap.Bootstrap.init(Bootstrap.java:349) [elasticsearch-7.2.0.jar:7.2.0]
at org.elasticsearch.bootstrap.Security.selfTest(Security.java:416) ~[elasticsearch-7.2.0.jar:7.2.0]
... 10 more
Se resuelve ejecutando elasticsearch-service.bat manager y en Java Options agregar “-
Djava.io.tmpdir=C:tmp”
Iniciar servicio y revisar el archivo elasticsearch.log ubicado en la ruta E:ELKelasticsearch-7.2.0logs
[2019-10-23T18:37:17,130][INFO ][o.e.n.Node
[2019-10-23T18:37:17,130][INFO ][o.e.n.Node
[2019-10-23T18:37:23,571][INFO ][o.e.n.Node
] [DESKTOP-IOQAV6P] initialized
] [DESKTOP-IOQAV6P] starting ...
] [DESKTOP-IOQAV6P] started
Extracto de log.
# Referencia de error: https://discuss.elastic.co/t/cannot-run-elasticsearch-7-2-as-a-windows-service/189253
4. Instalar ELK Windows| Moisés Araya
[4]
• Validar funcionamiento accediendo vía browser a: http://localhost:9200/
• También se puede validar por Power Shell.
o Ejecutar PS como administrador la sentencia: invoke-restmethod http://localhost:9200
Resultado satisfactorio vía PS.
Desinstalar el servicio
Utilizar el mismo utilitario y en vez de install se debe colocar remove + nombre del servicio.
5. Instalar ELK Windows| Moisés Araya
[5]
Parte 2 - Instalar Logstash.
Antes de instalar logstash, descomprimir nssm en la misma ruta E:ELKnssm-2.24
Descomprimir logstash-7.2.0.zip en ruta E:ELKlogstash-7.2.0
Crear archivo logstash.conf en la ruta E:ELKlogstash-7.2.0config con el siguiente contenido:
input {
beats {
port => 5044
type => "log"
}
}
output {
elasticsearch {
hosts => "localhost:9200"
manage_template => false
index => "%{[@metadata][beat]}-%{+YYYY.MM.dd}"
document_type => "%{[@metadata][type]}"
}
}
Crear el servicio logstash usando nssm.
Ejecutar Power Shell (como administrador) con el siguiente comando: Invoke-Expression -command
“E:ELKnssm-2.24win64nssm install Logstash”
En pestaña aplicación colocar el siguiente contenido:
o Path: E:ELKlogstash-7.2.0binlogstash.bat
o Startup directory: E:ELKlogstash-7.2.0bin
o Arguments: -f E:ELKlogstash-7.2.0configlogstash.conf
6. Instalar ELK Windows| Moisés Araya
[6]
En pestaña detalles:
o Display Name: Logstash
o Description: Logstash Service
o Startup type: Automatic
En pestaña dependencias:
o This service depends on the following system components.
o Elasticsearch-service-x64
Finalizar configuración presionando botón Install Service.
Iniciar servicio.
# Al iniciar el servicio se crea directorio de logs en E:ELKlogstashlogs.
7. Instalar ELK Windows| Moisés Araya
[7]
Parte 3 - Instalar Kibana.
Descomprimir instalador en E:ELKkibana-7.2.0-windows-x86_64
Se vuelve a usar el utilitario nssm.
o invoke-expression -command "E:ELKnssm-2.24win64nssm install Kibana"
En pestaña aplicación colocar el siguiente contenido:
o Path: E:ELKkibana-7.2.0-windows-x86_64binkibana.bat
o Startup directory: E:ELKkibana-7.2.0-windows-x86_64bin
En pestaña dtalles:
o Display Name: Kibana
o Description: Kibana Service
o Startup type: Automatic
En pestaña dependencias:
o This service depends on the following system components
o Elasticsearch-service-x64 y Logstash
8. Instalar ELK Windows| Moisés Araya
[8]
Finalizar configuración presionando botón Install Service.
Iniciar servicio.
Prueba de servicio por URL.
o http://localhost:5601
En este punto, el stack ELK queda operativo y funcionando en un entorno Windows 10.
9. Instalar ELK Windows| Moisés Araya
[9]
Cargar datos de ejemplo (opcional)
Hacer clic en icono (superior izquierdo) de Kibana y cargar datos de muestra, seleccionar el tipo de
información deseada y presionar botón “Add Data”, después de agregar los datos, se mostraran las
opciones para ver estos datos “View Data”.
10. Instalar ELK Windows| Moisés Araya
[10]
Luego seleccionar Dashboard (Panel de control). Se cargará un tablero con datos de muestra de
servidores web.
Datos adicionales.
Elasticsearch
Los valores de JVM se pueden modificar en archivo jvm.options ubicado en el directorio config,
El nombre del servicio se puede modificar en archivo elasticsearch-service.bat
El puerto TCP se puede cambiar en archivo elasticsearch.yml ubicado en el directorio config.
Otros usos de archivo elasticsearch-service.bat:
o Remove: elimina el servicio instalado.
o Start: inicia el servicio instalado.
o Stop: detiene el servicio instalado.
o Manager: ejecuta el administrador grafico del servicio instalado.
Logstash
Para validar la configuración de logstash ejecutar como se muestra en imagen:
11. Instalar ELK Windows| Moisés Araya
[11]
Kibana
El archivo de configuración de Kibana es Kibana.yml y está ubicado en
E:ELKkibanaconfigkibana.yml
Para agregar un registro de log para Kibana, editar archivo de configuración y editar/agregar el campo
logging.dest con la ruta y archivo deseado.
Contenido típico de un registro Kibana:
{"type":"log","@timestamp":"2019-07-12T22:59:14Z","tags":["listening","info"],"pid":120,"message":"Server running
at http://127.0.0.1:5601"}
El orden de inicio de los servicios es:
1. Elasticsearch
2. Logstash
3. Kibana
Más detalles en https://www.elastic.co/guide/index.html