Phenquestions
Este tutorial discute a arte de usar a API Elasticsearch CAT para visualizar informações detalhadas sobre os índices no cluster. Essas informações devem ajudá-lo a gerenciar o desempenho dos clusters e quais ações tomar.
Você já deve saber que o Elasticsearch adora JSON e o usa para todas as suas APIs. No entanto, as informações ou dados exibidos são úteis apenas quando estão em uma forma simples e bem organizada; JSON pode não fazer isso muito bem. Assim, Elasticsearch não recomenda o uso de CAT API com aplicativos, mas apenas para leitura humana.
Com isso fora do caminho, vamos mergulhar!
Como visualizar informações de alto nível sobre índices?
Para obter informações de alto nível sobre um índice Elasticsearch, usamos a API the_cat. Por exemplo, para ver informações sobre um cluster específico, use o comando:
GET / _cat / indices /Você também pode usar o comando cRUL:
curl -XGET "http: // localhost: 9200 / _cat / indices /Depois de executar a solicitação acima, você obterá informações sobre o índice especificado. Essas informações podem incluir:
- Número de fragmentos
- Documentos disponíveis no índice
- Número de documentos excluídos no índice
- O tamanho principal
- O tamanho total de todos os fragmentos de índice (réplicas incluídas)
A API _cat também pode buscar informações de alto nível sobre todos os índices em um cluster, por exemplo:
GET / _cat / indicesPara usuários cURL, digite o comando:
curl -XGET “http: // localhost: 9200 / _cat / indices”Isso deve exibir informações sobre todos os índices do cluster, conforme mostrado abaixo:
verde aberto .siem-signs-default-000001 YFRPjV8wQju_ZZupE1s12g 1 1 0 0 416b 208bverde aberto .monitoramento-beats-7-2021.01.21 iQZnVRaNQg-m7lkeEKA8Bw 1 1 3990 0 7mb 3.4 MB
verde aberto elastic-cloud-logs-7-2021.01.20-000001 cAVZV5d1RA-GeonwMej5nA 1 1 121542 0 43.4mb 21.4 MB
verde aberto .triggered_watches FyLc7T7wSxSW9roVJxyiPA 1 1 0 0 518.7kb 30.1kb
verde aberto apm-7.10.2-onboarding-2021.01.20 zz-RRPjXQ1WGZIrRiqsLOQ 1 1 2 0 29.4kb 14.7kb
verde aberto kibana_sample_data_flights 9nA2U3m7QX2g9u_JUFsgXQ 1 1 13059 0 10.6mb 5.3 MB
verde aberto .monitoramento-kibana-7-2021.01.21 WiGi5NaaTdyUUyKSBgNx9w 1 1 6866 0 3.1mb 1.7mb
verde aberto .monitoramento-beats-7-2021.01.20 1Lx1vaQdTx2lEevMH1N3lg 1 1 4746 0 8mb 4mb
------------------------------------SAÍDA TRUNCADA-------------------------
Como filtrar as informações necessárias?
Na maioria dos casos, você só precisará de informações específicas sobre os índices. Para fazer isso, você pode usar parâmetros de API _cat.
Por exemplo, para obter apenas o UUID do índice, tamanho e status de integridade, você pode usar o parâmetro h para fazer isso. Por exemplo, considere a solicitação abaixo:
GET / _cat / indices?v = true & h = uuid, saúde, armazenamento.TamanhoO comando cURL para este exemplo é:
curl -XGET “http: // localhost: 9200 / _cat / indices?v = true & h = uuid, saúde, armazenamento.Tamanho"Isso deve exibir informações filtradas para todos os índices do cluster. Aqui está um exemplo de saída:
loja de saúde uuid.TamanhoYFRPjV8wQju_ZZupE1s12g verde 416b
iQZnVRaNQg-m7lkeEKA8Bw verde 7.1mb
cAVZV5d1RA-GeonwMej5nA verde 44.1mb
FyLc7T7wSxSW9roVJxyiPA verde 518.7kb
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.7kb
Bg2VT1QpT4CSjnwe1hnq_w green 416b
aoWhhWu9QsWW4T5CY_XWZw verde 416b
6SAhoYJaS_6y_u8AZ0m3KQ verde 416b
Wco9drGpSn67zYME6wFCEQ verde 485.5kb
eN2loWymSpqLlC2-ElYm1Q verde 416b
K5C9TeLcSy69SsUdtkyGOg verde 40.2kb
bUDul_72Rw6_9hWMagiSFQ verde 3.1mb
c7dOH6MQQUmHM2MKJ73ekw verde 416b
aoTRvqdfR8-dGjCmcKSmjw verde 48.9kb
IG7n9JghR1ikeCk7BqlaqA verde 416b
BWAbxK06RoOSmL_KiPe09w verde 12.5kb
feAUC7k2RiKrEws9iveZ0w verde 4.6mb
F73wTiN2TUiAVcm2giAUJA verde 416b
hlhLemJ5SnmiQUPYU2gQuA verde 416b
jbUeUWFfR6y2TKb-6tEh6g verde 416b
2ZyqPCAaTia0ydcy2jZd3A verde 304.5kb
---------------------------------SAÍDA TRUNCADA----------------------------
Como obter todas as métricas do índice?
Suponha que você queira estatísticas detalhadas para um índice específico. Nesses casos, você pode usar o ponto de extremidade _stats para consultar os dados. Por exemplo, para obter informações detalhadas sobre um índice chamado temp_2, use a solicitação:
GET / temp_2 / _statsVocê também pode usar cURL como:
curl -XGET “http: // localhost: 9200 / temp_2 / _stats”Um exemplo de informação estatística deve ser mostrado abaixo:
"_shards":
"total": 2,
"bem-sucedido": 2,
"falhou": 0
,
"_tudo" :
"primários":
"docs":
"contagem": 0,
"excluído": 0
,
"loja" :
"size_in_bytes": 208,
"reserved_in_bytes": 0
,
"indexação":
"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
,
"obter" :
"total": 0,
"time_in_millis": 0,
"existe_total": 0,
"existing_time_in_millis": 0,
"missing_total": 0,
"missing_time_in_millis": 0,
"atual": 0
,
-----------------------------SAÍDA TRUNCADA------------------------------
Conclusão
Neste tutorial rápido, aprendemos como usar a API Elasticsearch para obter informações sobre um ou vários índices em um cluster. Também aprendemos como filtrar dados para obter apenas os valores necessários. Você pode aprender mais verificando a API _cat e _stats.
Para mais tutoriais do Elasticsearch, pesquise no site.
Obrigado por ler.
