---
title: "Rollup 仪表板功能配置"
date: 2026-02-15
lastmod: 2026-02-15
description: "rollup.dashboards.enabled 配置项用于控制是否启用 Rollup 仪表板支持功能。"
tags: ["Rollup", "仪表板", "字段映射", "Dashboard"]
summary: "配置项作用 #  rollup.dashboards.enabled 配置项用于控制是否启用 Rollup 索引的仪表板字段映射支持。
当启用时，系统会拦截字段能力请求并重写响应，包含 Rollup 索引的字段映射信息，使 Kibana 等 Dashboard 工具能正确显示 Rollup 索引的字段类型。
配置项属性 #   配置路径: rollup.dashboards.enabled 数据类型: Boolean（布尔值） 默认值: true 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 是（可以动态更新，无需重启） 废弃状态: 已废弃  配置项详解 #  工作机制 #  字段拦截机制 启用 (true): FieldCapabilities 请求 │ ├── FieldCapsFilter 拦截 ├── 识别 Rollup 索引 ├── 添加字段映射 └── 重写响应 │ └── 包含 Rollup 字段信息 ✅ 禁用 (false): FieldCapabilities 请求 │ ├── 不拦截 └── 标准响应 │ └── 不包含 Rollup 映射 ❌ 字段映射来源 #  字段映射获取流程 1."
---


## 配置项作用

`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 使用
   ├── 显示正确的字段类型
   ├── 支持字段过滤
   └── 可视化数据
```

## 配置建议

## 生产环境（默认）

```yaml
rollup:
  dashboards:
    enabled: true  # 默认值
```

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

## 不使用 Rollup

```yaml
rollup:
  dashboards:
    enabled: false  # 禁用
```

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

## 性能优化

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

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

## 代码示例

## 基础配置

```yaml
rollup:
  dashboards:
    enabled: true
```

## 动态更新

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

## 相关配置

| 配置项 | 作用 | 默认值 |
|--------|------|--------|
| `dashboards.enabled` | Dashboard 支持 | true |

## 注意事项

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

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

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

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

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

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

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