高级配置参数 #

本页面详细列举 Easysearch 的所有高级配置参数，包括集群、节点、索引等多层级配置。

概述 #

Easysearch 配置涉及多个层级：

• 节点级：影响单个节点的行为（node., path., 等）
• 集群级：影响整个集群的行为（cluster., discovery., 等）
• 索引级：影响单个索引的行为（index.*, 等）
• 传输层：网络通信相关（transport., http., 等）

集群协调配置 #

集群选举、节点发现和主节点选择的相关配置。

选举配置 #

主节点检查配置 #

集群形成配置 #

故障检测配置 #

路由和分片分配 #

磁盘阈值配置 #

磁盘阈值也支持绝对字节值：1TB, 500GB 等

分片分配配置 #

重新平衡配置 #

恢复配置 #

恢复失败分片数据的相关配置。

索引存储配置 #

存储类型 #

事务日志配置 #

Soft Delete（软删除） #

缓存配置 #

Query Cache（查询缓存） #

Request Cache（请求缓存） #

断路器配置 #

断路器防止节点 OOM（内存溢出）。

搜索相关配置 #

索引配置 #

基础设置 #

索引排序 #

刷新和合并 #

合并策略 #

映射和分析配置 #

映射相关 #

分析器 #

数据管道（Ingest）配置 #

传输层配置 #

TCP 连接 #

远程集群配置 #

HTTP 层配置 #

监控配置 #

JVM 监控 #

文件系统监控 #

网关（Gateway）配置 #

网关负责节点启动时恢复分片数据。

搜索和线程池 #

线程池配置（按名称） #

线程池参数 #

安全配置 #

参考配置文件说明中的安全配置部分

系统级别配置 #

进程和性能 #

引导参数 #

调优原则 #

不存在适用于所有集群的缓存、刷新、合并或 PIT 参数组合。修改前应记录当前配置和基线指标，每次只调整一类参数，并验证查询延迟、 写入吞吐、GC、磁盘 I/O、拒绝数和恢复时间。不要通过扩大缓存、线程数、超时或 PIT 上限来掩盖容量不足或请求设计问题。

配置更新方法 #

节点级静态设置 #

没有 Dynamic 属性的 NodeScope 设置必须写入每个节点的 config/easysearch.yml，然后滚动重启节点。例如：

indices.queries.cache.size: 10%
indices.requests.cache.size: 1%

示例值是当前默认值，不是通用调优建议。修改缓存容量前必须评估堆占用和缓存命中收益。

动态集群设置 #

已注册为动态集群设置的参数可以通过集群设置 API 更新。以下命令仅演示更新方式，80mb 必须根据恢复流量、网络和磁盘能力评估：

PUT /_cluster/settings
{
  "persistent": {
    "indices.recovery.max_bytes_per_sec": "80mb"
  }
}

使用 null 删除显式配置并恢复默认值：

PUT /_cluster/settings
{
  "persistent": {
    "indices.recovery.max_bytes_per_sec": null
  }
}

动态索引设置 #

标记为动态的 IndexScope 设置必须通过目标索引的 _settings API 更新，不能写入 /_cluster/settings：

PUT /my-index/_settings
{
  "index.refresh_interval": "30s",
  "index.requests.cache.enable": false
}

静态索引设置不能作为动态设置写入已打开的索引。index.queries.cache.enabled 可在索引关闭后修改；index.sort.* 必须在创建 索引时配置，已有数据需要通过新索引重建。

延伸阅读 #

• 基础配置
• 集群配置
• JVM 配置
• 内存管理
• 日志配置