分片恢复内部操作超时配置

配置项作用 #

indices.recovery.internal_action_timeout 配置项控制分片恢复过程中内部操作的超时时间。这是恢复过程中各个阶段的默认超时时间。

配置项类型 #

该配置项为动态配置，可以在运行时通过集群设置 API 进行修改。

默认值 #

15m

是否必需 #

可选配置项（有默认值）

取值范围 #

0 ~ 正无穷

配置格式 #

# 默认配置
indices.recovery.internal_action_timeout: 15m

# 增加超时时间
indices.recovery.internal_action_timeout: 30m

# 减少超时时间
indices.recovery.internal_action_timeout: 10m

# 快速失败
indices.recovery.internal_action_timeout: 5m

相关配置项 #

工作原理 #

内部操作超时机制：

┌─────────────────────────────────────────────────────────────────┐
│                    恢复操作超时                                  │
└─────────────────────────────────────────────────────────────────┘

恢复操作开始
    │
    ├── 阶段 1: 准备
    ├── 阶段 2: 传输文件
    ├── 阶段 3: 验证
    └── 阶段 4: 完成
         │
         └── 每个阶段都有 internal_action_timeout
              │
              ├── 操作完成
              │
              └── 操作超时
                   │
                   └── 放弃恢复，标记失败

使用场景 #

1. 默认配置（推荐） #

indices.recovery.internal_action_timeout: 15m

适用于大多数集群配置。

2. 大分片恢复 #

indices.recovery.internal_action_timeout: 30m

适用场景：

• 大型分片
• 慢速网络
• 大量数据传输

3. 快速失败场景 #

indices.recovery.internal_action_timeout: 5m

适用场景：

• 快速检测问题
• 不希望长时间等待
• 有自动重试机制

4. 高延迟网络 #

indices.recovery.internal_action_timeout: 45m
indices.recovery.max_bytes_per_sec: 10mb

适用场景：

• 跨地域恢复
• 低带宽网络
• 容忍长传输时间

推荐设置建议 #

动态配置示例 #

# 更新集群配置
PUT /_cluster/settings
{
  "transient": {
    "indices.recovery.internal_action_timeout": "30m"
  }
}

监控建议 #

# 查看恢复进度
GET /_cat/recovery?v&h=i,s,t,bytes_percent,stage

# 查看恢复详情
GET /_cat/recovery?v&active_only=true

# 查看超时配置
GET /_cluster/settings?filter_path=*.recovery.internal_action_timeout

故障排查 #

恢复超时 #

1. 检查网络带宽
2. 检查分片大小
3. 增加超时时间
4. 减少并发恢复

恢复速度慢 #

1. 检查 max_bytes_per_sec 配置
2. 检查网络连接
3. 检查磁盘 I/O

注意事项 #

1. 动态更新：此配置为动态配置，可在线修改
2. 涵盖多个阶段：适用于恢复过程的多个阶段
3. 与分片大小相关：大分片需要更长超时
4. 与网络带宽相关：低带宽需要更长超时
5. 与 long_timeout 配合：长操作使用 long_timeout