- Elasticsearch 指南其他版本
- 8.17 中的新功能
- Elasticsearch 基础
- 快速入门
- 设置 Elasticsearch
- 升级 Elasticsearch
- 索引模块
- 映射
- 文本分析
- 索引模板
- 数据流
- 摄取管道
- 别名
- 搜索您的数据
- 重新排名
- 查询 DSL
- 聚合
- 地理空间分析
- 连接器
- EQL
- ES|QL
- SQL
- 脚本
- 数据管理
- 自动缩放
- 监视集群
- 汇总或转换数据
- 设置高可用性集群
- 快照和还原
- 保护 Elastic Stack 的安全
- Watcher
- 命令行工具
- elasticsearch-certgen
- elasticsearch-certutil
- elasticsearch-create-enrollment-token
- elasticsearch-croneval
- elasticsearch-keystore
- elasticsearch-node
- elasticsearch-reconfigure-node
- elasticsearch-reset-password
- elasticsearch-saml-metadata
- elasticsearch-service-tokens
- elasticsearch-setup-passwords
- elasticsearch-shard
- elasticsearch-syskeygen
- elasticsearch-users
- 优化
- 故障排除
- 修复常见的集群问题
- 诊断未分配的分片
- 向系统中添加丢失的层
- 允许 Elasticsearch 在系统中分配数据
- 允许 Elasticsearch 分配索引
- 索引将索引分配过滤器与数据层节点角色混合,以在数据层之间移动
- 没有足够的节点来分配所有分片副本
- 单个节点上索引的分片总数已超过
- 每个节点的分片总数已达到
- 故障排除损坏
- 修复磁盘空间不足的数据节点
- 修复磁盘空间不足的主节点
- 修复磁盘空间不足的其他角色节点
- 启动索引生命周期管理
- 启动快照生命周期管理
- 从快照恢复
- 故障排除损坏的存储库
- 解决重复的快照策略失败问题
- 故障排除不稳定的集群
- 故障排除发现
- 故障排除监控
- 故障排除转换
- 故障排除 Watcher
- 故障排除搜索
- 故障排除分片容量健康问题
- 故障排除不平衡的集群
- 捕获诊断信息
- REST API
- API 约定
- 通用选项
- REST API 兼容性
- 自动缩放 API
- 行为分析 API
- 紧凑和对齐文本 (CAT) API
- 集群 API
- 跨集群复制 API
- 连接器 API
- 数据流 API
- 文档 API
- 丰富 API
- EQL API
- ES|QL API
- 功能 API
- Fleet API
- 图表探索 API
- 索引 API
- 别名是否存在
- 别名
- 分析
- 分析索引磁盘使用量
- 清除缓存
- 克隆索引
- 关闭索引
- 创建索引
- 创建或更新别名
- 创建或更新组件模板
- 创建或更新索引模板
- 创建或更新索引模板(旧版)
- 删除组件模板
- 删除悬挂索引
- 删除别名
- 删除索引
- 删除索引模板
- 删除索引模板(旧版)
- 存在
- 字段使用情况统计信息
- 刷新
- 强制合并
- 获取别名
- 获取组件模板
- 获取字段映射
- 获取索引
- 获取索引设置
- 获取索引模板
- 获取索引模板(旧版)
- 获取映射
- 导入悬挂索引
- 索引恢复
- 索引段
- 索引分片存储
- 索引统计信息
- 索引模板是否存在(旧版)
- 列出悬挂索引
- 打开索引
- 刷新
- 解析索引
- 解析集群
- 翻转
- 收缩索引
- 模拟索引
- 模拟模板
- 拆分索引
- 解冻索引
- 更新索引设置
- 更新映射
- 索引生命周期管理 API
- 推理 API
- 信息 API
- 摄取 API
- 许可 API
- Logstash API
- 机器学习 API
- 机器学习异常检测 API
- 机器学习数据帧分析 API
- 机器学习训练模型 API
- 迁移 API
- 节点生命周期 API
- 查询规则 API
- 重新加载搜索分析器 API
- 存储库计量 API
- 汇总 API
- 根 API
- 脚本 API
- 搜索 API
- 搜索应用程序 API
- 可搜索快照 API
- 安全 API
- 身份验证
- 更改密码
- 清除缓存
- 清除角色缓存
- 清除权限缓存
- 清除 API 密钥缓存
- 清除服务帐户令牌缓存
- 创建 API 密钥
- 创建或更新应用程序权限
- 创建或更新角色映射
- 创建或更新角色
- 批量创建或更新角色 API
- 批量删除角色 API
- 创建或更新用户
- 创建服务帐户令牌
- 委托 PKI 身份验证
- 删除应用程序权限
- 删除角色映射
- 删除角色
- 删除服务帐户令牌
- 删除用户
- 禁用用户
- 启用用户
- 注册 Kibana
- 注册节点
- 获取 API 密钥信息
- 获取应用程序权限
- 获取内置权限
- 获取角色映射
- 获取角色
- 查询角色
- 获取服务帐户
- 获取服务帐户凭据
- 获取安全设置
- 获取令牌
- 获取用户权限
- 获取用户
- 授予 API 密钥
- 具有权限
- 使 API 密钥失效
- 使令牌失效
- OpenID Connect 准备身份验证
- OpenID Connect 身份验证
- OpenID Connect 注销
- 查询 API 密钥信息
- 查询用户
- 更新 API 密钥
- 更新安全设置
- 批量更新 API 密钥
- SAML 准备身份验证
- SAML 身份验证
- SAML 注销
- SAML 失效
- SAML 完成注销
- SAML 服务提供商元数据
- SSL 证书
- 激活用户配置文件
- 禁用用户配置文件
- 启用用户配置文件
- 获取用户配置文件
- 建议用户配置文件
- 更新用户配置文件数据
- 具有用户配置文件权限
- 创建跨集群 API 密钥
- 更新跨集群 API 密钥
- 快照和还原 API
- 快照生命周期管理 API
- SQL API
- 同义词 API
- 文本结构 API
- 转换 API
- 使用情况 API
- Watcher API
- 定义
- 迁移指南
- 发行说明
- Elasticsearch 版本 8.17.0
- Elasticsearch 版本 8.16.1
- Elasticsearch 版本 8.16.0
- Elasticsearch 版本 8.15.5
- Elasticsearch 版本 8.15.4
- Elasticsearch 版本 8.15.3
- Elasticsearch 版本 8.15.2
- Elasticsearch 版本 8.15.1
- Elasticsearch 版本 8.15.0
- Elasticsearch 版本 8.14.3
- Elasticsearch 版本 8.14.2
- Elasticsearch 版本 8.14.1
- Elasticsearch 版本 8.14.0
- Elasticsearch 版本 8.13.4
- Elasticsearch 版本 8.13.3
- Elasticsearch 版本 8.13.2
- Elasticsearch 版本 8.13.1
- Elasticsearch 版本 8.13.0
- Elasticsearch 版本 8.12.2
- Elasticsearch 版本 8.12.1
- Elasticsearch 版本 8.12.0
- Elasticsearch 版本 8.11.4
- Elasticsearch 版本 8.11.3
- Elasticsearch 版本 8.11.2
- Elasticsearch 版本 8.11.1
- Elasticsearch 版本 8.11.0
- Elasticsearch 版本 8.10.4
- Elasticsearch 版本 8.10.3
- Elasticsearch 版本 8.10.2
- Elasticsearch 版本 8.10.1
- Elasticsearch 版本 8.10.0
- Elasticsearch 版本 8.9.2
- Elasticsearch 版本 8.9.1
- Elasticsearch 版本 8.9.0
- Elasticsearch 版本 8.8.2
- Elasticsearch 版本 8.8.1
- Elasticsearch 版本 8.8.0
- Elasticsearch 版本 8.7.1
- Elasticsearch 版本 8.7.0
- Elasticsearch 版本 8.6.2
- Elasticsearch 版本 8.6.1
- Elasticsearch 版本 8.6.0
- Elasticsearch 版本 8.5.3
- Elasticsearch 版本 8.5.2
- Elasticsearch 版本 8.5.1
- Elasticsearch 版本 8.5.0
- Elasticsearch 版本 8.4.3
- Elasticsearch 版本 8.4.2
- Elasticsearch 版本 8.4.1
- Elasticsearch 版本 8.4.0
- Elasticsearch 版本 8.3.3
- Elasticsearch 版本 8.3.2
- Elasticsearch 版本 8.3.1
- Elasticsearch 版本 8.3.0
- Elasticsearch 版本 8.2.3
- Elasticsearch 版本 8.2.2
- Elasticsearch 版本 8.2.1
- Elasticsearch 版本 8.2.0
- Elasticsearch 版本 8.1.3
- Elasticsearch 版本 8.1.2
- Elasticsearch 版本 8.1.1
- Elasticsearch 版本 8.1.0
- Elasticsearch 版本 8.0.1
- Elasticsearch 版本 8.0.0
- Elasticsearch 版本 8.0.0-rc2
- Elasticsearch 版本 8.0.0-rc1
- Elasticsearch 版本 8.0.0-beta1
- Elasticsearch 版本 8.0.0-alpha2
- Elasticsearch 版本 8.0.0-alpha1
- 依赖项和版本
完整集群重启和滚动重启
编辑完整集群重启和滚动重启
编辑在某些情况下,您可能需要执行完整集群重启或滚动重启。 完整集群重启是指关闭并重启集群中的所有节点,而滚动重启是指一次仅关闭一个节点,从而保持服务不中断。
超出低水位阈值的节点重启速度会很慢。 在重启节点之前,将磁盘使用率降低到低水位以下。
完整集群重启
编辑-
禁用分片分配。
当您关闭一个数据节点时,分配过程会等待
index.unassigned.node_left.delayed_timeout
(默认情况下为一分钟),然后开始将该节点上的分片复制到集群中的其他节点,这可能涉及大量的 I/O。 由于该节点很快将被重启,因此这种 I/O 是不必要的。 您可以通过在关闭数据节点之前禁用副本的分配来避免争夺时间。resp = client.cluster.put_settings( persistent={ "cluster.routing.allocation.enable": "primaries" }, ) print(resp)
response = client.cluster.put_settings( body: { persistent: { 'cluster.routing.allocation.enable' => 'primaries' } } ) puts response
const response = await client.cluster.putSettings({ persistent: { "cluster.routing.allocation.enable": "primaries", }, }); console.log(response);
PUT _cluster/settings { "persistent": { "cluster.routing.allocation.enable": "primaries" } }
-
停止索引并执行刷新。
执行刷新可以加快分片恢复。
resp = client.indices.flush() print(resp)
response = client.indices.flush puts response
const response = await client.indices.flush(); console.log(response);
POST /_flush
-
临时停止与活动机器学习作业和数据源相关的任务。 (可选)
机器学习功能需要特定的订阅。
当您关闭集群时,有两种选择来处理机器学习作业和数据源
-
使用设置升级模式 API 临时停止与机器学习作业和数据源相关的任务,并阻止新作业打开
resp = client.ml.set_upgrade_mode( enabled=True, ) print(resp)
response = client.ml.set_upgrade_mode( enabled: true ) puts response
const response = await client.ml.setUpgradeMode({ enabled: "true", }); console.log(response);
POST _ml/set_upgrade_mode?enabled=true
当您禁用升级模式时,作业会使用自动保存的最后一个模型状态恢复。 此选项避免了在关闭期间管理活动作业的开销,并且比显式停止数据源和关闭作业更快。
- 停止所有数据源并关闭所有作业。 此选项会在关闭时保存模型状态。 当您在集群重启后重新打开作业时,它们将使用完全相同的模型。 但是,保存最新的模型状态比使用升级模式花费的时间更长,特别是当您有大量作业或具有大型模型状态的作业时。
-
-
关闭所有节点。
-
如果您正在使用
systemd
运行 Elasticsearchsudo systemctl stop elasticsearch.service
-
如果您正在使用 SysV
init
运行 Elasticsearchsudo -i service elasticsearch stop
-
如果您正在将 Elasticsearch 作为守护程序运行
kill $(cat pid)
-
- 执行任何需要的更改。
-
重启节点。
如果您有专用的主节点,请先启动它们,并等待它们形成一个集群并选举一个主节点,然后再继续处理您的数据节点。 您可以通过查看日志来检查进度。
一旦足够多的符合主节点条件的节点相互发现,它们就会形成一个集群并选举一个主节点。 此时,您可以使用cat health和cat nodes API 来监视节点加入集群的情况
resp = client.cat.health() print(resp) resp1 = client.cat.nodes() print(resp1)
response = client.cat.health puts response response = client.cat.nodes puts response
const response = await client.cat.health(); console.log(response); const response1 = await client.cat.nodes(); console.log(response1);
GET _cat/health GET _cat/nodes
_cat/health
返回的status
列显示集群中每个节点的运行状况:red
、yellow
或green
。 -
等待所有节点加入集群并报告黄色状态。
当一个节点加入集群时,它会开始恢复本地存储的任何主分片。
_cat/health
API 最初报告的status
为red
,表示并非所有主分片都已分配。一旦节点恢复其本地分片,集群
status
就会切换为yellow
,表示所有主分片都已恢复,但并非所有副本分片都已分配。 这是意料之中的,因为您尚未重新启用分配。 将副本的分配延迟到所有节点都为yellow
时,允许主节点将副本分配给已经具有本地分片副本的节点。 -
重新启用分配。
当所有节点都已加入集群并恢复其主分片后,通过将
cluster.routing.allocation.enable
恢复为其默认值来重新启用分配resp = client.cluster.put_settings( persistent={ "cluster.routing.allocation.enable": None }, ) print(resp)
response = client.cluster.put_settings( body: { persistent: { 'cluster.routing.allocation.enable' => nil } } ) puts response
const response = await client.cluster.putSettings({ persistent: { "cluster.routing.allocation.enable": null, }, }); console.log(response);
PUT _cluster/settings { "persistent": { "cluster.routing.allocation.enable": null } }
重新启用分配后,集群开始将副本分片分配给数据节点。 此时,可以安全地恢复索引和搜索,但是如果您可以等到所有主分片和副本分片都已成功分配,并且所有节点的状态都为
green
,则您的集群将恢复得更快。您可以使用
_cat/health
和_cat/recovery
API 监视进度resp = client.cat.health() print(resp) resp1 = client.cat.recovery() print(resp1)
response = client.cat.health puts response response = client.cat.recovery puts response
const response = await client.cat.health(); console.log(response); const response1 = await client.cat.recovery(); console.log(response1);
GET _cat/health GET _cat/recovery
-
重启机器学习作业。 (可选)
如果您临时停止了与机器学习作业相关的任务,请使用 设置升级模式 API 将其恢复为活动状态
resp = client.ml.set_upgrade_mode( enabled=False, ) print(resp)
response = client.ml.set_upgrade_mode( enabled: false ) puts response
const response = await client.ml.setUpgradeMode({ enabled: "false", }); console.log(response);
POST _ml/set_upgrade_mode?enabled=false
如果您在停止节点之前关闭了所有机器学习作业,请从 Kibana 或使用 打开作业 和 启动数据源 API 打开作业并启动数据源。
滚动重启
编辑-
禁用分片分配。
当您关闭一个数据节点时,分配过程会等待
index.unassigned.node_left.delayed_timeout
(默认情况下为一分钟),然后开始将该节点上的分片复制到集群中的其他节点,这可能涉及大量的 I/O。 由于该节点很快将被重启,因此这种 I/O 是不必要的。 您可以通过在关闭数据节点之前禁用副本的分配来避免争夺时间。resp = client.cluster.put_settings( persistent={ "cluster.routing.allocation.enable": "primaries" }, ) print(resp)
response = client.cluster.put_settings( body: { persistent: { 'cluster.routing.allocation.enable' => 'primaries' } } ) puts response
const response = await client.cluster.putSettings({ persistent: { "cluster.routing.allocation.enable": "primaries", }, }); console.log(response);
PUT _cluster/settings { "persistent": { "cluster.routing.allocation.enable": "primaries" } }
-
停止非必要的索引并执行刷新。 (可选)
虽然您可以在滚动重启期间继续索引,但如果您临时停止非必要的索引并执行刷新,则分片恢复会更快。
resp = client.indices.flush() print(resp)
response = client.indices.flush puts response
const response = await client.indices.flush(); console.log(response);
POST /_flush
-
临时停止与活动机器学习作业和数据源相关的任务。 (可选)
机器学习功能需要特定的订阅。
当您关闭集群时,有两种选择来处理机器学习作业和数据源
-
使用设置升级模式 API 临时停止与机器学习作业和数据源相关的任务,并阻止新作业打开
resp = client.ml.set_upgrade_mode( enabled=True, ) print(resp)
response = client.ml.set_upgrade_mode( enabled: true ) puts response
const response = await client.ml.setUpgradeMode({ enabled: "true", }); console.log(response);
POST _ml/set_upgrade_mode?enabled=true
当您禁用升级模式时,作业会使用自动保存的最后一个模型状态恢复。 此选项避免了在关闭期间管理活动作业的开销,并且比显式停止数据源和关闭作业更快。
- 停止所有数据源并关闭所有作业。 此选项会在关闭时保存模型状态。 当您在集群重启后重新打开作业时,它们将使用完全相同的模型。 但是,保存最新的模型状态比使用升级模式花费的时间更长,特别是当您有大量作业或具有大型模型状态的作业时。
- 如果您执行滚动重启,您还可以让机器学习作业运行。 当您关闭一个机器学习节点时,其作业会自动移动到另一个节点并恢复模型状态。 此选项使您的作业在关闭期间可以继续运行,但会增加集群的负载。
-
-
在滚动重启的情况下,关闭单个节点。
-
如果您正在使用
systemd
运行 Elasticsearchsudo systemctl stop elasticsearch.service
-
如果您正在使用 SysV
init
运行 Elasticsearchsudo -i service elasticsearch stop
-
如果您正在将 Elasticsearch 作为守护程序运行
kill $(cat pid)
-
- 执行任何需要的更改。
-
重启您更改的节点。
启动节点,并通过检查日志文件或提交
_cat/nodes
请求来确认其已加入集群resp = client.cat.nodes() print(resp)
response = client.cat.nodes puts response
const response = await client.cat.nodes(); console.log(response);
GET _cat/nodes
-
重新启用分片分配。
对于数据节点,一旦节点加入集群,请删除
cluster.routing.allocation.enable
设置以启用分片分配并开始使用该节点resp = client.cluster.put_settings( persistent={ "cluster.routing.allocation.enable": None }, ) print(resp)
response = client.cluster.put_settings( body: { persistent: { 'cluster.routing.allocation.enable' => nil } } ) puts response
const response = await client.cluster.putSettings({ persistent: { "cluster.routing.allocation.enable": null, }, }); console.log(response);
PUT _cluster/settings { "persistent": { "cluster.routing.allocation.enable": null } }
-
在滚动重启的情况下重复。
当节点恢复并且集群稳定后,对每个需要更改的节点重复这些步骤。
-
重启机器学习作业。 (可选)
如果您临时停止了与机器学习作业相关的任务,请使用 设置升级模式 API 将其恢复为活动状态
resp = client.ml.set_upgrade_mode( enabled=False, ) print(resp)
response = client.ml.set_upgrade_mode( enabled: false ) puts response
const response = await client.ml.setUpgradeMode({ enabled: "false", }); console.log(response);
POST _ml/set_upgrade_mode?enabled=false
如果您在停止节点之前关闭了所有机器学习作业,请从 Kibana 或使用 打开作业 和 启动数据源 API 打开作业并启动数据源。