elasticsearch 索引恢复 查看 API

来源: http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-recovery.html     

indices recovery API 提供了查看正在恢复中的索引状态信息，恢复状态可以指定特定的索引或者整个集群。

  例如我们可以通过下面的这条命令查看索引名为”index1”,”index2”两个索引的恢复状态信息，

curl -XGET http://localhost:9200/index1,index2/_recovery?pretty=true

为了能看到集群中所有的恢复状态信息，可以把索引名去掉，命令改成:

curl -XGET http://localhost:9200/_recovery?pretty=true

响应结果：

{
  "index1" : {
    "shards" : [ {
      "id" : 0,
      "type" : "snapshot",
      "stage" : "index",
      "primary" : true,
      "start_time" : "2014-02-24T12:15:59.716",
      "stop_time" : 0,
      "total_time_in_millis" : 175576,
      "source" : {
        "repository" : "my_repository",
        "snapshot" : "my_snapshot",
        "index" : "index1"
      },
      "target" : {
        "id" : "ryqJ5lO5S4-lSFbGntkEkg",
        "hostname" : "my.fqdn",
        "ip" : "10.0.1.7",
        "name" : "my_es_node"
      },
      "index" : {
        "files" : {
          "total" : 73,
          "reused" : 0,
          "recovered" : 69,
          "percent" : "94.5%"
        },
        "bytes" : {
          "total" : 79063092,
          "reused" : 0,
          "recovered" : 68891939,
          "percent" : "87.1%"
        },
        "total_time_in_millis" : 0
      },
      "translog" : {
        "recovered" : 0,
        "total_time_in_millis" : 0
      },
      "start" : {
        "check_index_time" : 0,
        "total_time_in_millis" : 0
      }
    } ]
  }
}

     以上返回结果展示了单个索引单个分片的响应情况，恢复源为备份快照仓库，目标为一个叫“my_es_node”名的节点。

  另外，输出结果还显示了恢复文件数和百分比，同样也输出了按照字节恢复数和恢复进度比率。

在一些场合中，还有可能想更详细的查看恢复信息，可以通过设置 "detailed=true"来展示更详细的信息，如:

    curl -XGET http://localhost:9200/_recovery?pretty=true&detailed=true

响应结果：

{
  "index1" : {
    "shards" : [ {
      "id" : 0,
      "type" : "gateway",
      "stage" : "done",
      "primary" : true,
      "start_time" : "2014-02-24T12:38:06.349",
      "stop_time" : "2014-02-24T12:38:08.464",
      "total_time_in_millis" : 2115,
      "source" : {
        "id" : "RGMdRc-yQWWKIBM4DGvwqQ",
        "hostname" : "my.fqdn",
        "ip" : "10.0.1.7",
        "name" : "my_es_node"
      },
      "target" : {
        "id" : "RGMdRc-yQWWKIBM4DGvwqQ",
        "hostname" : "my.fqdn",
        "ip" : "10.0.1.7",
        "name" : "my_es_node"
      },
      "index" : {
        "files" : {
          "total" : 26,
          "reused" : 26,
          "recovered" : 26,
          "percent" : "100.0%",
          "details" : [ {
            "name" : "segments.gen",
            "length" : 20,
            "recovered" : 20
          }, {
            "name" : "_0.cfs",
            "length" : 135306,
            "recovered" : 135306
          }, {
            "name" : "segments_2",
            "length" : 251,
            "recovered" : 251
          },
           ...
          ]
        },
        "bytes" : {
          "total" : 26001617,
          "reused" : 26001617,
          "recovered" : 26001617,
          "percent" : "100.0%"
        },
        "total_time_in_millis" : 2
      },
      "translog" : {
        "recovered" : 71,
        "total_time_in_millis" : 2025
      },
      "start" : {
        "check_index_time" : 0,
        "total_time_in_millis" : 88
      }
    } ]
  }
}

上述返回了详细的恢复列表信息(为了显示已经截去部分数据)，包括恢复文件数和字节大小。还是恢复阶段时间等信息，上述恢复结果显示中显示的是已完成状态。默认情况下，不管恢复状态是否完成，只要状态信息还在，使用查看命令时均可返回。可以设置"active_only=true"来过滤只显示正在恢复的索引。

下面还有一些参数配置项：

detailed:显示详细信息，主要是用于显示物理文件恢复情况的，默认为false;

active_only:仅显示正在恢复过程中的恢复信息，默认为false；

输出结果描述：

id:分片id

type:恢复来源信息，gateway、snapshot(快照)、replica(副本)、relocating(重新分配)；

stage:恢复阶段，init(初始化，未开始)、index(读取索引元数据信息和正在从源复制数据到 目标上)、start(正在执行，打开索引以备使用)、translog(重新使用事务日志)、finalize(清除)、done(完成)。

primary:true主分片，否则为false;

start_time:开始恢复时间戳；

stop_time:恢复完成时间戳；

total_time_in_millis:分片恢复所耗的毫秒数；

source:恢复源，如果是从快照恢复的描述为快照仓库，其他的为节点信息；

target:目标节点；

index:索引恢复统计信息；

translog:事务日志恢复统计信息；

start:打开索引的统计信息；