Cómo configurar las plantillas de índice Elasticsearch

Los índices son una característica esencial de elasticsearch sin la cual probablemente no funcionaría como lo hace. Aunque los índices de ElasticSearch pueden variar según el uso previsto, tienden a compartir propiedades comunes. Dado esto, puede ser agotador crear propiedades similares para todos los índices. En cambio, es mucho más eficiente crear una plantilla a la que podamos referirnos al crear un índice.

Este tutorial lo guiará a través de las plantillas de índice de Elasticsearch que le permiten definir plantillas o planos para índices comunes. Por ejemplo, si constantemente registra datos de fuentes externas, puede definir un plan para todos los índices de registro.

NOTA: Antes de comenzar, es bueno tener en cuenta que el tutorial se centra en la última versión de Elasticsearch-7.8 Al momento de escribir, y puede variar de otras versiones. También asumimos que tiene elasticsearch ejecutándose en un sistema en algún lugar.

Comencemos a trabajar con las plantillas de índice Elasticsearch.

¿Qué es una plantilla de índice Elasticsearch??

Una plantilla de índice Elasticsearch es un método utilizado para instruir a ElasticSearch para configurar índices en la creación. Por ejemplo, una plantilla de índice utilizada en un flujo de datos configura los índices de respaldo de la secuencia tras la creación. Una plantilla de índice se crea manualmente antes de la creación del índice. Al crear un índice, la plantilla aplica la configuración de configuración para el índice.

La última versión de Elasticsearch tiene dos tipos de plantillas utilizables. Uno es el plantilla de índice, y el otro es plantillas de componentes. Como ya hemos establecido, las plantillas de índice ayudan a crear índices Elasticsearch.

Las plantillas de componentes son módulos o bloques reutilizables utilizados para configurar configuraciones, mapeo y alias. Las plantillas de componentes no se aplican directamente a los índices creados, pero pueden ayudar a crear plantillas de índice.

Algunas plantillas de índice predeterminadas utilizadas por ElasticSearch incluyen: Métricas-*-*, Logs-*-* .

Cómo crear una plantilla de índice

Para crear nuevas plantillas de índice o actualizar las existentes, usamos la API de plantilla Put Plantilla. Usando el punto final _index_template, podemos enviar una solicitud HTTP para agregar una plantilla.

La sintaxis general para crear una plantilla es:

Poner _index_template/Template_name

Es bueno tener en cuenta que el nombre de la plantilla es un parámetro requerido. Considere la siguiente solicitud que crea una plantilla de índice como plantilla_1

Poner _index_template/template_1

/ * Defina el patrón de índice */
"index_patterns": ["te*"],
"Prioridad 1,
/* Defina la configuración para los índices*/
"plantilla":
"ajustes" :
"Number_of_shards": 2

Para usuarios de curl, el comando es:

curl -xput "http: // localhost: 9200/_index_template/template_1" -h 'content -type: application/json' -d '/*Definir el patrón de índice*/"index_patterns": ["te*"],,, "Prioridad": 1, /* Definir configuraciones para los índices* / "plantilla": "configuración": "number_of_shards": 2 '

Elasticsearch utiliza un patrón comodín para que coincida con los nombres de índice donde se aplican las plantillas. Cambiar o actualizar una plantilla de índice no afecta a los índices ya creados solo los que se crearán después de usar esa plantilla.

Desde arriba, puede comentar sobre sus plantillas utilizando el método de comentarios del idioma C. Puede agregar tantos comentarios como desee, en cualquier lugar del cuerpo, excepto la apertura de los frenos rizados.

En el cuerpo de una plantilla de índice, puede incluir varias definiciones, como:

• Plantilla: La propiedad de la plantilla (objeto) define qué plantilla se aplicará; Puede incluir alias, asignaciones y configuraciones, este es un parámetro opcional.
• Compuesto de: Esta propiedad define una lista de nombres para plantillas de componentes. Una vez definido, las plantillas de componentes se agravan en su orden de especificación. Eso significa que la última plantilla de componente definida tiene la precedencia más alta.
• Prioridad: La propiedad prioritaria define la precedencia de la plantilla de índice al crear un índice. Si alguna precedencia tiene el valor más alto, tiene mayor precedencia en comparación con los valores más bajos. El valor prioritario no es necesario y es de tipo entero. 0 es el valor predeterminado para plantillas no especificadas.
• Versión: El parámetro de la versión especifica la versión de plantilla de índice, que ayuda a administrar las plantillas.

Hay otras propiedades que puede incluir en el cuerpo de la plantilla de índice. Considere la documentación para obtener más información.

https: // www.elástico.CO/Guía/EN/ElasticSearch/Reference/7.10/plantillas de índice.html

A continuación se muestra una solicitud de ejemplo para crear una nueva plantilla con la versión 1.0

Put /_index_template /template_2

"index_patterns": ["REMP*", "Re*"],
"Prioridad 1,
"plantilla":
"ajustes" :
"Number_of_shards": 2,
"Number_of_replicas": 0

,
"versión 1.0

No puede tener más de una plantilla de índice con un patrón de coincidencia y la misma prioridad. Por lo tanto, asegúrese de asignar diferentes prioridades para que coincidan con las plantillas de patrones.

Cómo obtener la plantilla de índice

Para ver la información sobre una plantilla de índice, envíe una solicitud GET a la API _index_template. Por ejemplo, para ver información sobre Template_2, use la solicitud:

Obtener _index_template/Template_2

El comando curl es:

curl -xget "http: // localhost: 9200/_index_template/template_2"

Este comando debe mostrar información sobre Template_2

"index_templates": [

"Nombre": "Template_2",
"index_template":
"index_patterns": [
"REMP*",
"re*"
],
"plantilla" :
"ajustes" :
"índice":
"Number_of_shards": "2",
"Number_of_replicas": "0"


,
"compuesto de" : [ ],
"Prioridad 1,
"versión 1


]

También puede usar comodines para obtener plantillas de juego. Por ejemplo, considere la siguiente solicitud para ver todas las plantillas en Elasticsearch.

Obtener _index_template/*

El comando curl es.

curl -xget http: // localhost: 9200/_index_template/*

Este comando debe brindarle información sobre todas las plantillas en Elasticsearch

"index_templates": [

"Nombre": "Ilm-History",
"index_template":
"index_patterns": [
"ILM-History-3*"
],
"plantilla" :
"ajustes" :
"índice":
"Formato": "1",
"ciclo vital" :
"Nombre": "ILM-History-Ilm-Policy",
"Rollover_alias": "ILM-History-3"
,
"Oculto": "verdadero",
"Number_of_shards": "1",
"Auto_EXPAND_REPLICAS": "0-1",
"Number_of_replicas": "0"

,
"Mapeos":
"Dynamic": falso,
"propiedades" :
"index_age":
"Tipo": "largo"
,
"@timestamp":
"Formato": "Epoch_millis",
"Tipo": "Fecha"
,
"error de detalles" :
"teclee el texto"
,
"éxito":
"Tipo": "booleano"
,
"índice":
"Tipo": "Palabra clave"
,
"estado" :
"Dynamic": verdadero,
"Tipo": "Objeto",
--------------------------Salida truncada-----------------------------------

Cómo eliminar las plantillas

Eliminar una plantilla es tan simple como la plantilla Get pero utilizando la solicitud de eliminación como:

Eliminar _index_template/Template_2

Puede usar el comando curl:

curl -xdelete "http: // localhost: 9200/_index_template/template_2"

Este comando elimina automáticamente la plantilla especificada.

Conclusión

Este tutorial cubrió lo que son las plantillas de índice Elasticsearch, cómo funcionan y cómo crear, ver y eliminar plantillas de índice. Esta información básica debería ayudarlo a comenzar a utilizar las plantillas de índice Elasticsearch.