文档首页/ 云搜索服务 CSS/ 常见问题/ CSS集群备份与恢复/ CSS服务中如何查询集群的快照信息？
更新时间：2025-09-04 GMT+08:00
查看PDF
分享

CSS服务中如何查询集群的快照信息？

CSS集群必须启用了集群快照功能，并已存在备份好的快照，才能查询快照信息。

可以通过控制台查看，也可以在Kibana或OpenSearch Dashboards中执行命令查询。

在控制台查询快照

  1. 登录云搜索服务管理控制台。
  2. 在左侧导航栏，选择“集群管理”，根据目标集群选择集群类型，进入集群列表页面。
  3. 在集群列表，单击目标集群名称，进入集群详情页。
  4. 选择“集群快照”页签。
  5. 在集群快照任务列表中，单击目标快照名称，弹出查看详情对话框，可以获取快照信息。

使用命令行查询快照

  1. 登录云搜索服务管理控制台。
  2. 在左侧导航栏，选择“集群管理”，根据目标集群选择集群类型，进入集群列表页面。
  3. 如果是Elasticsearch集群，则在集群列表单击操作列的“Kibana”，登录Kibana。如果是OpenSearch集群，则在集群列表单击操作列的“Dashboards”，登录OpenSearch Dashboards。
  4. 在左侧导航栏选择“Dev Tools”，进入操作页面。
  5. 执行如下命令，查询快照仓库信息，即集群快照的基础配置。 
    GET _snapshot/_all

    返回示例：

    {
  "repo_auto": {
    "type": "obs",
    "settings": {
      "bucket": "123xxx",  	// OBS桶名称
      "chunk_size": "2g",  	// 分块大小，控制备份数据分片的大小（单位：GB）
      "endpoint": "obs.xxx.example.com:443",  	// OBS的Endpoint
      "max_restore_bytes_per_sec": "0MB",  	// 最大恢复速率（每秒）
      "compress": "true",  	// 是否启用数据压缩
      "base_path": "css_repository/css-xxx",  	// 备份路径
      "region": "xxx",  	// 所在区域
      "max_snapshot_bytes_per_sec": "40MB"  	// 最大备份速率（每秒）
    }
  }
}
  6. 执行如下命令，查询快照列表。 
    GET _snapshot/repo_auto/_all

    返回示例（总共查询到2条快照信息）：

    {
  "snapshots": [
    {
      "snapshot": "snapshot-2dc3",  	 // 快照名称
      "uuid": "VW5y2NBJS9iPh7YcGLxxxx",  // 快照ID
      "version_id": xxxxxxx,  		// 内部使用的集群版本号
      "version": "x.x.x",  		// 集群版本号
      "indices": [  			// 备份的索引列表
        ".opendistro_security"
      ],
      "data_streams": [ ],  		// 列出数据流
      "include_global_state": true,  	// 是否包含集群的全局状态
      "state": "SUCCESS",  			// 快照状态
      "start_time": "2025-08-30T01:41:57.068Z",  // 快照开始时间
      "start_time_in_millis": 1756518117068,  	// 快照开始时间的毫秒级时间戳
      "end_time": "2025-08-30T01:41:57.469Z",  	// 快照结束时间
      "end_time_in_millis": 1756518117469,  	// 快照结束时间的毫秒级时间戳
      "duration_in_millis": 401,  			// 快照操作的持续时间（毫秒），表示从开始到结束的总时间
      "failures": [ ],  				// 快照过程中出现的错误或失败的分片信息
      "shards": {  					// 快照涉及的分片统计信息
        "total": 1,  					// 总分片数
        "failed": 0,  					// 失败的分片数
        "successful": 1  				// 成功的分片数
      }
    },
    {
      "snapshot": "snapshot-dd37",
      "uuid": "FD4VcooLS8yjPY3w0-x-xx",
      "version_id": xxxxxxx,
      "version": "x.x.x",
      "indices": [
        ".kibana",
        ".opendistro_security"
      ],
      "data_streams": [ ],
      "include_global_state": true,
      "state": "SUCCESS",
      "start_time": "2025-08-30T01:54:55.750Z",
      "start_time_in_millis": 1756518895750,
      "end_time": "2025-08-30T01:54:55.950Z",
      "end_time_in_millis": 1756518895950,
      "duration_in_millis": 200,
      "failures": [ ],
      "shards": {
        "total": 2,
        "failed": 0,
        "successful": 2
      }
    }
  ]
}

    如果需要查询指定快照信息，可以执行如下命令。

    GET _snapshot/repo_auto/{snapshot_name}

    snapshot_name替换为实际快照名称，支持通配符。

  7. （可选）执行如下命令，可以删除指定快照。 
    DELETE _snapshot/repo_auto/{snapshot_name}

    快照被删除后，将不能用于恢复快照，请谨慎操作。

相关文档