Agent 扫描故障排查

​

1. 确认 Agent 状态

• 当前矿场已分配 Agent
• Agent 已完成安装
• Agent 当前在线

​

2. 确认扫描任务

• 如果任务处于 pending 状态，请等待任务完成
• 如果任务失败，请先查看任务输出或错误信息
• 如果没有扫描任务，请重新提交扫描

​

3. 确认 IP 范围

• 子网配置错误
• 选择了管理网而非矿机网
• 扫描范围过大
• 矿机已迁移至其他 VLAN 或子网

​

4. 确认矿机凭据

• 配置自定义矿机密码

​

5. 检查 Agent 服务

sudo systemctl status nonce-agent
nonce-agent summarize-ip-list
nonce-agent summarize-miner-scan-report -v
nonce-agent get-miner-meta <miner-ip> --validate --no-cache --raw --json

• Agent 服务状态
• 监控列表中的 IP 地址
• 最近的扫描结果
• Agent 主机能否直接获取指定矿机的数据

​

6. 查看本地报告

~/.nonce-agent/reports/MINERS_SCAN_REPORT/
~/.nonce-agent/reports/MINERS_FETCH_REPORT/failed_ips.txt
~/.nonce-agent/reports/MINERS_FETCH_REPORT/succeed_ips.txt

• 已扫描的 IP 地址
• 已跳过的 IP 地址
• 已发现的矿机
• 元数据采集失败的 IP 地址

​

7. 排查停止更新的矿机

• 矿机当前不可达
• 矿机详情抓取持续失败
• 矿机已经不在预期的 IP 段里
• Nonce 长时间未收到更新，已将矿机数据标记为过期（stale）

nonce-agent get-miner-meta <miner-ip> --validate --no-cache --raw --json

​

8. 刷新 UI 中的矿机数据

• 刷新 Miners 页面
• 重新打开矿场页面
• 打开任务详情确认任务已完成
• 如果依赖定时数据采集，请等待至下一个采集周期

​

9. 重新发现手动删除的矿机

​

10. 确认矿机型号与固件支持情况

​

联系支持团队

• Agent 在线，但所有扫描任务都失败
• 对可达矿机执行 get-miner-meta 仍然失败
• 扫描任务成功，但 Nonce 中始终没有矿机数据
• 同一子网内其他品牌正常，只有某一矿机品牌持续失败