Elasticsearch 快照 Snapshot 恢复失败报错怎么查看日志？

恢复失败时，优先通过 `_cat/recovery` 接口查看具体分片恢复状态，再结合集群日志定位根本原因。

先说结论：不要只盯着日志文件，先调 API 看恢复任务停在哪一步，再查日志找具体异常堆栈。

先确认：恢复任务是否还在运行，还是已经终止。
先处理：解决集群阻塞、磁盘空间或权限问题。
再验证：确认分片状态恢复正常且无报错。

命令速用版

# 查看恢复进度和状态（生产环境需加认证）
curl -X GET "localhost:9200/_cat/recovery?v" -u elastic:password

# 查看具体的恢复任务详情
curl -X GET "localhost:9200/_tasks?actions=*restore*&detailed" -u elastic:password

# 查看集群健康状态
curl -X GET "localhost:9200/_cluster/health?v" -u elastic:password

日志查看实操

标题虽为查看日志，但直接翻文件效率低。根据部署方式不同，日志获取路径差异较大：

Tar/Zip 安装包：位于 ES 安装目录下的 logs/elasticsearch.log。
RPM/DEB 安装：通常位于 /var/log/elasticsearch/ 目录。
Docker 容器：使用 docker logs <container_id> 查看标准输出。
云服务/Kibana：通过云控制台日志服务或 Kibana Stack Monitoring 查看，无需登录节点。

快速检索错误命令：

# 自建集群查找恢复相关异常
grep "RestoreException" /var/log/elasticsearch/*.log

# 查找快照缺失错误
grep "SnapshotMissingException" /var/log/elasticsearch/*.log

分步处理与修复

1. 检查恢复任务状态
使用 `_cat/recovery` 命令。如果 stage 停留在 index 或 finalize 且长时间不动，说明卡住了。如果 type 显示 snapshot 但状态为 FAILED，记录对应的索引名。

2. 检查集群健康度与只读锁
执行 `_cluster/health`。如果状态是 red 或 yellow，说明已有分片分配失败。如果集群块状态为 read_only_allow_delete，需执行以下命令解除：

PUT _all/_settings
{
  "index.blocks.read_only_allow_delete": null
}

3. 查看具体错误日志
根据上述“日志查看实操”定位日志文件。搜索 RestoreException 或 SnapshotMissingException。注意报错的时间点是否与恢复操作一致。

4. 验证仓库连通性
如果是共享文件系统或 S3 仓库，确认当前集群是否有权限访问该路径。可以使用以下接口测试仓库可用性（替换 <repo_name> 为实际仓库名）：

POST _snapshot/<repo_name>/_verify

怎么验证是否生效

再次执行 _cat/recovery?v，列表应该为空或只显示正在进行的正常恢复。执行 _cluster/health?v，状态应变为 green 或预期的 yellow（取决于副本配置）。检查目标索引文档计数是否与快照前一致。

常见坑

版本不兼容：高版本 ES 创建的快照不能直接在低版本集群恢复，主版本必须一致或目标版本更高。
插件缺失：如果快照索引使用了特定分词插件，恢复前目标集群必须先安装相同版本的插件。
磁盘空间不足：恢复过程需要额外空间存放数据，确保磁盘使用率不超过 85% 的安全水位。
索引只读块：集群曾因磁盘水位触发保护，恢复前需手动解除 block.read_only_allow_delete。

参考来源

Elasticsearch 官方文档 - Snapshot and Restore: https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshot-restore.html
Elasticsearch 官方文档 - Cat Recovery API: https://www.elastic.co/guide/en/elasticsearch/reference/current/cat-recovery.html
Elasticsearch 官方文档 - Cluster Health API: https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-health.html