resp = client.rollup.put_job(
    id="sensor",
    index_pattern="sensor-*",
    rollup_index="sensor_rollup",
    cron="*/30 * * * * ?",
    page_size=1000,
    groups={
        "date_histogram": {
            "field": "timestamp",
            "fixed_interval": "1h",
            "delay": "7d"
        },
        "terms": {
            "fields": [
                "node"
            ]
        }
    },
    metrics=[
        {
            "field": "temperature",
            "metrics": [
                "min",
                "max",
                "sum"
            ]
        },
        {
            "field": "voltage",
            "metrics": [
                "avg"
            ]
        }
    ],
)
print(resp)

const response = await client.rollup.putJob({
  id: "sensor",
  index_pattern: "sensor-*",
  rollup_index: "sensor_rollup",
  cron: "*/30 * * * * ?",
  page_size: 1000,
  groups: {
    date_histogram: {
      field: "timestamp",
      fixed_interval: "1h",
      delay: "7d",
    },
    terms: {
      fields: ["node"],
    },
  },
  metrics: [
    {
      field: "temperature",
      metrics: ["min", "max", "sum"],
    },
    {
      field: "voltage",
      metrics: ["avg"],
    },
  ],
});
console.log(response);

PUT _rollup/job/sensor
{
  "index_pattern": "sensor-*",
  "rollup_index": "sensor_rollup",
  "cron": "*/30 * * * * ?",
  "page_size": 1000,
  "groups": {
    "date_histogram": {
      "field": "timestamp",
      "fixed_interval": "1h",
      "delay": "7d"
    },
    "terms": {
      "fields": [ "node" ]
    }
  },
  "metrics": [
    {
      "field": "temperature",
      "metrics": [ "min", "max", "sum" ]
    },
    {
      "field": "voltage",
      "metrics": [ "avg" ]
    }
  ]
}

然后，我们可以通过以下命令检索该索引模式 (sensor-*) 的汇总功能

resp = client.rollup.get_rollup_caps(
    id="sensor-*",
)
print(resp)

response = client.rollup.get_rollup_caps(
  id: 'sensor-*'
)
puts response

const response = await client.rollup.getRollupCaps({
  id: "sensor-*",
});
console.log(response);

GET _rollup/data/sensor-*

这将产生以下响应

{
  "sensor-*" : {
    "rollup_jobs" : [
      {
        "job_id" : "sensor",
        "rollup_index" : "sensor_rollup",
        "index_pattern" : "sensor-*",
        "fields" : {
          "node" : [
            {
              "agg" : "terms"
            }
          ],
          "temperature" : [
            {
              "agg" : "min"
            },
            {
              "agg" : "max"
            },
            {
              "agg" : "sum"
            }
          ],
          "timestamp" : [
            {
              "agg" : "date_histogram",
              "time_zone" : "UTC",
              "fixed_interval" : "1h",
              "delay": "7d"
            }
          ],
          "voltage" : [
            {
              "agg" : "avg"
            }
          ]
        }
      }
    ]
  }
}

返回的响应包含与原始汇总配置类似的信息，但格式不同。首先，有一些内务处理详细信息：汇总作业 ID、保存汇总数据的索引以及作业所针对的索引模式。

接下来，它显示了一个字段列表，其中包含符合汇总搜索条件的数据。在这里，我们看到四个字段：node、temperature、timestamp 和 voltage。这些字段中的每一个都列出了可能的聚合。例如，您可以在 temperature 字段上使用 min、max 或 sum 聚合，但只能在 timestamp 上使用 date_histogram。

请注意，rollup_jobs 元素是一个数组；可以为单个索引或索引模式配置多个独立的作业。这些作业中的每一个可能具有不同的配置，因此 API 会返回所有可用配置的列表。

我们还可以通过向 _all 发出请求来检索相同的信息

resp = client.rollup.get_rollup_caps(
    id="_all",
)
print(resp)

response = client.rollup.get_rollup_caps(
  id: '_all'
)
puts response

const response = await client.rollup.getRollupCaps({
  id: "_all",
});
console.log(response);

GET _rollup/data/_all

但请注意，如果我们使用具体的索引名称 (sensor-1)，我们将检索不到任何汇总功能

resp = client.rollup.get_rollup_caps(
    id="sensor-1",
)
print(resp)

response = client.rollup.get_rollup_caps(
  id: 'sensor-1'
)
puts response

const response = await client.rollup.getRollupCaps({
  id: "sensor-1",
});
console.log(response);

GET _rollup/data/sensor-1

{

}

这是为什么？原始汇总作业是针对特定的索引模式 (sensor-*) 配置的，而不是具体的索引 (sensor-1)。因此，虽然该索引属于该模式，但汇总作业仅在整个模式上有效，而不仅仅是其中一个包含的索引。因此，出于这个原因，获取汇总功能 API 仅根据最初配置的索引名称或模式返回信息。

« 获取汇总作业 API 获取汇总索引功能 API »