📣 极限科技诚招搜索运维工程师(Elasticsearch/Easysearch)- 全职/北京 👉 : 立即申请加入

配置项作用 #

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 策略管理:

  1. .easysearch_security - Easysearch 安全相关索引
  2. .kibana.* - Kibana 相关索引
  3. $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"

注意事项 #

  1. 动态更新: 此配置可以动态更新,无需重启节点。

  2. 安全考虑: 保持关键系统索引在受限列表中,防止被 ISM 策略误操作。

  3. 正则语法: 确保使用正确的正则表达式语法,错误可能导致意外的匹配结果。

  4. 测试验证: 在生产环境中应用前,建议在测试环境验证模式是否正确匹配预期索引。

  5. IAM 索引: ISM 管理索引本身始终应保持在受限列表中。

  6. 备份配置: 修改此配置前,建议备份原始配置以便需要时恢复。

  7. 默认模式: 对于大多数场景,默认配置已经提供了足够的保护,无需额外修改。