可观测性与稳定性 / 系统课时

从快照恢复时怎么验证数据

从快照恢复时怎么验证数据

恢复成功不等于恢复有效。真正验收时要同时确认恢复出来的索引存在、文档数量符合预期、分片健康可用,并用一条实际查询验证业务字段还能读到;这样才能避免“API 返回成功,但数据并不是需要的数据”。

学习目标

  • 能把快照恢复到新索引,避免直接覆盖现有数据。
  • 能用文档数量和集群健康状态验证恢复结果。
  • 能通过实际查询确认恢复的数据内容可读。

先选择安全的恢复方式

恢复前先确认目标集群正在运行、有 elected master,快照仓库已经注册且可访问,并且快照与目标集群版本兼容。([Elastic][6])

教学和演练环境优先恢复成新名称,例如把 logs-app-<TIME> 恢复为 restored-logs-app-<TIME>。这样原索引仍可保留,验证失败时不会先破坏现场。

Snapshot 恢复后的数据验收链路

恢复到新索引

下面示例只恢复一个关键日志索引,并关闭全局状态和别名恢复,减少对现有集群配置的影响。rename_pattern 与 rename_replacement 用于把快照里的原索引映射成新的目标名称。([Elastic][6])

bash
export SNAPSHOT="logs-<TIME>"
export SOURCE_INDEX="logs-app-<TIME>"
export RESTORED_INDEX="restored-logs-app-<TIME>"

curl -X POST \
  -H "Authorization: ApiKey ${ELASTIC_API_KEY}" \
  -H "Content-Type: application/json" \
  "${ELASTICSEARCH_URL}/_snapshot/log-backup/${SNAPSHOT}/_restore?wait_for_completion=true" \
  -d "{
    \"indices\": \"${SOURCE_INDEX}\",
    \"ignore_unavailable\": false,
    \"include_global_state\": false,
    \"include_aliases\": false,
    \"rename_pattern\": \"${SOURCE_INDEX}\",
    \"rename_replacement\": \"${RESTORED_INDEX}\"
  }"

预期结果

text
请求成功完成恢复,目标索引 restored-logs-app-<TIME> 出现,且恢复结果没有报告缺失的目标索引或失败分片。

这里的索引名必须替换为快照中真实存在的名称;如果快照里没有这个索引,ignore_unavailable=false 会让请求明确失败,而不是悄悄跳过。

先验收文档数量和健康状态

恢复完成后,不要先凭 Kibana 页面“看起来有数据”判断成功。先对恢复索引做 _count,再检查该索引的健康状态。数量基准应来自备份前记录的真实数量,而不是凭估计填写。

bash
curl -s \
  -H "Authorization: ApiKey ${ELASTIC_API_KEY}" \
  "${ELASTICSEARCH_URL}/${RESTORED_INDEX}/_count"

curl -s \
  -H "Authorization: ApiKey ${ELASTIC_API_KEY}" \
  "${ELASTICSEARCH_URL}/_cluster/health/${RESTORED_INDEX}"

预期结果

text
_count 返回 count 字段;实际 count 应与备份前记录的基准一致,允许你根据业务场景解释正在写入或采集中的自然变化。
_cluster/health 返回该索引的健康信息,至少应确认 primary_shards 是否可用,并结合 status 判断是否存在未分配分片。

数量一致主要说明“文档规模恢复到了预期”,健康检查则回答“分片能否正常提供数据”。两者不能互相替代:数量对了,不代表分片当前就可用;状态正常,也不能证明恢复的是正确数据。

用实际查询验证内容

最后做一次最小读取测试。不要一开始就跑复杂聚合,只验证恢复后的索引还能返回你关心的字段,例如时间、服务名和消息。

bash
curl -s \
  -H "Authorization: ApiKey ${ELASTIC_API_KEY}" \
  -H "Content-Type: application/json" \
  "${ELASTICSEARCH_URL}/${RESTORED_INDEX}/_search" \
  -d '{
    "size": 1,
    "sort": [
      {
        "@timestamp": "desc"
      }
    ],
    "_source": [
      "@timestamp",
      "service.name",
      "message"
    ]
  }'

预期结果

text
HTTP 请求成功并返回 hits 对象;hits.total 表示匹配数量,hits.hits 中至少能看到一条恢复后的文档,其 _source 包含请求指定的字段(若原文档确实存在这些字段)。

这里最后一步的意义是验证数据可读性。如果 _count 正常但查询字段为空,常见原因可能是字段名与实际映射不一致,或者你恢复的索引并不是验收时预期的那一批数据。

验收通过的判断

一次恢复演练可以按四层证据判断:目标索引已经出现,文档数量与备份基准相符,分片健康可用,代表性查询能够读取业务字段。四项都成立后,才把恢复结果记为“可用”;如果只看到 restore API 返回成功,就结束验收,故障往往会在真正需要查询数据时才暴露。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

从快照恢复时怎么验证数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通