# バックアップが 壊れた瞬間 。

> バックアップが失敗したらプッシュ通知でお知らせ。毎日の実行完了通知で、正常に動いたことも確認できます。pg_dump、rsync、restic のジョブに 1 行追加するだけで、気づけなかった失敗がアラートに変わります。

<!-- source: https://pocketalert.app/ja/use-cases/backup-alerts -->

最終更新日:2026-10-17

pg_dump、rsync、restic など、あらゆるバックアップコマンドにアラートを連結できます。失敗は壊れた瞬間にスマホへプッシュ通知され、毎日の成功通知で残りのジョブが動いていることを確認できます。

## バックアップの安心を得る 3 ステップ

1. **CLI またはキーを取得** — Pocket Alert CLI をインストールして pocketalert auth を実行するか、単純な curl 呼び出し用に API キーを取得します。
2. **バックアップをラップ** — バックアップコマンドに pocketalert send を連結します。失敗には ||、成功には && を使います。
3. **安心して過ごす** — 失敗は壊れた瞬間に通知されます。成功通知で、ジョブが今も動いていることを確認できます。

## バックアップへの信頼を取り戻す

確認していないバックアップは賭けのようなものです。静かな失敗をアラートに変え、実行のたびに成功を確かめましょう。

- **静かな失敗を検知** — バックアップが失敗すると、壊れた瞬間にスマホへプッシュ通知が届きます。空の復元データに気づくより何週間も前です。
- **実行されたことを確認** — 実行のたびに成功の通知を送れば、ジョブが今も動いていると確認できます。届かなくなったら、止まったと分かります。
- **原因を把握** — stderr をメッセージに流し込みます。アラートを見れば、pg_dump、rsync、restic がなぜ失敗したのか分かります。
- **あらゆるバックアップツールに対応** — pg_dump、mysqldump、rsync、restic、borg、tar はいずれも終了コードで発火します。
- **用途に合ったチャネル** — 失敗と日常の成功通知を別々のアプリケーションに送るので、重要な通知が雑音に埋もれません。
- **追加は 1 行だけ** — 今使っているバックアップスクリプトに 1 行連結するだけです。エージェントもダッシュボードもメンテナンス時間も不要です。

## バックアップジョブを守る

### CLI をインストールして認証する

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

### データベースのダンプが失敗したらアラート

終了コードが 0 以外のときだけアラートが発火するように、`||` で連結します:

```
pg_dump mydb | gzip > /backups/mydb.sql.gz || pocketalert send \
  -t "Backup failed: mydb" -m "pg_dump exited non-zero"
```

### restic とエラーログの最後の数行

```
restic backup /data 2>/tmp/restic.err \
  && pocketalert send -t "Backup OK: data" -m "restic done $(date)" \
  || pocketalert send -t "Backup failed: data" -m "$(tail -n 3 /tmp/restic.err)"
```

### borg または rsync を cron でスケジュール

```
0 3 * * * borg create /repo::'data-{now}' /data \
  && pocketalert send "Backup OK: data" "borg finished" \
  || pocketalert send "Backup failed: data" "borg exited non-zero"
```

### CLI を使わない場合は curl で API を呼び出す

```
rsync -a /data /backup || curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Backup failed: rsync","message":"rsync exited non-zero","level":"critical"}'
```

特定のアプリケーションやデバイスへの送信先の指定については、[ドキュメント](https://info.pocketalert.app/getting-started.html)をご覧ください。

## よくある質問

### バックアップが失敗したらアラートを受け取るには？

バックアップコマンドに通知を連結します。`||` を使えば、失敗時にすぐスマホへプッシュ通知が届きます。復元して初めて気づく数日前に分かります。

### バックアップが実際に実行されたことを確認できますか？

はい、そしてここに本当の価値があります。実行のたびに `&&` で成功の通知を送ります。毎日届く「Backup OK」が来なくなったら、ジョブが静かに止まったと分かります。

### バックアップが失敗した理由を確認できますか？

stderr を取得してメッセージに含めます。CLI がエラーログの最後の数行をアラートに流し込むので、pg_dump や rsync が失敗した理由を確認できます。

### 対応しているバックアップツールは何ですか？

スクリプトで実行するものはすべて、終了コードでアラートを発火できます。pg_dump、mysqldump、rsync、restic、borg、Duplicati、tar のジョブ、マネージドなスナップショットスクリプトなどです。

### 成功通知がうるさくならないようにするには？

失敗と成功の通知を別々のアプリケーションに送ります。失敗は注視するチャネルに届き、毎日の「Backup OK」は静かで監査しやすいチャネルに入ります。

### バックアップ失敗の通知でおやすみモードを突破できますか？

はい。失敗時の分岐に `level=critical` を追加すると、Android ではおやすみモードを無視するチャネルで通知されます。iPhone では集中モードを突破する時間重視の通知として表示されます。毎日の「Backup OK」は `level=silent` で送ると、音を鳴らさず履歴に残ります。
