配置项作用 #
index_state_management.restricted_index_pattern 配置项用于定义不允许被索引状态管理(ISM)策略管理的索引模式。
配置项属性 #
- 配置路径:
index_state_management.restricted_index_pattern - 数据类型:
String(字符串,正则表达式模式) - 默认值:
\.easysearch_security|\.kibana.*|\\$INDEX_MANAGEMENT_INDEX - 是否可选: 是
- 作用域: NodeScope(节点级别)
- 动态更新: 是(可以动态更新,无需重启)
- 废弃状态: LegacyManagedIndexSettings 中标记为废弃,但 ManagedIndexSettings 中未废弃
配置建议 #
默认配置 #
index_state_management:
restricted_index_pattern: "\.easysearch_security|\.kibana.*|\\$INDEX_MANAGEMENT_INDEX"
自定义受限模式 #
index_state_management:
restricted_index_pattern: "\.easysearch_security|\.kibana.*|\.system.*|\\$INDEX_MANAGEMENT_INDEX"
空模式(不限制任何索引) #
index_state_management:
restricted_index_pattern: ""
默认受限索引 #
默认情况下,以下索引模式受到保护,不会被 ISM 策略管理:
.easysearch_security- Easysearch 安全相关索引.kibana.*- Kibana 相关索引$INDEX_MANAGEMENT_INDEX- ISM 管理索引本身
功能说明 #
保护机制 #
此配置通过正则表达式模式匹配来防止关键系统索引被 ISM 策略意外管理,避免以下风险:
- 系统索引被意外删除或滚动
- 关键配置数据丢失
- ISM 功能本身受到影响
模式匹配 #
- 使用正则表达式语法
- 支持多个模式,用
|分隔 - 模式区分大小写
使用建议 #
添加系统索引 #
index_state_management:
restricted_index_pattern: "\.easysearch_security|\.kibana.*|\.monitoring.*|\.alerts.*|\\$INDEX_MANAGEMENT_INDEX"
保护自定义系统索引 #
index_state_management:
restricted_index_pattern: "\.easysearch_security|\.kibana.*|\.myapp_system.*|\\$INDEX_MANAGEMENT_INDEX"
注意事项 #
动态更新: 此配置可以动态更新,无需重启节点。
安全考虑: 保持关键系统索引在受限列表中,防止被 ISM 策略误操作。
正则语法: 确保使用正确的正则表达式语法,错误可能导致意外的匹配结果。
测试验证: 在生产环境中应用前,建议在测试环境验证模式是否正确匹配预期索引。
IAM 索引: ISM 管理索引本身始终应保持在受限列表中。
备份配置: 修改此配置前,建议备份原始配置以便需要时恢复。
默认模式: 对于大多数场景,默认配置已经提供了足够的保护,无需额外修改。





