集群设置 #
「集群设置」页面用于查看和修改 Easysearch 的动态集群设置，即通过 _cluster/settings API 管理的配置项。索引模板、节点 easysearch.yml 等静态配置不在此页面范围内。
登录 Easysearch UI，在左侧导航栏点击「设置」，默认进入「集群设置」标签页。
页面按「节点」「索引」「分片」「断路器」「管道管理」「主从复制」「生命周期」「备份管理」「集群」「日志与元数据」等分组展示全部设置项，右侧为分组导航卡片，可点击快速跳转。
搜索与过滤 #
- 搜索框：支持按设置名称或 key 实时过滤（如输入
recovery或indices.recovery.max_bytes_per_sec）；点击「刷新」按钮可重新拉取集群的最新设置。
- 来源过滤：右侧下拉框可按「全部 / 临时 / 持久 / 默认」过滤，只看某一层的设置项。
查看设置的当前有效值和所有的值 #
在 Easysearch 中，一个设置项的值分为三层：
| 层 | 徽标颜色 | 说明 |
|---|---|---|
| 临时（transient） | 金色 | 集群重启后失效 |
| 持久（persistent） | 蓝色 | 持久化到 cluster state，重启后仍生效 |
| 默认（default） | 灰色 | 内置默认值，只读 |
三层取值的优先级为：临时 > 持久 > 默认。列表每一行展示设置名称、类型标签（bool、int、time、size 等）、完整 key 和当前生效值，生效值右侧的徽标标明其来源层。
点击任意一行可展开查看该设置项的全部取值：临时、持久、默认三张并排的卡片，每张卡片标注了该层的状态——「生效中」「被覆盖」或「未设置」。默认层为只读；当临时或持久层正在生效时，默认值暂不可读取，卡片显示为「—」，清除覆盖后即可见。
更改集群设置 #
- 找到要更改的设置项（可借助搜索框），点击该行展开。
- 在「临时」或「持久」卡片内输入新值。控件随设置类型自动适配：bool/enum 为下拉选择，int/float 为数字输入，list 为标签输入（逗号分隔），time/size 等需保留单位的类型为文本输入（如
60s、40mb）。未设置的卡片会以默认值作为占位提示。 - 点击「保存修改」。修改将影响集群的全部节点。
同一设置项可以在一次保存中同时修改临时层与持久层；有输入未保存时切换页面或刷新将丢失草稿。
新增动态设置项 #
部分设置的名称本身是动态的，无法枚举展示，需要先「添加」实例后才能设置值，包括：日志级别（logger.*）、分片分配属性（include/exclude/require）、断路器（breaker.*）、脚本上下文（script.context.*）等。
在对应分组标题右侧点击「添加」按钮，输入实例名称（如日志器名 org.easysearch.http 或分配属性名 zone）并填写取值即可。
清空设置的值 #
临时/持久的值都可以清空，即将该层置为 NULL：
- 清除单层：展开设置项后，点击对应卡片底部的「清除此层」链接。清除后生效值将回落到更低优先级层（持久值或默认值）。
- 清空临时：点击页面右上角的「清空临时」按钮，一键移除「临时」层的全部设置。此操作会弹出确认框，确认后生效值将集体回落到持久值或默认值，不可撤销。
所需权限 #
查看本页需要集群监控权限，修改与清空需要 cluster:admin/settings/update 权限；无权限时页面仅只读展示。