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

记录每次备份的关键元数据

记录每次备份的关键元数据

备份文件存在,并不代表以后能快速判断它来自哪次任务、覆盖哪些数据、是否完整。本篇建立一份随备份一起产生的元数据记录,保存时间、版本、范围、大小、校验结果和目标位置,让恢复定位与审计都有可验证依据。

学习目标

  • 确定一次备份必须记录的关键元数据
  • 为备份产物生成结构稳定、可检索的记录
  • 使用校验值和文件属性验证元数据对应真实产物

元数据要回答哪些问题

备份元数据不是运行日志的替代品。日志用于解释任务执行过程,而元数据描述最终形成的备份产物。发生恢复需求时,应该无需翻阅大量日志,就能回答“什么时候备份、备份了什么、在哪里、是否完整”。

建议至少记录以下信息:备份开始或完成时间、备份工具或数据版本、数据范围、备份大小、完整性校验结果、目标位置以及可唯一定位本次备份的标识。数据库备份还可以记录实例、库名或日志位点,但不要为了字段齐全而记录恢复过程根本不会使用的信息。

为备份产物生成记录

下面以 Linux 文件归档为例。脚本创建压缩包后计算 SHA-256,并把关键属性写入 JSON。示例中的 /srv/app-data 与 /backup 需要替换为实际路径。

bash
set -euo pipefail

SOURCE="/srv/app-data"
TARGET_DIR="/backup"
BACKUP_ID="$(date -u +%Y%m%dT%H%M%SZ)"
ARCHIVE="${TARGET_DIR}/app-${BACKUP_ID}.tar.gz"
META="${ARCHIVE}.json"

mkdir -p "$TARGET_DIR"
tar -czf "$ARCHIVE" -C "$SOURCE" .
SIZE_BYTES="$(stat -c '%s' "$ARCHIVE")"
SHA256="$(sha256sum "$ARCHIVE" | awk '{print $1}')"

printf '{"backupId":"%s","completedAt":"%s","scope":"%s","sizeBytes":%s,"checksumAlgorithm":"sha256","checksum":"%s","verification":"passed","location":"%s"}\n' \
  "$BACKUP_ID" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$SOURCE" "$SIZE_BYTES" "$SHA256" "$ARCHIVE" > "$META"

cat "$META"

预期输出的动态时间、大小、校验值和路径会因实际备份而不同:

text
{"backupId":"<ID>","completedAt":"<TIME>","scope":"/srv/app-data","sizeBytes":<SIZE>,"checksumAlgorithm":"sha256","checksum":"<CHECKSUM>","verification":"passed","location":"/backup/app-<ID>.tar.gz"}

这里把元数据作为备份文件旁的独立 JSON 保存,便于对象存储、脚本和审计系统读取。实际系统也可以写入数据库或集中式元数据服务,但字段语义应保持稳定。

校验记录是否可信

记录校验值之后,还必须能够重新验证。恢复前可以从元数据取得预期 SHA-256,再对实际文件重新计算;两者一致只能证明文件与生成校验值时相同,不能替代恢复测试。

bash
sha256sum /backup/app-<ID>.tar.gz
stat -c '%s bytes' /backup/app-<ID>.tar.gz

预期输出:

text
<CHECKSUM>  /backup/app-<ID>.tar.gz
<SIZE> bytes

将结果与对应 JSON 中的 checksum 和 sizeBytes 比较。若位置存在但大小或校验值不一致,应把该备份标记为不可用并调查传输、覆盖或存储损坏,而不是继续把它作为恢复候选。

让记录能够长期用于审计

元数据应与备份产物建立稳定的一一对应关系,并在备份完成后自动产生,而不是依赖人工补录。若备份会复制到异地或对象存储,还应记录最终可恢复位置,而不只是本机临时文件路径。

对长期保留的备份,还要避免元数据和产物被不同生命周期策略分别删除。最实用的验收方式是随机选择一个备份,仅根据元数据找到产物、核对校验值并执行恢复测试;能够完成这条链路,元数据才真正具备定位与审计价值。

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

目录与阅读设置

阅读设置

17

记录一个想法

记录每次备份的关键元数据

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

登录哪都通