时间点最大保持活跃时间配置

配置项概述 #

point_in_time.max_keep_alive 配置项控制时间点（Point In Time，PIT）上下文的最大保持活跃时间限制。

配置说明 #

point_in_time.max_keep_alive #

配置项作用：控制 PIT 上下文的最大保持活跃时间。客户端创建 PIT 时指定的 keep_alive 值不能超过此限制。

默认值：24h

配置类型：动态配置

取值范围：任何正数时间值（如 1h, 12h, 7d 等）

配置格式：

# 默认配置
point_in_time.max_keep_alive: 24h

# 增加最大保持时间
point_in_time.max_keep_alive: 48h

# 减少最大保持时间
point_in_time.max_keep_alive: 12h

使用场景 #

默认配置 #

# 默认 24 小时
point_in_time.max_keep_alive: 24h

适用场景：

• 一般生产环境
• 平衡资源使用和灵活性

延长最大时间 #

# 延长到 48 小时
point_in_time.max_keep_alive: 48h

适用场景：

• 长时间运行的批处理任务
• 跨天数据处理
• 复杂的滚动导出

缩短最大时间 #

# 缩短到 1 小时
point_in_time.max_keep_alive: 1h

适用场景：

• 资源严格受限环境
• 强制及时释放资源
• 高频 PIT 创建场景

限制机制 #

超过限制的请求 #

# 尝试创建超过最大限制的 PIT
POST /my-index/_pit?keep_alive=72h

# 返回错误
{
  "error": {
    "type": "illegal_argument_exception",
    "reason": "the keep_alive time for a pit must be less than or equal to [86400000ms] but was [259200000ms]"
  }
}

合法的请求 #

# 在限制范围内
POST /my-index/_pit?keep_alive=1h

推荐配置 #

默认配置 #

point_in_time.max_keep_alive: 24h

资源受限环境 #

point_in_time.max_keep_alive: 1h

长时间任务环境 #

point_in_time.max_keep_alive: 48h

配置关系 #

┌─────────────────────────────────────────────────────────────────┐
│                    PIT 保持活跃时间层级                           │
└─────────────────────────────────────────────────────────────────┘

客户端请求值
    │
    ├── 必须 ≤ point_in_time.max_keep_alive (24h)
    │
    ├── 未指定时使用 point_in_time.init.keep_alive (30s)
    │
    └── 超过限制则请求被拒绝

注意事项 #

1. 动态配置：可动态更新，无需重启
2. 硬限制：客户端无法超过此限制
3. 内存管理：PIT 上下文占用堆内存
4. 定期清理：及时删除不需要的 PIT
5. 监控使用：关注 PIT 上下文数量