# 备份与恢复

平台状态集中在单个 JSON 文件(`$DATA_DIR/lokistack.json`),备份恢复围绕它展开。

## 备份

- 手动:「系统设置 → 备份」立即创建(写入 `$DATA_DIR/backups/`)。
- 脚本:`./run.sh backup` 或 `make` 内相应目标,适合 cron 定时。

## 恢复

1. 上传统计备份或选择已有备份,校验后暂存。
2. 点击应用:平台先把当前库留档(`.before-restore.*`),替换后立即在内存生效,随后建议重启进程。
3. 恢复文件损坏时平台拒绝应用并提示。

## 数据文件保护

- 启动时若数据文件解析失败,原文件会以 `.corrupt-<时间戳>` 留档后再以空库启动,绝不覆盖可恢复数据。
- 历史命名数据文件(opsxloki.json / lokideploy.json)在启动时自动升级为 lokistack.json。

## 自监控

`/api/v1/metrics` 输出 Prometheus 指标(HTTP、DB 落盘、告警引擎、Go runtime);「平台监控」页(`/monitor`,管理员)提供可视化快照。