# 크론 작업이 실패하는 순간.

> 크론 작업이나 예약 작업이 실패하면 푸시 알림을 받아보세요. crontab이나 systemd 타이머에 한 줄만 추가하면 실패 알림이 1초 안에 휴대폰으로 도착해요.

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

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

크론 작업이 실패하는 순간 Pocket Alert가 휴대폰으로 푸시 알림을 보내요. 예약된 명령 뒤에 &&나 ||로 한 줄만 연결하면 됩니다. 실패할 때, 성공할 때, 또는 둘 다 알림을 받을 수 있고, 작업이 종료되는 순간 오류 내용까지 함께 도착해요.

## 크론 실패 알림까지 세 단계

1. **URL 또는 CLI 준비** — 애플리케이션의 수신 웹훅 URL을 복사하거나 Pocket Alert CLI를 설치하세요.
2. **한 줄 추가** — 크론 줄에 curl 호출이나 pocketalert send를 연결하세요. 실패 시에는 ||, 성공 시에는 &&를 사용하면 돼요.
3. **알림 받기** — 작업을 실행하세요. 실패하면 설정한 제목과 오류 출력과 함께 휴대폰이 울려요.

## 실패한 작업을 더 이상 놓치지 마세요

가져오기 작업이 실패하면 로그를 열어보기 몇 시간 전에 바로 알려 드려요.

- **crontab에 한 줄이면 충분해요** — 크론 줄 어디에든 &&나 ||로 푸시를 연결하세요. curl 한 번이면 되고, 관리해야 할 데몬도 없어요.
- **실패했을 때만 알림** — ||를 쓰면 명령이 0이 아닌 코드로 종료될 때만 알림이 가요.
- **오류 내용 포함** — stderr나 종료 코드를 메시지에 넣으면, 푸시 알림에 오류 내용이 함께 도착해요.
- **모든 스케줄러 지원** — crontab, systemd 타이머, Laravel 스케줄러, Sidekiq, K8s CronJob 모두 명령을 실행하는 방식이라 그대로 연결돼요.
- **성공 시 하트비트** — 성공적으로 실행된 뒤 하트비트를 보내세요. 더 이상 도착하지 않으면 작업이 조용히 멈춘 것이니 바로 확인할 수 있어요.
- **종료 즉시 알림** — 작업이 끝나는 순간 푸시가 도착해요. 누군가 로그를 확인하기 몇 시간 전에 알 수 있어요.

## 크론 작업에 알림 연결하기

### CLI 설치 및 인증

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

### 작업이 실패할 때만 알림 받기

종료 코드가 0이 아닐 때만 알림이 가도록 `||`로 연결하세요:

```
0 3 * * * /usr/local/bin/mybackup.sh || pocketalert send \
  -t "Cron failed: mybackup" -m "Exited non-zero at $(date)"
```

### 오류 출력 포함하기

```
0 3 * * * /usr/local/bin/mybackup.sh 2>/tmp/cron.err || pocketalert send \
  -t "Cron failed: mybackup" -m "$(tail -n 3 /tmp/cron.err)"
```

### 성공 시 하트비트 보내기

정상적으로 실행된 뒤 `&&`로 신호를 추가하세요. 신호가 더 이상 도착하지 않으면 작업이 조용히 멈춘 거예요:

```
0 3 * * * /usr/local/bin/mybackup.sh && pocketalert send "Cron OK: mybackup" "Finished cleanly"
```

### CLI가 없나요? curl로 API 호출하기

```
0 3 * * * /usr/local/bin/mybackup.sh || curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Cron failed: mybackup","message":"Exited non-zero","level":"high"}'
```

대상 지정과 애플리케이션별 채널 설정은 [문서](https://info.pocketalert.app/getting-started.html)에서 확인하세요.

## 자주 묻는 질문

### 크론 작업 알림은 어떻게 받나요?

셸에서 크론 명령 뒤에 알림을 체이닝하세요. `&&`는 성공 후에, `||`는 실패 후에 실행되고, 작업이 종료되면 Pocket Alert가 푸시 알림을 보내요.

### 실패했을 때만 알림을 받을 수 있나요?

명령이 0이 아닌 코드로 종료될 때만 알림이 가도록 `||`를 사용하세요: `mybackup.sh || curl ...`. 문제가 생긴 작업만 알려 주고, 나머지는 조용히 넘어가요.

### 오류 출력도 함께 보낼 수 있나요?

네. 종료 코드나 출력을 캡처해서 메시지 본문에 넣으면 돼요. Pocket Alert CLI는 stderr를 알림으로 바로 전달해요.

### crontab 외의 스케줄러에서도 되나요?

crontab, systemd 타이머, Laravel 스케줄러, Rails나 Sidekiq 크론, Windows 작업 스케줄러, Kubernetes CronJob 모두 사용할 수 있어요. 명령을 실행하는 스케줄러라면 어디든 알림을 연결할 수 있어요.

### 한 번도 실행되지 않은 작업도 감지할 수 있나요?

모든 성공 실행 뒤에 `&&`로 완료 신호를 보내세요. 신호가 더 이상 도착하지 않으면 작업이 실행되지 않았다는 뜻이고, 별도 도구는 필요 없어요.

### 야간 작업이 실패하면 깨워 주고, 성공 신호는 조용히 받을 수 있나요?

실패 알림에 level=critical을 추가하면 Android에서는 방해 금지 모드를 뚫고, iPhone에서는 집중 모드를 뚫고 알림이 와요. 하트비트 신호에는 level=silent를 사용하세요. 소리 없이 기록에만 남아서 휴대폰은 조용하게 유지돼요.
