高级配置参数 #

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

概述 #

Easysearch 配置涉及多个层级：

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

集群协调配置 #

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

选举配置 #

主节点检查配置 #

集群形成配置 #

故障检测配置 #

路由和分片分配 #

磁盘阈值配置 #

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

分片分配配置 #

重新平衡配置 #

恢复配置 #

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

索引存储配置 #

存储类型 #

事务日志配置 #

Soft Delete（软删除） #

缓存配置 #

Query Cache（查询缓存） #

Request Cache（请求缓存） #

断路器配置 #

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

搜索相关配置 #

索引配置 #

基础设置 #

索引排序 #

刷新和合并 #

合并策略 #

映射和分析配置 #

映射相关 #

分析器 #

数据管道（Ingest）配置 #

传输层配置 #

TCP 连接 #

远程集群配置 #

HTTP 层配置 #

监控配置 #

JVM 监控 #

文件系统监控 #

网关（Gateway）配置 #

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

搜索和线程池 #

线程池配置（按名称） #

线程池参数 #

安全配置 #

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

系统级别配置 #

进程和性能 #

引导参数 #

常见优化建议 #

高吞吐量集群 #

# 禁用请求缓存（如果大量不同查询）
indices.requests.cache.size: 0%

# 增大查询缓存
indices.queries.cache.size: 15%

# 调整刷新间隔
index.refresh_interval: 30s

# 增加合并线程
index.merge.scheduler.max_thread_count: 4

内存受限环境 #

# 降低缓存大小
indices.queries.cache.size: 5%
indices.requests.cache.size: 0.5%

# 启用断路器保护
indices.breaker.total.limit: 70%

# 减少刷新间隔（更多内存使用）
index.refresh_interval: 5s

# 降低合并并发
index.merge.policy.max_merge_at_once: 10

搜索优化 #

# 启用请求缓存
index.requests.cache.enable: true

# 调整搜索超时
search.default_search_timeout: 30s

# 禁用 PIT 自动清理（如需要）
search.max_open_pit_context: 1000

配置更新方法 #

从文件配置（需重启） #

编辑 config/easysearch.yml 或 config/easysearch.properties，修改后重启节点。

动态更新（推荐） #

使用集群设置 API 动态更新标记为"✓"的参数：

PUT /_cluster/settings
{
  "transient": {
    "indices.queries.cache.size": "15%",
    "index.refresh_interval": "30s"
  }
}

持久化更新（集群重启后仍生效）：

PUT /_cluster/settings
{
  "persistent": {
    "indices.queries.cache.size": "15%"
  }
}

延伸阅读 #

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