Rollup 仪表板功能配置

配置项作用 #

rollup.dashboards.enabled 配置项用于控制是否启用 Rollup 索引的仪表板字段映射支持。

当启用时，系统会拦截字段能力请求并重写响应，包含 Rollup 索引的字段映射信息，使 Kibana 等 Dashboard 工具能正确显示 Rollup 索引的字段类型。

配置项属性 #

• 配置路径: rollup.dashboards.enabled
• 数据类型: Boolean（布尔值）
• 默认值: true
• 是否可选: 是
• 作用域: NodeScope（节点级别）
• 动态更新: 是（可以动态更新，无需重启）
• 废弃状态: 已废弃

配置项详解 #

工作机制 #

字段拦截机制

启用 (true):
FieldCapabilities 请求
    │
    ├── FieldCapsFilter 拦截
    ├── 识别 Rollup 索引
    ├── 添加字段映射
    └── 重写响应
        │
        └── 包含 Rollup 字段信息 ✅


禁用 (false):
FieldCapabilities 请求
    │
    ├── 不拦截
    └── 标准响应
        │
        └── 不包含 Rollup 映射 ❌

字段映射来源 #

字段映射获取流程

1. 读取 Rollup 任务定义
   ├── source index
   ├── rollup fields
   └── 目标字段类型


2. 分析 source index 映射
   ├── 字段名称
   ├── 字段类型
   └── 字段属性


3. 构建字段映射
   ├── Rollup 字段 → 类型
   ├── 添加到响应
   └── Dashboard 可识别


4. Dashboard 使用
   ├── 显示正确的字段类型
   ├── 支持字段过滤
   └── 可视化数据

配置建议 #

生产环境（默认） #

rollup:
  dashboards:
    enabled: true  # 默认值

建议: 使用 Rollup 功能时保持启用。

不使用 Rollup #

rollup:
  dashboards:
    enabled: false  # 禁用

建议: 不使用 Rollup 时可以禁用。

性能优化 #

rollup:
  dashboards:
    enabled: false  # 减少开销

建议: 不需要 Dashboard 支持时可禁用。

代码示例 #

基础配置 #

rollup:
  dashboards:
    enabled: true

动态更新 #

PUT /_cluster/settings
{
  "transient": {
    "rollup.dashboards.enabled": false
  }
}

相关配置 #

注意事项 #

1. 默认值: 默认值为 true。

2. 动态更新: 可以动态更新。

3. 已废弃: 配置项已废弃。

4. Dashboard 依赖: 主要用于 Kibana 集成。

5. 性能影响: 禁用可减少少量开销。

6. 功能需求: 使用 Dashboard 查询 Rollup 数据时应启用。

7. 字段类型: 确保 Dashboard 正确显示字段类型。