# 백업이 깨지는 그 순간.

> 백업이 실패하면 푸시 알림을 받고, 매일 정상 실행됐는지도 확인하세요. pg_dump, rsync, restic 작업에 한 줄만 추가하면 조용히 넘어가던 실패도 알림으로 바뀌어요.

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

마지막 업데이트: 2026-10-17

pg_dump, rsync, restic 또는 다른 백업 명령에 알림을 연결하세요. 실패하는 순간 휴대폰으로 푸시 알림이 오고, 매일 오는 성공 신호로 나머지 작업이 계속 실행됐는지 확인할 수 있습니다.

## 백업에 대한 마음의 평화를 얻는 세 단계

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 모두 종료 코드로 알림을 보낼 수 있습니다.
- **상황에 맞는 채널** — 실패 알림과 일상적인 성공 신호를 별도의 애플리케이션으로 보내세요. 중요한 알림이 잡음에 묻히지 않습니다.
- **추가할 한 줄** — 이미 실행 중인 백업 스크립트 뒤에 한 줄만 연결하세요. 에이전트도, 대시보드도, 점검 시간도 필요 없습니다.

## 백업 작업 보호하기

### 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)에서 확인할 수 있습니다.

## 자주 묻는 질문

### 백업이 실패하면 어떻게 알림을 받나요?

백업 명령 뒤에 알림을 연결하세요. `||`를 쓰면 실패 시 휴대폰으로 푸시 알림이 바로 발송됩니다. 이 알림 덕분에 문제를 며칠 뒤 복원할 때가 아니라 즉시 알 수 있습니다.

### 백업이 실제로 실행됐는지 확인할 수 있나요?

네, 그리고 실질적인 가치는 여기에 있습니다. 매번 실행할 때 `&&`로 성공 신호를 보내세요. 매일 오는 “백업 정상” 알림이 멈추면, 작업이 조용히 멈췄다는 뜻입니다.

### 백업이 실패한 이유를 볼 수 있나요?

stderr을 캡처해 메시지에 담으세요. CLI가 오류 로그의 마지막 줄을 알림에 전달하므로, pg_dump나 rsync가 왜 실패했는지 바로 확인할 수 있습니다.

### 어떤 백업 도구를 지원하나요?

스크립트로 실행하는 것이라면 종료 코드로 알림을 보낼 수 있습니다. pg_dump, mysqldump, rsync, restic, borg, Duplicati, tar 작업, 관리형 스냅숏 스크립트까지 모두 지원합니다.

### 성공 신호로 알림이 번잡해지지 않게 하려면 어떻게 하나요?

실패와 성공 신호를 서로 다른 애플리케이션으로 보내세요. 실패는 자주 확인하는 채널로 오고, 매일 오는 “백업 정상” 알림은 감사 기록이 남는 조용한 채널에 쌓입니다.

### 백업 실패 알림이 방해 금지 모드를 뚫고 올 수 있나요?

네. 실패 분기에 `level=critical`을 추가하면 Android에서는 방해 금지 모드를 무시하는 채널로 발송되고, iPhone에서는 집중 모드도 뚫고 나오는 시간 민감 알림으로 표시됩니다. 매일 보내는 “백업 정상” 알림에는 `level=silent`를 설정하면 소리 없이 기록에만 남습니다.
