脚本编译速率限制配置

配置项作用 #

script.max_compilations_rate 配置项控制在指定时间内允许编译的脚本数量限制。此配置用于防止过多的脚本编译操作消耗过多 CPU 资源，保护系统稳定性。

配置项类型 #

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

默认值 #

use-context（根据脚本上下文自动调整）

是否必需 #

可选配置项（有默认值）

取值范围 #

- use-context（自动）或具体速率（如 10/1m）

配置格式 #

# 默认配置（自动调整）
script.max_compilations_rate: use-context

# 固定速率限制
script.max_compilations_rate: 10/1m

# 更宽松的限制
script.max_compilations_rate: 100/1m

# 无限制
script.max_compilations_rate: unlimited

相关配置项 #

工作原理 #

编译速率限制机制：

┌─────────────────────────────────────────────────────────────────┐
│                    编译速率限制                                  │
└─────────────────────────────────────────────────────────────────┘

脚本编译请求
    │
    ▼
检查编译计数
    │
    ├── use-context 模式
    │   │
    │   ├── 根据脚本上下文自动调整
    │   ├── 脚本查询 → 较宽松
    │   └── 脚本更新 → 较严格
    │
    └── 固定速率模式
        │
        └── 计算时间段内编译次数
            │
            ├── 未超过限制 → 允许编译
            └── 超过限制 → 拒绝请求

使用场景 #

1. 默认配置（推荐） #

script.max_compilations_rate: use-context

适用于大多数集群配置，自动根据场景调整。

2. 严格限制 #

script.max_compilations_rate: 10/1m

适用场景：

• 资源受限环境
• 防止脚本滥用
• 保护系统稳定性

3. 宽松限制 #

script.max_compilations_rate: 100/1m

适用场景：

• 大量脚本操作
• 脚本开发测试
• 资源充足

4. 无限制 #

script.max_compilations_rate: unlimited

适用场景：

• 受信任环境
• 需要大量编译
• 有其他保护机制

推荐设置建议 #

动态配置示例 #

# 更新集群配置
PUT /_cluster/settings
{
  "transient": {
    "script.max_compilations_rate": "50/1m"
  }
}

# 设置为无限制
PUT /_cluster/settings
{
  "transient": {
    "script.max_compilations_rate": "unlimited"
  }
}

监控建议 #

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

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

# 查看缓存状态
GET /_nodes/stats/script?filter_path=**.cache

注意事项 #

1. 动态更新：此配置为动态配置，可在线修改
2. use-context 推荐：生产环境建议使用自动模式
3. 资源保护：防止过多编译消耗 CPU
4. 与缓存配合：与编译缓存配合使用
5. 合理设置：根据脚本使用频率调整