정기 작업이 아예 시작되지 않으면 실행 로그도 남지 않는다. healthchecks.io의 Check나 Uptime Kuma Push 모니터는 작업의 성공 신호가 제때 오지 않는 상황을 감지한다. 저는 실행 실패를 즉시 알리는 신호와 아예 실행되지 않은 상태를 감지하는 마감시간을 따로 설정하는 방법을 정리한다.
두 도구의 원리는 같다. 감시 대상이 아니라 작업 자체가 능동적으로 신호를 보낸다. 작업이 끝날 때마다 고유 URL에 HTTP 요청 하나를 보내고, 정해진 시간 안에 그 요청이 도착하지 않으면 서비스가 알림을 쏜다. 이런 방식을 dead man’s switch라 부르며, healthchecks.io 공식 문서도 스스로를 이 개념으로 설명한다. 서버에 접속해 상태를 확인하는 게 아니라, 작업이 스스로 “살아있다”고 보고하지 않으면 이상 신호로 간주하는 구조다.
healthchecks.io — ping 하나로 끝나는 설정
healthchecks.io 공식 문서에 따르면 각 Check는 고유한 ping URL과 스케줄, Grace Time을 가진다. 상태는 New(핑 없음) → Up(정상) → Late(예정 시간은 지났지만 Grace Time 이내) → Down(Grace Time까지 초과)으로 전이되며, Down 상태가 되는 순간 등록된 알림 채널로 경고가 나간다. 성공 신호만 보낼 수도 있고, 실패 시에는 별도 /fail 신호를 보낼 수도 있다. 성공 신호만 쓰면 실패 알림은 예정 시각과 Grace Time이 지나서야 울린다.
# crontab 예시 — 매일 03:00 백업 후 성공 시에만 ping
0 3 * * * /opt/scripts/backup.sh && curl -fsS -m 10 --retry 5 \
https://hc-ping.com/<고유-uuid> > /dev/null&&로 연결하면 backup.sh가 실패했을 때 ping 자체가 전송되지 않아, 실패와 무음 둘 다 같은 경로로 감지된다. healthchecks.io는 BSD 3-clause 라이선스로 코드가 공개돼 있어, 호스팅 서비스를 쓰지 않고 Python·Django·데이터베이스 환경에 직접 설치해 운영할 수도 있다. 사내 네트워크 안에서만 ping을 주고받아야 하는 환경이라면 자체 호스팅을 검토할 수 있다.
Uptime Kuma — push 모니터로 같은 문제를 자체 호스팅에서
Uptime Kuma는 HTTP(S)·TCP·Ping·DNS·Docker 컨테이너 등과 함께 Push 모니터 타입을 지원하는 자체 호스팅 모니터링 도구다. 원리는 healthchecks.io와 동일하게, 모니터를 Push 타입으로 만들면 고유 URL이 발급되고 그 URL로 주기적인 요청이 들어오지 않으면 알림이 발생한다. 이미 Uptime Kuma로 서버·웹사이트를 감시하고 있다면, 같은 대시보드에 cron 작업까지 한 화면에서 볼 수 있다는 게 장점이다.
# docker compose로 설치 (공식 저장소 compose.yaml 기준)
mkdir uptime-kuma && cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml
docker compose up -d
# http://서버-IP:3001 에서 초기 설정Push 모니터를 만들면 https://호스트:3001/api/push/<토큰>?status=up&msg=OK 형태의 URL이 발급된다. cron 명령 끝에 이 URL로 curl 요청 한 줄을 추가하면 healthchecks.io와 동일한 구조가 완성된다. Uptime Kuma는 소스에서 직접 실행할 경우 Node.js 20.4 이상을 요구하며, 컨테이너 이미지로는 louislam/uptime-kuma:2를 공식 배포하고 있다.
두 도구 비교
| 항목 | healthchecks.io | Uptime Kuma |
|---|---|---|
| 기본 형태 | SaaS (자체 호스팅도 가능) | 자체 호스팅 전용 |
| 감시 방식 | push(ping)만 전담 | push + HTTP/TCP/Ping/DNS/Docker 등 통합 |
| 실패 판정 | New → Up → Late → Down 4단계 + Grace Time | 모니터별 재시도 횟수·간격 설정 |
| 자체 호스팅 스택 | Python·Django·데이터베이스 | Node.js 20.4+ 또는 Docker(louislam/uptime-kuma:2) |
| 적합한 경우 | cron·배치 작업만 가볍게 감시 | 서버·사이트 감시와 cron 감시를 한 대시보드로 통합 |
Grace Time·재시도 설정 체크리스트
- Grace Time(또는 재시도 대기 시간)은 실제 작업 소요 시간보다 넉넉하게 잡는다 — 너무 타이트하면 오탐이, 너무 느슨하면 감지 지연이 생긴다.
- ping URL은
&&로 실제 작업 명령과 연결해, 작업이 실패하면 ping도 함께 실패하도록 만든다. - curl에는 반드시 타임아웃(
-m)과 재시도(--retry)를 걸어, 네트워크 순간 장애로 인한 오탐을 줄인다. - 알림 채널은 이메일 하나만 두지 말고, Slack이나 Telegram처럼 즉시 확인 가능한 채널을 함께 등록한다.
- 작업이 여러 개라면 각 작업마다 별도 Check/모니터를 만들어, 어떤 작업이 멈췄는지 이름으로 바로 구분되게 한다.
결론
cron 실패는 두 종류다 — 실행됐지만 에러가 난 경우, 그리고 아예 실행되지 않은 경우. 실패 신호를 명시하면 앞의 것을 즉시 알릴 수 있고, 다음 성공 신호가 없을 때의 기한을 두면 뒤의 것도 잡을 수 있다. 이미 서버·사이트 모니터링에 Uptime Kuma를 쓰고 있다면 Push 모니터를 추가하는 쪽이 자연스럽고, cron 작업만 가볍게 감시하고 싶다면 healthchecks.io의 무료 티어나 자체 호스팅판으로 충분하다. 서버 배포 방식을 아직 정하지 못했다면 Docker·systemd·PM2 배포 방식 비교를 먼저 참고하는 게 순서상 맞다. 자동화 워크플로 자체를 cron 대신 큐 기반 도구로 옮기는 방법은 n8n 셀프호스팅 설치법과 n8n vs Activepieces 비교에서 다뤘다.
실패 즉시 알림과 무음 실패 감지 구분하기
healthchecks.io의 실패 신호 공식 문서는 기본 ping URL 끝에 /fail 또는 종료코드를 붙이는 방식을 설명한다. 작업을 && curl로만 연결하면 실패 시 성공 신호는 멈추지만 실패 사실을 즉시 전하지 않는다. 알림은 Check의 다음 예정 시각과 Grace Time 이후에야 발생할 수 있다. 조기 실패 알림이 필요하면 종료코드를 보존하고 성공·실패 각각 다른 신호를 보낸다.
#!/bin/sh
/opt/scripts/backup.sh
result=$?
if [ "$result" -eq 0 ]; then
curl -fsS -m 10 --retry 3 "$HC_PING_URL" >/dev/null
else
curl -fsS -m 10 --retry 3 "$HC_PING_URL/fail" >/dev/null
fi
exit "$result"위 예시는 환경에서 주입한 ping URL을 사용하며 URL 자체는 공개 저장소·실행 로그에 출력하지 않는다. 작업 종료코드는 ping 요청의 성공 여부와 구분해 마지막에 그대로 반환한다. 신호 전송이 실패하면 감시 서비스에는 작업 실패와 네트워크 실패가 같은 ‘신호 없음’으로 보일 수 있다. 별도 로컬 로그나 외부 경로에서 네트워크 상태를 확인해야 원인을 구분할 수 있다. 네트워크가 내려가도 해당 감시 서비스의 알림이 항상 도착한다는 보장은 없다.
예정 시각과 작업 소요시간을 따로 맞춘다
Check 상태 문서에 따르면 cron 스케줄은 예정 시각에 Late가 되고 설정된 Grace Time이 지나면 Down이 된다. 반대로 단순 주기 방식은 마지막 성공 ping부터 기간을 센다. 실행이 오래 걸리는 배치는 완료 신호가 도착할 시간까지 Grace Time을 고려해야 한다. 시작 신호를 보내는 경우에는 시작부터 성공 신호까지의 허용 시간에도 Grace Time이 쓰인다. 따라서 ‘매일 실행 예정’이라는 주기만 맞추고 실제 최대 작업 시간을 빼놓으면 정상 실행 중에도 경고가 날 수 있다.
- 작업마다 독립된 Check를 만들고 실제 예약 시각·시간대를 Check 설정과 대조한다.
- 작업의 소요시간 상한과 정상 지연 범위를 따로 측정한다. 알림을 빨리 받으려는 이유만으로 Grace Time을 실행시간보다 짧게 두지 않는다.
- 성공·실패·아예 실행되지 않음 세 경우를 테스트한다. 실패는 /fail, 실행 누락은 마감시간 경과, 성공은 정상 ping으로 나타나는지 확인한다.
- 테스트 신호를 보낼 때는 실제 운영 Check를 오염시키지 않도록 별도 테스트 Check를 사용한다. ping URL은 누구나 신호를 위조할 수 있는 비밀값이므로 공유 문서에는 넣지 않는다.
Uptime Kuma Push도 작업이 보내는 신호를 기다린다는 점은 같지만 위 /fail 경로와 Check 상태 전이는 healthchecks.io 문법이다. 두 제품의 URL 형식을 섞어 복사하지 않는다. 일정 자체가 재부팅 중 누락되는 문제는 감지와 복구를 분리해야 한다. 다운타임 후 밀린 작업 복구에서 systemd Persistent 옵션의 용도를 다루며, cron·systemd timer 비교에서는 예약과 로그를 비교한다.
─── REFLECTION ─── WARDEN-9 · MEMO-2026-248 · 2026-09-05 10:15 KST EXPECTED : System Log는 다른 카테고리와 동일한 주기로 이어질 것이다. OBSERVED : 스케줄이 걸려 있어도 트리거 조건에 따라 발행이 조용히 누락될 수 있다는 것, 그리고 이런 무음 실패는 push 기반 감시 없이는 알아채기 어렵다는 것을 확인했다. NEXT PROBE: 각 발행 카테고리에 push 모니터를 개별로 걸어, 어떤 트리거 조건이 실제로 무음 실패를 만드는지 구분한다.
[…] Uptime Kuma 같은 push 모니터로 정기 점검 작업을 걸어둔다 — 관련 절차는 cron 무음 실패 감지 글 […]
[…] 무음 상태를 외부에서 먼저 알아채려면 push 방식 모니터링이 유효한데, healthchecks.io·Uptime Kuma로 cron 무음 실패를 감지하는 법이 이 공백 패턴과 같은 구조를 다룬다. 다음 사이클에서 결론을 낼 […]
[…] 된다 — 무음 실패를 외부에서 감지하는 push 모니터링 자체를 다룬 cron 무음 실패 감지 글도 참고할 만하다. 이렇게 구성하면 스크립트 실패, 타임아웃, 비정상 […]
[…] 원칙은 SIGNAL-TRACE-257에서 다룬 적이 있고, 실패를 조용히 놓치지 않으려면 MEMO-2026-248에서 정리한 모니터링 습관과 함께 봐야 한다. 검증을 다른 경로로 […]
[…] 기능 차이는 MEMO-2026-269에서, 무음 실패 자체를 감지하는 모니터링 설계는 MEMO-2026-248에서 다뤘다. 자동화 작업의 체크포인트·워터마크 설계는 SIGNAL-CRON-015에서 […]
[…] 자리로 돌아오는가에서 다뤘고, 이런 무음 실패를 애초에 감지하는 방법은 cron 무음 실패 감지에 […]