可观测性与稳定性 / 系统课时
从快照恢复时怎么验证数据
从快照恢复时怎么验证数据
恢复成功不等于恢复有效。真正验收时要同时确认恢复出来的索引存在、文档数量符合预期、分片健康可用,并用一条实际查询验证业务字段还能读到;这样才能避免“API 返回成功,但数据并不是需要的数据”。
学习目标
- 能把快照恢复到新索引,避免直接覆盖现有数据。
- 能用文档数量和集群健康状态验证恢复结果。
- 能通过实际查询确认恢复的数据内容可读。
先选择安全的恢复方式
恢复前先确认目标集群正在运行、有 elected master,快照仓库已经注册且可访问,并且快照与目标集群版本兼容。([Elastic][6])
教学和演练环境优先恢复成新名称,例如把 logs-app-<TIME> 恢复为 restored-logs-app-<TIME>。这样原索引仍可保留,验证失败时不会先破坏现场。

恢复到新索引
下面示例只恢复一个关键日志索引,并关闭全局状态和别名恢复,减少对现有集群配置的影响。rename_pattern 与 rename_replacement 用于把快照里的原索引映射成新的目标名称。([Elastic][6])
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}\"
}"预期结果
请求成功完成恢复,目标索引 restored-logs-app-<TIME> 出现,且恢复结果没有报告缺失的目标索引或失败分片。这里的索引名必须替换为快照中真实存在的名称;如果快照里没有这个索引,ignore_unavailable=false 会让请求明确失败,而不是悄悄跳过。
先验收文档数量和健康状态
恢复完成后,不要先凭 Kibana 页面“看起来有数据”判断成功。先对恢复索引做 _count,再检查该索引的健康状态。数量基准应来自备份前记录的真实数量,而不是凭估计填写。
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}"预期结果
_count 返回 count 字段;实际 count 应与备份前记录的基准一致,允许你根据业务场景解释正在写入或采集中的自然变化。
_cluster/health 返回该索引的健康信息,至少应确认 primary_shards 是否可用,并结合 status 判断是否存在未分配分片。数量一致主要说明“文档规模恢复到了预期”,健康检查则回答“分片能否正常提供数据”。两者不能互相替代:数量对了,不代表分片当前就可用;状态正常,也不能证明恢复的是正确数据。
用实际查询验证内容
最后做一次最小读取测试。不要一开始就跑复杂聚合,只验证恢复后的索引还能返回你关心的字段,例如时间、服务名和消息。
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"
]
}'预期结果
HTTP 请求成功并返回 hits 对象;hits.total 表示匹配数量,hits.hits 中至少能看到一条恢复后的文档,其 _source 包含请求指定的字段(若原文档确实存在这些字段)。这里最后一步的意义是验证数据可读性。如果 _count 正常但查询字段为空,常见原因可能是字段名与实际映射不一致,或者你恢复的索引并不是验收时预期的那一批数据。
验收通过的判断
一次恢复演练可以按四层证据判断:目标索引已经出现,文档数量与备份基准相符,分片健康可用,代表性查询能够读取业务字段。四项都成立后,才把恢复结果记为“可用”;如果只看到 restore API 返回成功,就结束验收,故障往往会在真正需要查询数据时才暴露。