Este tutorial analiza el arte de usar Elasticsearch CAT API para ver información detallada sobre los índices en el clúster. Esta información debería ayudarlo a administrar cómo se están desempeñando los clústeres y qué acciones tomar.
Es posible que ya sepa que Elasticsearch ama JSON y lo usa para todas sus API. Sin embargo, la información o los datos que se muestran solo le resultan útiles cuando están en una forma simple y bien organizada; JSON podría no lograr esto muy bien. Por lo tanto, Elasticsearch no recomienda usar CAT API con aplicaciones, sino solo para lectura humana.
Con eso fuera del camino, vamos a sumergirnos!
Cómo ver información de alto nivel sobre índices?
Para obtener información de alto nivel sobre un índice de Elasticsearch, usamos la API_cat. Por ejemplo, para ver información sobre un clúster específico, use el comando:
OBTENER / _cat / índices /También puede utilizar el comando cRUL:
curl -XGET "http: // localhost: 9200 / _cat / indices /Una vez que ejecute la solicitud anterior, obtendrá información sobre el índice especificado. Esta información puede incluir:
- Número de fragmentos
- Documentos disponibles en el índice
- Número de documentos eliminados en el índice
- El tamaño principal
- El tamaño total de todos los fragmentos de índice (réplicas incluidas)
La API _cat también puede obtener información de alto nivel sobre todos los índices de un clúster, por ejemplo:
GET / _cat / índicesPara usuarios de cURL, ingrese el comando:
curl -XGET "http: // localhost: 9200 / _cat / indices"Esto debería mostrar información sobre todos los índices del clúster, como se muestra a continuación:
verde abierto .siem-señales-predeterminado-000001 YFRPjV8wQju_ZZupE1s12g 1 1 0 0 416b 208bverde abierto .seguimiento-beats-7-2021.01.21 iQZnVRaNQg-m7lkeEKA8Bw 1 1 3990 0 7mb 3.4mb
verde abierto elástico-nube-registros-7-2021.01.20-000001 cAVZV5d1RA-GeonwMej5nA 1 1 121542 0 43.4mb 21.4mb
verde abierto .triggered_watches FyLc7T7wSxSW9roVJxyiPA 1 1 0 0 518.7 KB 30.1 kb
verde abierto apm-7.10.2-incorporación-2021.01.20 zz-RRPjXQ1WGZIrRiqsLOQ 1 1 2 0 29.4kb 14.7 KB
verde abierto kibana_sample_data_flights 9nA2U3m7QX2g9u_JUFsgXQ 1 1 13059 0 10.6mb 5.3mb
verde abierto .monitoreo-kibana-7-2021.01.21 WiGi5NaaTdyUUyKSBgNx9w 1 1 6866 0 3.1 mb 1.7 MB
verde abierto .seguimiento-beats-7-2021.01.20 1Lx1vaQdTx2lEevMH1N3lg 1 1 4746 0 8mb 4mb
------------------------------------SALIDA TRUNCADA-------------------------
Cómo filtrar la información requerida?
En la mayoría de los casos, solo necesitará información específica sobre índices. Para lograr esto, puede usar los parámetros de la API _cat.
Por ejemplo, para obtener solo el UUID del índice, el tamaño y el estado de salud, puede usar el parámetro h para lograr esto. Por ejemplo, considere la solicitud a continuación:
GET / _cat / índices?v = verdadero & h = uuid, salud, tienda.TallaEl comando cURL para este ejemplo es:
curl -XGET “http: // localhost: 9200 / _cat / indices?v = verdadero & h = uuid, salud, tienda.Talla"Eso debería mostrar información filtrada para todos los índices del clúster. Aquí hay un resultado de ejemplo:
tienda de salud uuid.TallaYFRPjV8wQju_ZZupE1s12g verde 416b
iQZnVRaNQg-m7lkeEKA8Bw verde 7.1 mb
cAVZV5d1RA-GeonwMej5nA verde 44.1 mb
FyLc7T7wSxSW9roVJxyiPA verde 518.7 KB
zz-RRPjXQ1WGZIrRiqsLOQ verde 29.4kb
9nA2U3m7QX2g9u_JUFsgXQ verde 10.6mb
WiGi5NaaTdyUUyKSBgNx9w verde 3.9 MB
QdXSZTY8TA2mDyJ5INSaHg verde 2.8 MB
1Lx1vaQdTx2lEevMH1N3lg verde 8mb
aBlLAWhPRXap32EqrKMPXA verde 67.7 KB
Bg2VT1QpT4CSjnwe1hnq_w verde 416b
aoWhhWu9QsWW4T5CY_XWZw verde 416b
6SAhoYJaS_6y_u8AZ0m3KQ verde 416b
Wco9drGpSn67zYME6wFCEQ verde 485.5 KB
eN2loWymSpqLlC2-ElYm1Q verde 416b
K5C9TeLcSy69SsUdtkyGOg verde 40.2 KB
bUDul_72Rw6_9hWMagiSFQ verde 3.1 mb
c7dOH6MQQUmHM2MKJ73ekw verde 416b
aoTRvqdfR8-dGjCmcKSmjw verde 48.9 KB
IG7n9JghR1ikeCk7BqlaqA verde 416b
BWAbxK06RoOSmL_KiPe09w verde 12.5 KB
feAUC7k2RiKrEws9iveZ0w verde 4.6mb
F73wTiN2TUiAVcm2giAUJA verde 416b
hlhLemJ5SnmiQUPYU2gQuA verde 416b
jbUeUWFfR6y2TKb-6tEh6g verde 416b
2ZyqPCAaTia0ydcy2jZd3A verde 304.5 KB
---------------------------------SALIDA TRUNCADA----------------------------
Cómo obtener todas las métricas del índice?
Suponga que desea estadísticas detalladas para un índice específico. En tales casos, puede utilizar el punto final _stats para consultar los datos. Por ejemplo, para obtener información detallada sobre un índice llamado temp_2, use la solicitud:
GET / temp_2 / _statsTambién puede usar cURL como:
curl -XGET "http: // localhost: 9200 / temp_2 / _stats"Un ejemplo de información estadística debería ser como se muestra a continuación:
"_shards":
"total": 2,
"exitoso": 2,
"fallido": 0
,
"_todas" :
"primarias":
"documentos":
"cuenta": 0,
"eliminado": 0
,
"Tienda" :
"tamaño_en_bytes": 208,
"reservado_en_bytes": 0
,
"indexación":
"index_total": 0,
"index_time_in_millis": 0,
"index_current": 0,
"index_failed": 0,
"delete_total": 0,
"delete_time_in_millis": 0,
"delete_current": 0,
"noop_update_total": 0,
"is_throttled": falso,
"throttle_time_in_millis": 0
,
"obtener" :
"total": 0,
"time_in_millis": 0,
"existe_total": 0,
"existe_tiempo_en_millis": 0,
"missing_total": 0,
"missing_time_in_millis": 0,
"actual": 0
,
-----------------------------SALIDA TRUNCADA------------------------------
Conclusión
En este tutorial rápido, hemos aprendido cómo usar la API de Elasticsearch para obtener información sobre índices únicos o múltiples dentro de un clúster. También aprendimos cómo filtrar datos para obtener solo los valores requeridos. Puede obtener más información consultando la API _cat y _stats.
Para obtener más tutoriales de Elasticsearch, busque en el sitio.
Gracias por leer.