elasticsearch7.x catAPI之shards

shards

返回节点包含的分片的详细信息，如分片在哪个节点、是否是主分片、包含的文档数、占用的磁盘空间等。shards接受一个可选的路径参数：逗号分隔的索引名列表，接受通配符表达式。除catAPI公共参数外，还支持两个参数：local和master_timout。如果local为true，则只从本地节点检索信息，默认为false，从主节点检索信息。master_timout指定连接主节点的超时时间。如果超时前没有收到响应，则请求失败并返回错误，默认为30s。可展示的信息如下：

列名	简写	默认显示 （默认否）	说明
index	i,idx	是	索引名。
shard	s,sh	是	分片名。
prirep	p,pr,primaryOrReplica	是	主分片（p）还是副本（r）。
state	st	是	分片状态，STARTED（已启动）、RELOCATING（重定位）、INITIALIZING（初始化）、UNASSIGNED（未分配）。
docs	d,dc	是	分片中的文档数。
store	sto	是	分片使用的磁盘空间。
ip		是	节点的ip地址。
node	n	是	节点名。
id			节点id。
sync_id			分片同步id。
unassigned.reason	ur		分片未分配原因，返回值见下表。
unassigned.at	ua		取消分配分片的时间（UTC）。
unassigned.for	uf		分片未分配持续时长（UTC）。
unassigned.details	ud		未分配分片的具体原因。
recoverysource.type	rs		恢复源的类型。
completion.size	cs,completionSize		自动补全占用内存大小。
fielddata.memory_size	fm,fielddataMemory		fielddata占用内存大小。
fielddata.evictions	fe,fielddataEvictions		被回收词根的个数。
query_cache.memory_size	qcm,queryCacheMemory		查询缓存占用内存大小。
query_cache.evictions	qce,queryCacheEvictions		被回收的查询缓存总数。
flush.total	ft,flushTotal		磁盘刷新次数。
flush.total_time	ftt,flushTotalTime		磁盘刷新总用时。
get.current	gc,getCurrent		当前正在执行的get操作的数量。
get.time	gti,getTime		get操作总耗时。
get.total	gto,getTotal		get操作总次数。
get.exists_time	geti,getExistsTime		命中的get操作总耗时。
get.exists_total	geto,getExistsTotal		get操作命中的总次数。
get.missing_time	gmti,getMissingTime		未命中的get操作总耗时。
get.missing_total	gmto,getMissingTotal		get操作未命中的总次数。
indexing.delete_current	idc,indexingDeleteCurrent		当前正在执行的删除操作的数量。
indexing.delete_time	idti,indexingDeleteTime		删除操作总耗时。
indexing.delete_total	idto,indexingDeleteTotal		删除操作总次数。
indexing.index_current	iic,indexingIndexCurrent		当前正在执行的索引操作的数量。
indexing.index_time	iiti,indexingIndexTime		索引操作总耗时。
indexing.index_total	iito,indexingIndexTotal		索引操作总次数。
indexing.index_failed	iif,indexingIndexFailed		索引操作失败的次数。
merges.current	mc,mergesCurrent		当前正在执行的合并操作的数量。
merges.current_docs	mcd,mergesCurrentDocs		正在合并的文档数。
merges.current_size	mcs,mergesCurrentSize		正在合并的文档大小。
merges.total	mt,mergesTotal		合并操作总次数。
merges.total_docs	mtd,mergesTotalDocs		合并操作的文档总数。
merges.total_size	mts,mergesTotalSize		合并操作的文档总大小。
merges.total_time	mtt,mergesTotalTime		合并操作的总耗时。
refresh.total	rto,refreshTotal		索引刷新总次数。
refresh.time	rti,refreshTime		索引刷新总耗时。
refresh.external_total	rto,refreshTotal		外部刷新总次数。
refresh.external_time	rti,refreshTime		外部刷线总耗时。
refresh.listeners	rli,refreshListeners		挂起的刷新监听器数量。
search.fetch_current	sfc,searchFetchCurrent		当前处于fetch阶段的操作的数量。
search.fetch_time	sfti,searchFetchTime		fetch阶段总耗时。
search.fetch_total	sfto,searchFetchTotal		fetch操作总次数。
search.open_contexts	so,searchOpenContexts		打开的查询上下文数量。
search.query_current	sqc,searchQueryCurrent		当前处于query阶段的操作的数量。
search.query_time	sqti,searchQueryTime		query阶段总耗时。
search.query_total	sqto,searchQueryTotal		query操作总次数。
search.scroll_current	scc,searchScrollCurrent		当前正在执行的scroll操作的数量。
search.scroll_time	scti,searchScrollTime		scroll操作的总耗时。
search.scroll_total	scto,searchScrollTotal		scroll操作的总次数。
segments.count	sc,segmentsCount		索引当前的段数。
segments.memory	sm,segmentsMemory		段使用内存。
segments.index_writer_memory	siwm,segmentsIndexWriterMemory		IndexWriter使用的内存。
segments.version_map_memory	svmm,segmentsVersionMapMemory		版本映射使用的内存。
segments.fixed_bitset_memory	sfbm,fixedBitsetMemory		用于嵌套对象字段类型和_parent字段中引用类型的类型过滤器的固定位集使用的内存。
seq_no.max	sqm,maxSeqNo		最大序列号。
seq_no.local_checkpoint	sql,localCheckpoint		本地检查点。
seq_no.global_checkpoint	sqg,globalCheckpoint		全局检查点。
warmer.current	wc,warmerCurrent		当前warmer操作数。
warmer.total	wto,warmerTotal		warmer操作的总数。
warmer.total_time	wtt,warmerTotalTime		warmer操作的总耗时。

未分配原因

返回值	说明
ALLOCATION_FAILED	由于分片分配失败而未分配。
CLUSTER_RECOVERED	由于完全集群恢复导致未分配。
DANGLING_INDEX_IMPORTED	由于导入悬空索引而未分配。
EXISTING_INDEX_RESTORED	由于恢复到已关闭的索引导致未分配。
INDEX_CREATED	由于创建索引的API导致未分配。
INDEX_REOPENED	由于打开已关闭索引而未分配。
NEW_INDEX_RESTORED	由于恢复到新索引导致未分配。
NODE_LEFT	由于承载该分片的节点离开集群而未分配。
REALLOCATED_REPLICA	确定了更好的副本位置，并导致取消现有的副本分配。
REINITIALIZED	当分片状态从STARTED回退到INITIALIZING导致未分配。
REPLICA_ADDED	由于显式添加副本而未分配。
REROUTE_CANCELLED	由于显式取消reroute命令导致未分配。