脚本缓存过期时间配置

配置项作用 #

script.cache.expire 配置项控制已编译脚本缓存的过期时间。缓存的脚本在指定时间内没有被访问后将被标记为过期，可以被新的编译脚本替换。

配置项类型 #

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

默认值 #

0ms（不自动过期）

是否必需 #

可选配置项（有默认值）

取值范围 #

0 ~ 正无穷（0 表示不自动过期）

配置格式 #

# 默认配置（不自动过期）
script.cache.expire: 0ms

# 设置过期时间
script.cache.expire: 10m

# 快速过期
script.cache.expire: 1m

# 长时间保持
script.cache.expire: 1h

相关配置项 #

工作原理 #

缓存过期机制：

┌─────────────────────────────────────────────────────────────────┐
│                    缓存过期机制                                    │
└─────────────────────────────────────────────────────────────────┘

脚本编译并缓存
    │
    ├── 记录最后访问时间
    │
    └── 定期检查缓存
         │
         ├── 当前时间 - 最后访问时间 >= cache.expire
         │   │
         │   └── 标记为可驱逐
         │       │
         │       └── 需要时编译的新脚本可占用缓存槽位
         │
         └── 当前时间 - 最后访问时间 < cache.expire
             │
             └── 保持缓存

使用场景 #

1. 默认配置（推荐） #

script.cache.expire: 0ms

适用场景：

• 大多数集群配置
• 脚本长期有效
• 不需要过期清理

2定期刷新 #

script.cache.expire: 1h

适用场景：

• 脚本可能更新
• 定期重新编译
• 保持缓存新鲜度

3. 快速过期 #

script.cache.expire: 5m

适用场景：

• 脚本频繁变化
• 需要快速更新
• 不关心编译开销

4. 长期保持 #

script.cache.expire: 24h

适用场景：

• 脚本很少变化
• 最大化缓存效果
• 减少重新编译

推荐设置建议 #

监控建议 #

# 查看当前配置
GET /_cluster/settings?filter_path=*.script.cache.expire

# 查看脚本统计
GET /_nodes/stats/script?filter_path=**.cache

动态配置示例 #

# 更新集群配置
PUT /_cluster/settings
{
  "transient": {
    "script.cache.expire": "10m"
  }
}

注意事项 #

1. 动态更新：此配置为动态配置，可在线修改
2. 默认不过期：默认 0ms 表示不自动过期
3. 与 max_size 配合：过期时间影响缓存利用率
4. 编译开销：频繁过期会增加编译开销
5. 合理设置：根据脚本变化频率调整