内容阅读

在知识库中专注阅读，并随时返回相关工具与课程

工具 & 效率13 分钟阅读

Elasticsearch 运维命令 100 条

Elasticsearch 是分布式搜索与分析引擎。日常运维不仅要关注索引和查询，还要检查集群状态、节点、分片分配、磁盘水位、JVM、线程池、任务、索引生命周期和快照恢复。

2026年8月19日阅读—点赞—收藏—

dba100elasticsearch墨力计划

打开目录

前言

下面整理 100 条常用 REST API 与系统命令。REST 示例可直接在 Kibana Dev Tools 中执行；使用 curl 时请根据实际环境补充 HTTPS、认证和证书参数。不同版本及许可证下的 API 能力可能不同，生产执行删除索引、重路由、分片排除、快照恢复和安全配置前应确认影响范围。

一、连接与集群信息

1. 使用 curl 连接 Elasticsearch

Bash

1curl -sS --cacert /path/to/http_ca.crt \
2  -u elastic:'Replace_With_Password' \
3  https://localhost:9200/

2. 查看版本和节点名称

HTTP

1GET /

3. 查看集群健康

HTTP

1GET /_cluster/health

4. 查看集群健康摘要

HTTP

1GET /_cat/health?v

5. 查看集群统计

HTTP

1GET /_cluster/stats

6. 查看当前主节点

HTTP

1GET /_cat/master?v

7. 查看节点列表

HTTP

1GET /_cat/nodes?v&h=name,ip,node.role,master,cpu,heap.percent,ram.percent,disk.avail

8. 查看节点信息

HTTP

1GET /_nodes

9. 查看节点统计

HTTP

1GET /_nodes/stats

10. 查看已安装插件

HTTP

1GET /_cat/plugins?v

二、索引、映射与别名

11. 查看所有索引

HTTP

1GET /_cat/indices?v&s=store.size:desc

12. 创建索引

HTTP

1PUT /orders-v1
2{
3  "settings": {
4    "number_of_shards": 3,
5    "number_of_replicas": 1
6  }
7}

13. 查看索引设置

HTTP

1GET /orders-v1/_settings

14. 修改副本数

HTTP

1PUT /orders-v1/_settings
2{
3  "index.number_of_replicas": 2
4}

15. 查看映射

HTTP

1GET /orders-v1/_mapping

16. 添加字段映射

HTTP

1PUT /orders-v1/_mapping
2{
3  "properties": {
4    "status": { "type": "keyword" },
5    "order_time": { "type": "date" }
6  }
7}

17. 查看别名

HTTP

1GET /_cat/aliases?v

18. 原子切换别名

HTTP

1POST /_aliases
2{
3  "actions": [
4    { "remove": { "index": "orders-v1", "alias": "orders" } },
5    { "add":    { "index": "orders-v2", "alias": "orders" } }
6  ]
7}

19. 关闭和打开索引

HTTP

1POST /orders-v1/_close
2POST /orders-v1/_open

20. 删除索引

HTTP

1DELETE /orders-v1

删除前确认已完成快照并避免使用宽泛通配符。

三、模板与文档操作

21. 查看索引模板

HTTP

1GET /_index_template

22. 创建组件模板

HTTP

1PUT /_component_template/common-mappings
2{
3  "template": {
4    "mappings": {
5      "properties": {
6        "@timestamp": { "type": "date" }
7      }
8    }
9  }
10}

23. 创建索引模板

HTTP

1PUT /_index_template/orders-template
2{
3  "index_patterns": ["orders-*"],
4  "composed_of": ["common-mappings"],
5  "template": {
6    "settings": { "number_of_replicas": 1 }
7  }
8}

24. 模拟索引模板

HTTP

1POST /_index_template/_simulate_index/orders-2026.07

25. 写入文档

HTTP

1PUT /orders/_doc/10001
2{
3  "customer_id": 2001,
4  "amount": 99.0,
5  "status": "PAID",
6  "@timestamp": "2026-07-27T08:00:00Z"
7}

26. 批量写入文档

HTTP

1POST /_bulk
2{"index":{"_index":"orders","_id":"10002"}}
3{"customer_id":2002,"amount":199.0,"status":"NEW"}
4{"index":{"_index":"orders","_id":"10003"}}
5{"customer_id":2003,"amount":299.0,"status":"NEW"}

NDJSON 的最后一行必须保留换行。

27. 获取文档

HTTP

1GET /orders/_doc/10001

28. 更新文档

HTTP

1POST /orders/_update/10001
2{
3  "doc": { "status": "REFUNDED" }
4}

29. 删除文档

HTTP

1DELETE /orders/_doc/10001

30. 执行搜索

HTTP

1GET /orders/_search
2{
3  "query": {
4    "term": { "status": "PAID" }
5  }
6}

四、查询诊断

31. 统计文档数

HTTP

1GET /orders/_count
2{
3  "query": { "match_all": {} }
4}

32. 校验查询

HTTP

1GET /orders/_validate/query?explain=true
2{
3  "query": {
4    "match": { "description": "database" }
5  }
6}

33. 解释单个文档的评分

HTTP

1GET /orders/_explain/10001
2{
3  "query": {
4    "term": { "status": "PAID" }
5  }
6}

34. 分析分词结果

HTTP

1POST /_analyze
2{
3  "analyzer": "standard",
4  "text": "Elasticsearch database operations"
5}

35. 使用 Profile 分析查询

HTTP

1GET /orders/_search
2{
3  "profile": true,
4  "query": {
5    "term": { "status": "PAID" }
6  }
7}

Profile 开销较高，不要对生产高频查询长期启用。

36. 执行多查询

HTTP

1POST /_msearch
2{"index":"orders"}
3{"query":{"term":{"status":"PAID"}}}
4{"index":"orders"}
5{"size":0,"aggs":{"avg_amount":{"avg":{"field":"amount"}}}}

37. 查看字段能力

HTTP

1GET /orders/_field_caps?fields=*

38. 查看词条向量

HTTP

1GET /orders/_termvectors/10001
2{
3  "fields": ["description"],
4  "term_statistics": true
5}

39. 使用异步搜索

HTTP

1POST /orders/_async_search?wait_for_completion_timeout=1s
2{
3  "query": { "match_all": {} }
4}

40. 查看异步搜索结果

HTTP

1GET /_async_search/status/<async_search_id>

五、分片与分配

41. 查看分片

HTTP

1GET /_cat/shards?v&s=state,index,shard

42. 查看节点分配情况

HTTP

1GET /_cat/allocation?v

43. 解释未分配分片

HTTP

1GET /_cluster/allocation/explain
2{
3  "index": "orders-v1",
4  "shard": 0,
5  "primary": false
6}

44. 查看恢复任务

HTTP

1GET /_cat/recovery?v&active_only=true

45. 查看索引恢复详情

HTTP

1GET /orders-v1/_recovery?human

46. 查看集群动态设置

HTTP

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

47. 重试失败的分片分配

HTTP

1POST /_cluster/reroute?retry_failed=true

应先通过 Allocation Explain 排除磁盘、水位、过滤规则或副本损坏等根因。

48. 临时排除节点

HTTP

1PUT /_cluster/settings
2{
3  "persistent": {
4    "cluster.routing.allocation.exclude._name": "data-node-03"
5  }
6}

49. 清除节点排除

HTTP

1PUT /_cluster/settings
2{
3  "persistent": {
4    "cluster.routing.allocation.exclude._name": null
5  }
6}

50. 临时关闭分片分配

HTTP

1PUT /_cluster/settings
2{
3  "persistent": {
4    "cluster.routing.allocation.enable": "none"
5  }
6}

维护结束后应改回 all，不要长期关闭。

六、节点与性能

51. 查看 JVM 指标

HTTP

1GET /_nodes/stats/jvm?human

52. 查看热点线程

HTTP

1GET /_nodes/hot_threads?threads=10

53. 查看线程池

HTTP

1GET /_cat/thread_pool?v&h=node_name,name,active,queue,rejected,completed

54. 查看待处理集群任务

HTTP

1GET /_cluster/pending_tasks

55. 查看正在运行的任务

HTTP

1GET /_tasks?detailed=true&actions=*

56. 取消可取消的任务

HTTP

1POST /_tasks/<task_id>/_cancel

57. 查看断路器指标

HTTP

1GET /_nodes/stats/breaker

58. 查看字段数据内存

HTTP

1GET /_cat/fielddata?v&bytes=mb

59. 查看段信息

HTTP

1GET /_cat/segments?v

60. 清理索引缓存

HTTP

1POST /orders/_cache/clear

清理可能导致短时性能抖动，只应在明确诊断场景使用。

七、索引维护与数据迁移

61. 查看索引统计

HTTP

1GET /orders/_stats?human

62. 手动刷新索引

HTTP

1POST /orders/_refresh

63. 手动 Flush

HTTP

1POST /orders/_flush

64. 强制合并只读索引

HTTP

1POST /orders-archive/_forcemerge?max_num_segments=1

仅用于不再写入的索引，并避开业务高峰。

65. 设置索引只读

HTTP

1PUT /orders-archive/_settings
2{
3  "index.blocks.write": true
4}

66. 清除磁盘水位只读块

HTTP

1PUT /*/_settings
2{
3  "index.blocks.read_only_allow_delete": null
4}

必须先释放磁盘空间并处理水位根因。

67. 使用 Reindex 迁移数据

HTTP

1POST /_reindex?wait_for_completion=false
2{
3  "source": { "index": "orders-v1" },
4  "dest":   { "index": "orders-v2" }
5}

68. 按查询删除数据

HTTP

1POST /orders/_delete_by_query?wait_for_completion=false
2{
3  "query": {
4    "range": {
5      "@timestamp": { "lt": "now-365d" }
6    }
7  }
8}

69. 按查询更新数据

HTTP

1POST /orders/_update_by_query?wait_for_completion=false
2{
3  "script": {
4    "source": "ctx._source.status = params.s",
5    "params": { "s": "ARCHIVED" }
6  },
7  "query": { "term": { "status": "CLOSED" } }
8}

70. 执行滚动翻页查询

HTTP

1POST /orders/_search?scroll=1m
2{
3  "size": 1000,
4  "query": { "match_all": {} }
5}

大量深分页优先考虑 PIT 加 search_after；Scroll 更适合批处理。

八、ILM 与数据流

71. 查看 ILM 状态

HTTP

1GET /_ilm/status

72. 创建 ILM 策略

HTTP

1PUT /_ilm/policy/logs-policy
2{
3  "policy": {
4    "phases": {
5      "hot": {
6        "actions": {
7          "rollover": { "max_primary_shard_size": "50gb" }
8        }
9      },
10      "delete": {
11        "min_age": "30d",
12        "actions": { "delete": {} }
13      }
14    }
15  }
16}

73. 查看 ILM 策略

HTTP

1GET /_ilm/policy/logs-policy

74. 解释索引生命周期

HTTP

1GET /logs-*/_ilm/explain

75. 重试失败的 ILM 步骤

HTTP

1POST /logs-000001/_ilm/retry

76. 查看数据流

HTTP

1GET /_data_stream

77. 创建数据流

HTTP

1PUT /_data_stream/logs-app-default

创建前需要匹配的数据流索引模板。

78. 查看数据流统计

HTTP

1GET /_data_stream/logs-app-default/_stats

79. 手动执行 Rollover

HTTP

1POST /logs-app-default/_rollover

80. 删除数据流

HTTP

1DELETE /_data_stream/logs-app-default

该操作会删除数据流及其隐藏后备索引，执行前必须确认。

九、快照与恢复

81. 创建快照仓库

HTTP

1PUT /_snapshot/es-backup
2{
3  "type": "fs",
4  "settings": {
5    "location": "/mnt/es-backup",
6    "compress": true
7  }
8}

所有主节点和数据节点需正确配置并可访问 path.repo。

82. 查看快照仓库

HTTP

1GET /_snapshot

83. 校验快照仓库

HTTP

1POST /_snapshot/es-backup/_verify

84. 创建快照

HTTP

1PUT /_snapshot/es-backup/snapshot-20260727?wait_for_completion=false
2{
3  "indices": "orders-*",
4  "include_global_state": false
5}

85. 查看快照

HTTP

1GET /_cat/snapshots/es-backup?v

86. 查看快照状态

HTTP

1GET /_snapshot/es-backup/snapshot-20260727/_status

87. 恢复快照

HTTP

1POST /_snapshot/es-backup/snapshot-20260727/_restore
2{
3  "indices": "orders-*",
4  "rename_pattern": "(.+)",
5  "rename_replacement": "restore-$1",
6  "include_global_state": false
7}

88. 删除快照

HTTP

1DELETE /_snapshot/es-backup/snapshot-20260727

不要直接删除仓库目录中的文件。

89. 清理快照仓库

HTTP

1POST /_snapshot/es-backup/_cleanup

90. 查看 SLM 状态

HTTP

1GET /_slm/status

十、安全与系统巡检

91. 查看当前认证身份

HTTP

1GET /_security/_authenticate

92. 查看用户

HTTP

1GET /_security/user

93. 查看角色

HTTP

1GET /_security/role

94. 创建 API Key

HTTP

1POST /_security/api_key
2{
3  "name": "monitoring-key",
4  "role_descriptors": {
5    "monitor": {
6      "cluster": ["monitor"],
7      "indices": []
8    }
9  }
10}

API Key 仅在创建时返回明文，应立即安全保存。

95. 查看许可证

HTTP

1GET /_license

96. 查看服务状态

Bash

1systemctl status elasticsearch

容器或编排环境请改用对应的容器、Pod 和 StatefulSet 检查命令。

97. 查看 Elasticsearch 日志

Bash

1journalctl -u elasticsearch --since "30 minutes ago"

98. 检查磁盘与文件描述符

Bash

1df -h
2ulimit -n

99. 检查 vm.max_map_count

Bash

1sysctl vm.max_map_count

Linux 生产环境通常需满足 Elasticsearch 当前版本文档给出的最低要求。

100. 执行集群快速巡检

HTTP

1GET /_cluster/health
2GET /_cat/nodes?v
3GET /_cat/indices?v&s=health,index
4GET /_cat/shards?v&s=state,index
5GET /_cluster/pending_tasks
6GET /_nodes/stats/jvm,fs,thread_pool,breaker
7GET /_cat/recovery?v&active_only=true
8GET /_slm/status

建议将这些只读检查纳入监控，并重点跟踪集群状态、未分配分片、磁盘水位、JVM 压力、拒绝任务、快照失败和证书有效期。

结语

Elasticsearch 运维应先看集群健康，再沿着节点、索引、分片、任务和资源指标逐层定位。删除、迁移、重路由和恢复类 API 的影响范围较大，生产操作前应保留快照、限制目标并准备回退方案。

DBA 实战课程系统学习 Oracle DBA查看完整课程

Elasticsearch 运维命令 100 条 - DBA 学习之路