简介
rollover API 使你可以根据索引大小，文档数或使用期限自动过渡到新索引。 当 rollover 触发后，将创建新索引，写别名（write alias) 将更新为指向新索引，所有后续更新都将写入新索引。
对于基于时间的 rollover 来说，基于大小，文档数或使用期限过渡至新索引是比较适合的。 在任意时间 rollover 通常会导致许多小的索引，这可能会对性能和资源使用产生负面影响。
Rollover历史数据：
- 在大多数情况下，无限期保留历史数据是不可行的
- 时间序列数据随着时间的流逝而失去价值，我们最终不得不将其删除
- 但是其中一些数据对于分析仍然非常有用
- Elasticsearch 6.3 引入了一项新的 rollover 功能，该功能
- 以紧凑的聚合格式保存旧数据
- 仅保存您感兴趣的数据
就像上面的图片看到的那样，我们定义了一个叫做 logs-alias 的alias，对于写操作来说，它总是会自动指向最新的可以用于写入index 的一个索引。针对我们上面的情况，它指向 logs-000002。如果新的 rollover 发生后，新的 logs-000003 将被生成，并对于写操作来说，它自动指向最新生产的 logs-000003 索引。而对于读写操作来说，它将同时指向最先的 logs-1，logs-000002 及 logs-000003。在这里我们需要注意的是：在我们最早设定 index 名字时，最后的一个字符必须是数字，比如我们上面显示的 logs-1。否则，自动生产 index 将会失败。
实例分享
我们还是先拿一个 rollover 的例子来说明，这样比较清楚。首先我们定义一个 log-alias 的 alias:
代码语言：javascript复制PUT /
{
"aliases": {
"log_alias": {
"is_write_index": true
}
}
} 如果大家对于上面的字符串 “
{
"acknowledged":true,
"shards_acknowledged":true,
"index":"logs-2019.10.21-1"
}显然，它帮我们生产了一个叫做 logs-2019.10.21-1 的 index。接下来，我们先使用我们的 Kibana 来准备一下我们的 index 数据。我们运行起来我们的 Kibana:
我们分别点击上面的1和2处
点击上面的 “Add data”。这样我们就可以把我们的 kibana_sample_data_logs 索引加载到 Elasticsearch 中。我们可以通过如下的命令进行查看：
命令显示结果为：
代码语言：javascript复制green open kibana_sample_data_logs ZbiojIYZSPCX0vJn_VOsGg 1 0 14074 0 10.7mb 10.7mb它显示 kibana_sample_data_logs 具有 11.1M 的数据，并且它有 14074 个文档
我们接下来运行如下的命令：
代码语言：javascript复制POST _reindex
{
"source": {
"index": "kibana_sample_data_logs"
},
"dest": {
"index": "log_alias"
}
}这个命令的作用是把 kibana_sample_data_logs 里的数据 reindex 到 log_alias 所指向的 index。也就是把 kibana_sample_data_logs 的文档复制一份到我们上面显示的 logs-2019.10.21-1 索引里。我们做如下的操作查看一下结果：
代码语言：javascript复制GET logs-2019.10.21-1/_count
结果：
{
"count":14074,
"_shards":{
"total":1,
"successful":1,
"skipped":0,
"failed":0
}
}显然，我们已经复制到所有的数据。那么接下来，我们来运行如下的一个指令：
代码语言：javascript复制POST /log_alias/_rollover?dry_run
{
"conditions": {
"max_age": "7d",
"max_docs": 14000,
"max_size": "5gb"
}
}在这里，我们定义了三个条件：
- 如果时间超过7天，那么自动 rollover，也就是使用新的 index
- 如果文档的数目超过 14000 个，那么自动 rollover
- 如果 index 的大小超过 5G，那么自动 rollover
在上面我们使用了 dry_run 参数，表明就是运行时看看，但不是真正地实施。显示的结果是：
代码语言：javascript复制{
"acknowledged":false,
"shards_acknowledged":false,
"old_index":"logs-2019.10.21-1",
"new_index":"logs-2019.10.21-000002",
"rolled_over":false,
"dry_run":true,
"conditions":{
"[max_docs: 1400]":true,
"[max_size: 5gb]":false,
"[max_age: 7d]":false
}
}根据目前我们的条件，我们的 logs-2019.10.21-1 文档数已经超过 14000 个了，所以会生产新的索引 logs-2019.10.21-000002。因为我使用了 dry_run，也就是演习，所以显示的 rolled_over 是 false。
为了能真正地 rollover，我们运行如下的命令：
代码语言：javascript复制POST /log_alias/_rollover
{
"conditions": {
"max_age": "7d",
"max_docs": 1400,
"max_size": "5gb"
}，
"settings": {
"index.number_of_shards": 2
}
}
结果：
{
"acknowledged":true,
"shards_acknowledged":true,
"old_index":"logs-2019.10.21-1",
"new_index":"logs-2019.10.21-000002",
"rolled_over":true,
"dry_run":false,
"conditions":{
"[max_docs: 1400]":true,
"[max_size: 5gb]":false,
"[max_age: 7d]":false
}
}说明它已经rolled_ovder了。我们可以通过如下写的命令来检查：
代码语言：javascript复制GET _cat/indices/logs-2019*显示的结果为：
我们现在可以看到有两个以 logs-2019.10.21 为头的 index，并且第二文档 logs-2019.10.21-000002 文档数为0。如果我们这个时候直接再想 log_alias 写入文档的话：
代码语言：javascript复制POST log_alias/_doc
{
"agent": "Mozilla/5.0 (X11; Linux x86_64; rv:6.0a1) Gecko/20110421 Firefox/6.0a1",
"bytes": 6219,
"clientip": "223.87.60.27",
"extension": "deb",
"geo": {
"srcdest": "IN:US",
"src": "IN",
"dest": "US",
"coordinates": {
"lat": 39.41042861,
"lon": -88.8454325
}
},
"host": "artifacts.elastic.co",
"index": "kibana_sample_data_logs",
"ip": "223.87.60.27",
"machine": {
"ram": 8589934592,
"os": "win 8"
},
"memory": null,
"message": """ 223.87.60.27 - - [2018-07-22T00:39:02.912Z] "GET /elasticsearch/elasticsearch-6.3.2.deb_1 HTTP/1.1" 200 6219 "-" "Mozilla/5.0 (X11; Linux x86_64; rv:6.0a1) Gecko/20110421 Firefox/6.0a1" """,
"phpmemory": null,
"referer": "http://twitter.com/success/wendy-lawrence",
"request": "/elasticsearch/elasticsearch-6.3.2.deb",
"response": 200,
"tags": [
"success",
"info"
],
"timestamp": "2019-10-13T00:39:02.912Z",
"url": "https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.3.2.deb_1",
"utc_time": "2019-10-13T00:39:02.912Z"
}
结果：
{
"_index":"logs-2019.10.21-000002",
"_type":"_doc",
"_id":"xPyQ7m0BsjOKp1OsjsP8",
"_version":1,
"result":"created",
"_shards":{
"total":1,
"successful":1,
"failed":0
},
"_seq_no":1,
"_primary_term":1
}显然它写入的是 logs-2019.10.21-000002 索引。我们再次查询 log_alias 的总共文档数：
代码语言：javascript复制GET log_alias/_count
结果：
{
"count":14075,
"_shards":{
"total":2,
"successful":2,
"skipped":0,
"failed":0
}
}显然它和之前的 14074 个文档多增加了一个文档，也就是说 log_alias 是同时指向 logs-2019.10.21-1 及 logs-2019.10.21-000002。
总结
在今天的文档里，我们讲述了如何使用 rollover API 来自动管理我们的 index。利用 rollover API，它可以很方便地帮我们自动根据我们设定的条件帮我们把我们的Index过度到新的 index。在未来的文章里，我们将讲述如何使用 Index life cycle policy 来帮我们管理我们的 index。
