Elasticsearch Shard List

A API cat do Elasticsearch é muito útil porque permite que os usuários visualizem informações relacionadas a vários recursos do mecanismo Elasticsearch em Compact and Aligned Text (CAT).

Este tutorial mostrará como usar a API _cat para visualizar informações sobre shards em um cluster Elasticsearch, qual nó é a réplica, o tamanho que ocupa o disco e muito mais.

Como listar todos os fragmentos em um cluster

Para visualizar todos os fragmentos em um cluster Elasticsearch, você pode usar a solicitação GE no ponto de extremidade da API _cat / shards, da seguinte maneira:

OBTER _cat / shards

Se você for um usuário cURL, use o seguinte comando:

curl -XGET “http: // localhost: 9200 / _cat / shards”

Executar o comando acima fornecerá informações sobre todos os fragmentos no cluster, conforme mostrado abaixo (saída truncada):

kibana_sample_data_flights 0 p INICIADO 13059 5.3mb 172.28.86.133 instância-0000000003
kibana_sample_data_flights 0 r INICIADO 13059 5.3mb 172.28.27.142 instância-0000000001
.slm-history-3-000001 0 p INICIADO 172.28.86.133 instância-0000000003
.slm-history-3-000001 0 r INICIADO 172.28.27.142 instância-0000000001
destination_index 0 p INICIADO 13232 5.9mb 172.28.27.142 instância-0000000001
.monitoramento-es-7-2021.01.22 0 p INICIADO 279515 153.5mb 172.28.86.133 instância-0000000003
.monitoramento-es-7-2021.01.22 0 r INICIADO 279467 268.5mb 172.28.27.142 instância-0000000001
.kibana_task_manager_1 0 p COMEÇADO 6 205.6kb 172.28.86.133 instância-0000000003
.kibana_task_manager_1 0 r INICIADO 6 871.5kb 172.28.27.142 instância-0000000001
.monitoramento-beats-7-2021.01.22 0 p INICIADO 6245 8mb 172.28.86.133 instância-0000000003
--------------------------------saída truncada---------------------

Você também pode filtrar a saída e especificar o formato do resultado. Por exemplo, para obter a saída no formato YAML, adicione o parâmetro format = yaml à solicitação, da seguinte maneira:

OBTER _cat / shards?format = yaml

O comando cURL para isso é:

curl -XGET “http: // localhost: 9200 / _cat / shards?format = yaml ”

A saída deve estar no formato YAML como:

- índice: "apm-7.10.2-onboarding-2021.01.20 "
fragmento: "0"
prirep: "p"
estado: "INICIADO"
docs: "2"
loja: "14.7kb "
ip: "172.28.27.142 "
nó: "instância-0000000001"
- índice: "source_index"
fragmento: "0"
prirep: "p"
estado: "INICIADO"
docs: "0"
loja: "208b"
ip: "172.28.86.133 "
nó: "instância-0000000003"
- índice: "kibana_sample_type_diff"
fragmento: "0"
prirep: "p"
estado: "INICIADO"
docs: "13059"
loja: "5.7 MB "
ip: "172.28.86.133 "
nó: "instância-0000000003"
- índice: "kibana_sample_type_diff"
fragmento: "0"
prirep: "r"
estado: "INICIADO"
docs: "13059"
loja: "9.8 MB "
ip: "172.28.27.142 "
nó: "instância-0000000001"
--------------------------------SAÍDA TRUNCADA---------------------

Você pode até escolher obter cabeçalhos específicos. Por exemplo, para obter o nome do índice, nome do fragmento, estado do fragmento, espaço em disco do fragmento, id do nó e IP do nó, filtre passando-os para o argumento do cabeçalho como:

OBTER _cat / shards?h = index, shard, state, store, id, ip & format = json

O comando cURL é o seguinte:

curl -XGET “http: // localhost: 9200 / _cat / shards?h = index, shard, state, store, id, ip & format = json ”

Executar o comando acima fornece informações selecionadas sobre os fragmentos no formato JSON. Ignore os parâmetros de formato para usar o formato tabular padrão.

[

"index": "kibana_sample_data_flights",
"fragmento": "0",
"state": "STARTTED",
"armazenar": "5.3 MB ",
"id": "gSlMjTKyTemoOX-EO7Em4w",
"ip": "172.28.86.133 "
,

"index": "kibana_sample_data_flights",
"fragmento": "0",
"estado": "INICIADO",
"armazenar": "5.3 MB ",
"id": "FTd_2iXjSXudN_Ua4tZhHg",
"ip": "172.28.27.142 "
,

"índice": ".slm-history-3-000001 ",
"fragmento": "0",
"estado": "INICIADO",
"store": null,
"id": "gSlMjTKyTemoOX-EO7Em4w",
"ip": "172.28.86.133 "
,

"índice": ".slm-history-3-000001 ",
"fragmento": "0",
"estado": "INICIADO",
"store": null,
"id": "FTd_2iXjSXudN_Ua4tZhHg",
"ip": "172.28.27.142 "
,

"index": "destination_index",
"fragmento": "0",
"estado": "INICIADO",
"armazenar": "5.9 MB ",
"id": "FTd_2iXjSXudN_Ua4tZhHg",
"ip": "172.28.27.142 "
,

"índice": ".monitoramento-es-7-2021.01.22 ",
"fragmento": "0",
"estado": "INICIADO",
"armazenar": "154.7 MB ",
"id": "gSlMjTKyTemoOX-EO7Em4w",
"ip": "172.28.86.133 "
,

"índice": ".monitoramento-es-7-2021.01.22 ",
"fragmento": "0",
"estado": "INICIADO",
"loja": "270.2 MB ",
"id": "FTd_2iXjSXudN_Ua4tZhHg",
"ip": "172.28.27.142 "
,
-----------------------------------SAÍDA TRUNCADA-------------------------

Informações de fragmentos para índices específicos

Para obter informações sobre um fragmento para um índice específico, passe o nome do índice da seguinte forma:

OBTER _cat / shards / kibana_sample_data_flights

Insira o comando cURL da seguinte forma:

curl -XGET “http: // localhost: 9200 / _cat / shards / kibana_sample_data_flights”

Este comando fornece informações sobre os fragmentos desse índice específico:

kibana_sample_data_flights 0 p INICIADO 13059 5.3mb 172.28.86.133 instância-0000000003
kibana_sample_data_flights 0 r INICIADO 13059 5.3mb 172.28.27.142 instância-0000000001

NOTA: Você também pode usar parâmetros para filtrar os dados acima.

Conclusão

Neste guia, mostramos como usar a API cat para obter informações sobre os shards em execução no cluster Elasticsearch.