Elasticsearch开发常用命令有哪些

发布时间:2021-12-16 11:44:48 作者:小新
来源:亿速云 阅读:174

这篇文章给大家分享的是有关Elasticsearch开发常用命令有哪些的内容。小编觉得挺实用的,因此分享给大家做个参考,一起跟随小编过来看看吧。

0、背景

Elasticsearch 具有一组丰富的易于理解的 REST API,这些 API  均可如下几种方式通过 HTTP 调用进行访问。

  • Curl
  • Postman
  • head 插件
  • cerebro 工具
  • kibana

开发实战环节,我推荐使用:kibana Dev-tools。

Elasticsearch开发常用命令有哪些

原因如下:

  • 有提示功能
  • 方便快捷、效率高
  • 不容易出错
 

1、Elasticsearch REST URL 拆解

 

1.1 REST URL和选项概述

举个栗子:

POST products/_search?size=0
{
  "aggs": {
    "product_aggs": {
      "terms": {
        "field":"name.keyword"
      }
    }
  }
}
 

调用REST API很容易,除了实际的主机名/ IP和端口外,它还包含四个部分:

  • 动词——REST调用的 GET,PUT,POST和DELETE部分。

在Kibana中,您可以直接指定这些名称,对于cURL,请使用-X选项。

对应示例中的:POST

  • 路径——API和路径。

例如:/_cluster / health 或 /logstash-cron-2020.07.03/_mapping-路径的第一部分通常是索引名称,除非它以_开头。

对应示例中的:products/_search,其中products是索引。

  • 参数——后面的各种选项?

例如?h或?v

对应示例中的:?size=0。参数设定部分。

  • 正文——某些调用需要JSON正文(例如设置选项),并将包含在{}中

对应示例中的:检索语句部分。

 

1.2 常用选项

有一些通用选项适用于许多(不是全部)URL。这些是:

  • ?help——帮助选项。

将在列表中提供 API 可用的字段,其中包含短名称和长名称、说明等。

举例:

GET _cat/indices?help
 
  • ?h =-“ h”——使用上方“帮助”显示中的短名称或长名称指定要包括在结果中的字段。这些用逗号分隔,没有空格。

举例:

GET _cat/indices?h=docs.count,store.size
 

这样以后返回结果一头雾水,相当于 Excel 有 N 列字段,但没有表头一样,很痛苦!

  • ?v——'v'在回复的顶部包括字段名称。
GET _cat/indices?h=docs.count,store.size&v
 

-v 参数的妙处主要体现在:加上了表头,直观交互呈现。

  • ?s——'s'用于排序,使用列出的字段作为排序键。

如下所示:我们可能会看到节点列表。包括:返回字段名称,字段名称要显示并按名称name排序:

GET /_cat/nodes?v&h=heap.percent,diskUsedPercent,cpu,master,name&s=name
 

另外,Kibana 会将您的 Dev Tools 查询保存在 cookie 中。

有了上面的背景知识,下面的常见开发相关的常用命令清单看起来就相对容易了。

 

2、状态 & 统计相关命令清单

最有用的 API 调用通常与集群的运行状况,状态和统计信息有关,例如:

 

2.1 获取版本和集群名称等信息。

GET / 
     

2.2 获取集群健康状态等信息,包括集群名称、节点数、数据节点数、分片等的一些统计信息。

GET /_cluster/health
     

2.3 获取节点列表信息。显示了堆内存、磁盘使用情况,CPU 、负载和主机角色。

用途:用来监视负载和磁盘使用情况以及主机角色。

GET /_cat/nodes?v&h=heap.percent,diskUsedPercent,cpu,load_1m,master,name&s=name
     

2.4 Index Level 索引层面健康

GET /_cluster/health?level=indices&pretty
     

2.5 Shard Level 分片层面健康

GET /_cluster/health?level=shards&pretty
     

2.6 获取索引,文档,缓存,段,节点等的集群统计信息的更深入概述。

用途:有助于基本故障排除。

GET /_cluster/stats 
     

2.7 获取节点级别的更多统计信息,包括堆使用情况等。

GET /_nodes/stats 
     

3、线程相关状态&统计命令清单

 

3.1 很长但有用的线程队列视图

GET /_cat/thread_pool?v&h=node_name,name,type,active,size,queue,queue_size,rejected,largest,completed,min,max&s=node_name,name
     

3.2 查看热点线程,用于排查谁在占用CPU资源等

GET /_nodes/hot_threads/ 
     

3.3 快速获取索引模式。

例如:所有这些logstash *前缀索引的文档总数的方法。

GET /_cat/count/logstash*?v
     

4、索引相关状态&统计命令清单

 

4.1 通配符索引列表获取

包含:大小,文档计数,状态等。

GET /_cat/indices/logstash*?v
     

4.2 找到size 最大的索引

GET /_cat/indices/logstash-*?v&h=index,ss&s=ss:desc
     

4.3 获取状态为黄色的索引

GET /_cat/indices?v&health=yellow
 
  • 红色 red:至少一个主分片不可用。
  • 黄色 yellow:至少一个副本分片不可用。
  • 绿色 green:集群主、副本分片都可用,集群健康。
 

5、 设置相关清单

Elasticsearch中有许多设置,但最常见的是“集群”和“索引”级别。

 

5.1  集群设置

最基本的集群设置视图——显示非默认的持久性和瞬态设置信息。

GET /_cluster/settings
 

更大的列表视图——包括所有默认值,并使用平面视图使其更易于阅读。

GET /_cluster/settings?include_defaults=true&flat_settings=true
     

5.2 索引设置

获取指定索引的设置列表信息。

GET /logstash-cron-2020.08.03/_settings 
 

获取索引的元信息、设置信息以及Mapping信息。

GET /logstash-cron-2020.08.03 
     

6、 关闭&删除索引

 

6.1 关闭索引

支持单个或者模糊匹配多个索引。

POST /logstash-*-2020.03.*/_close 
     

6.2 删除索引

支持单个或者模糊匹配多个

DELETE /logstash-*-2020.04.* 
     

7、故障排查清单

之前运维清单有过陈述,开发也需要。

 

7.1 获取:已分配和未分配的分片。

GET /_cat/shards?v&h=n,index,shard,prirep,state,sto,sc,unassigned.reason,unassigned.details&s=sto,index
     

7.2 查看未分配的分片及原因

GET _cat/shards?v&h=index,shard,prirep,state,unassigned.reason&s=state 
     

7.3 查看未分配的细节说明信息

GET /_cluster/allocation/explain
     

7.4 查看指定分片未分配的细节

GET /_cluster/alloGET /_cluster/allocation/explain 
{ "index": "logstash-cloudtrail-2019.10.16", "shard": 0, "primary": true} cation/explain { "index": "logstash-cloudtrail-2019.10.16", "shard": 0, "primary": true} 
     

7.5 下线节点

PUT _cluster/settings?pretty
{
  "transient": {
    "cluster.routing.allocation.exclude._ip": "10.0.0.1"
  }
}
     

8、模板清单

 

8.1 列举已定义的所有模板

GET /_cat/templates?v&s=order,name
     

8.2 列举指定名称的模板信息

GET /_template/logstash
     

9、快照&恢复

 

9.1 列出系统中配置的快照存储库。大多数其他API调用都需要这些名称。

GET /_snapshot 
     

9.2 获取任何正在运行的快照的状态和统计信息

GET /_snapshot/_status 
     

9.3 获取快照的有用信息

GET /_cat/snapshots/my_repository?v&h=id,status,start_time,duration,indicies,successful_shards,failed_shards,total_shards
     

10、 分片分配与恢复清单

 

10.1 分片分配查看

GET /_cat/allocation?v
     

10.2 分片恢复查看

GET /_cat/recovery?v
     

10.3 运行任务查看

GET /_cat/pending_tasks?v
     

10.4 清理缓存

POST /_cache/clear

感谢各位的阅读!关于“Elasticsearch开发常用命令有哪些”这篇文章就分享到这里了,希望以上内容可以对大家有一定的帮助,让大家可以学到更多知识,如果觉得文章不错,可以把它分享出去让更多的人看到吧!

推荐阅读:
  1. Elasticsearch有什么用
  2. java开发中Git常用命令有哪些

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

elasticsearch

上一篇:如何分析Serverless 中函数计算的可观测性

下一篇:Linux sftp命令的用法是怎样的

相关阅读

您好,登录后才能下订单哦!

密码登录
登录注册
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》