새벽 3시에 돌아야 할 백업이 멈췄는지, 아예 안 돌았는지 아침에 일어나서도 모르는 상황이 생각보다 자주 생깁니다. 서버 크론 작업 실패 알림 받는 방법을 찾는 분들도 대부분 이 불안에서 출발하실 것 같아요. 저도 무인으로 도는 크론을 여러 개 굴리면서 같은 일을 겪었습니다.
크론 작업이 실패했는데 아무도 모른다면, 무엇이 문제인가
실패에는 두 가지 유형이 있습니다. 하나는 스크립트가 에러를 내며 끝나는 경우고, 다른 하나는 예약 시간에 아예 실행되지 않거나 중간에 에러 없이 멈추는 경우예요. 앞의 것은 그나마 흔적이 남습니다. 뒤의 것은 흔적조차 없어요.
cron은 작업이 실패해도 대신 알려주지 않습니다. 작업이 출력한 내용이 있으면 메일로 넘기려고 시도할 뿐이고, 메일을 받을 곳이 없으면 그냥 사라져요. 출력을 로그 파일로 빼 버리면 메일도 안 나갑니다. 그래서 기본 설정 그대로 두면 실패가 있어도 조용합니다.
제가 겪은 건 무인 크론이 며칠간 멈춰 있었는데 한참 뒤에야 알아챈 일이었어요. 로그 파일의 수정 시각이 오래 그대로인 걸 보고서야 이상하다고 느꼈습니다. 에러 알림이 한 통도 안 왔으니 메일함을 아무리 뒤져도 실패한 흔적이 없었어요. 에러로 죽은 것보다 아예 돌지 않은 쪽이 더 위험하다는 걸 그때 확실히 알았습니다.
1단계: 실패 신호를 만든다 (종료 코드와 로그 확인)
알림을 붙이기 전에 스크립트가 실패를 실패라고 말하게 만들어야 합니다. 명령이 실패해도 마지막에 exit 0으로 끝나면 cron 입장에서는 성공이에요. 예전에 제 스크립트 끝에 무조건 exit 0이 붙어 있었습니다. 중간에 실패해도 조용했고, 그걸 고치고 나서야 실패가 실패로 찍히기 시작했어요. 로그를 처음부터 남겼으면 훨씬 빨리 찾았을 텐데, 그게 제 후회입니다.
작업을 감싸는 래퍼를 하나 두면 편합니다.
#!/bin/bash
# /home/ailee/jobs/run_job.sh
LOG=/home/ailee/logs/sync.log
mkdir -p "$(dirname "$LOG")"
echo "$(date '+%F %T') start" >> "$LOG"
if ! /home/ailee/jobs/sync_data.sh >> "$LOG" 2>&1; then
echo "$(date '+%F %T') FAILED" >> "$LOG"
exit 1
fi
echo "$(date '+%F %T') done" >> "$LOG"
exit 0
crontab에는 이렇게 겁니다.
0 3 * * * /home/ailee/jobs/run_job.sh
로그 경로는 반드시 절대 경로로 씁니다. cron은 셸에서 돌 때와 PATH나 현재 디렉터리가 달라서, 상대 경로로 쓰면 로그가 엉뚱한 곳에 쌓여요. 이거 은근 까다롭습니다. 처음엔 로그 파일이 생성되지 않는 줄 알고 한참 헤맸어요.
2단계: 가장 간단한 즉시 알림 연결 (MAILTO, 메신저 웹훅)
가장 손쉬운 건 MAILTO입니다. crontab 맨 위에 주소를 적으면 cron 출력을 그 주소로 보내요.
[email protected]
0 3 * * * /home/ailee/jobs/sync_data.sh
여기서 함정이 하나 있습니다. 출력이 있을 때만 메일이 나가는 구조라서, 위 래퍼처럼 출력을 전부 로그 파일로 돌려 버리면 메일이 아예 안 옵니다. 저는 MAILTO 메일이 스팸함으로 들어가서 한동안 실패를 놓쳤어요. 그 뒤로는 메신저 웹훅으로 바꿨습니다. 실패할 때만 채널에 글을 올리게 했어요.
#!/bin/bash
# SLACK_WEBHOOK_URL은 코드에 적지 말고 별도 파일에서 읽는다
. /home/ailee/.env_alert
notify() {
curl -s -X POST -H 'Content-type: application/json' \
--data "{\"text\":\"$1\"}" "$SLACK_WEBHOOK_URL"
}
LOG=/home/ailee/logs/sync.log
if ! /home/ailee/jobs/sync_data.sh >> "$LOG" 2>&1; then
notify "[실패] sync_data on $(hostname) $(date '+%F %T')"
exit 1
fi
웹훅 URL은 그 자체가 비밀번호 역할을 합니다. 누가 가져가면 채널에 아무 글이나 올릴 수 있어요. 그래서 스크립트 본문에 넣지 않고 권한을 좁힌 설정 파일이나 환경변수로 읽습니다. 디스코드도 웹훅 구조가 거의 같아서 같은 방식으로 쓸 수 있어요.
| 구분 | MAILTO 메일 | 슬랙·디스코드 웹훅 |
|---|---|---|
| 설정 난이도 | 서버에서 메일 발송이 되어야 해서 생각보다 손이 간다 | 웹훅 URL 하나면 끝난다 |
| 도착 속도 | 메일 서버 상태에 따라 들쭉날쭉하다 | 보내는 즉시 채널에 뜬다 |
| 누락 위험 | 스팸함으로 가거나 발송이 실패해도 흔적이 없다 | 채널 자체가 막히지 않는 한 남는다, 웹훅 URL 관리가 새면 위험하다 |

3단계: 에러 없이 멈추거나 안 돈 작업을 잡는 무음 실패 감지
여기까지 한 설정은 “실패했다”는 말이 와야 울립니다. 스크립트가 중간에 죽어서 아무 말도 못 하거나, cron이 아예 실행되지 않으면 알림 코드 자체가 돌지 않아요. 실패 알림과 성공 신호의 부재 감지는 다른 문제입니다. 그래서 방향을 뒤집어야 해요. 성공했을 때만 신호를 보내고, 그 신호가 예정 시각까지 안 오면 알리는 구조입니다. 이걸 하트비트라고 부릅니다.
제가 이 구조를 채택한 계기도 에러 알림이 한 번도 안 오는 상태에서 작업이 멈춘 걸 발견한 일이었어요. 알림이 안 왔다는 것 자체가 신호일 수 있다는 걸 그때 배웠습니다.
가장 간단한 방법은 작업이 성공한 마지막 줄에 신호를 추가하는 겁니다. healthchecks.io 같은 하트비트 서비스를 쓰면 발급받은 URL을 넣기만 하면 돼요.
#!/bin/bash
LOG=/home/ailee/logs/sync.log
if /home/ailee/jobs/sync_data.sh >> "$LOG" 2>&1; then
curl -fsS -m 10 --retry 3 https://hc-ping.com/여기에-UUID > /dev/null
touch /home/ailee/jobs/.sync_ok
else
echo "$(date '+%F %T') FAILED" >> "$LOG"
exit 1
fi
직접 만들고 싶다면 마커 파일의 수정 시각을 보는 감시 스크립트를 따로 돌릴 수 있습니다. 이 스크립트는 다른 크론에서 돌아야 해요. 같은 크론이 죽으면 감시도 같이 죽으니까요.
#!/bin/bash
# 감시 전용 크론에서 실행한다. 허용 시간(분)은 인자로 받는다
MARK=/home/ailee/jobs/.sync_ok
ALLOW_MIN="$1"
if [ -z "$(find "$MARK" -mmin -"$ALLOW_MIN" 2>/dev/null)" ]; then
curl -s -X POST -H 'Content-type: application/json' \
--data "{\"text\":\"[무음 실패] sync_data 성공 신호 없음\"}" \
"$SLACK_WEBHOOK_URL"
fi
허용 시간을 정하는 기준은 이렇게 잡았습니다. 예약 시각에서 작업이 평소 끝나는 시간을 재고, 거기에 여유를 더합니다. 하루 한 번 도는 작업인데 허용 시간을 너무 짧게 잡으면 매일 오탐이 나요. 반대로 너무 길게 잡으면 멈춘 걸 하루 종일 모르게 됩니다.
서비스 홍보 영상을 하루 한 번씩 올리는 크론이 ClipSquare, Folio Studio, 모션팩토리 3개 브랜드용으로 돌고 있는데, 이 작업이 멈추면 에러 메일도 웹훅도 오지 않아요. 그래서 이 작업부터 하트비트를 붙였습니다. 감시 크론 자체가 죽으면 아무도 모른다는 한계는 아직 남아 있어요. 감시를 다른 쪽에서 돌리는 방법을 생각은 하는데 아직 정리를 못 했습니다.

알림이 너무 많아 무시하게 되는 상황을 막는 법
알림을 다 연결하고 나면 다음 문제가 옵니다. 알림이 너무 많이 쌓이면 실제 장애 알림도 스크롤에 묻힙니다. 저도 그 시기를 겪었어요. 같은 실패가 반복해서 울리고, 정작 중요한 알림은 그 사이에 섞여 있었습니다. 결국 채널을 음소거해 버렸고, 그 기간에 생긴 문제는 나중에야 알았습니다.
정리한 방법은 세 가지입니다. 같은 실패는 상태가 바뀔 때만 보냅니다. 실패가 계속되는 동안은 다시 보내지 않고, 복구되면 한 번만 알려요. 성공 기록과 일상적인 완료 알림은 하루에 한 번 요약으로 묶습니다. 채널도 중요도별로 나눕니다. 긴급 채널과 요약 채널을 분리하면, 긴급 채널에는 진짜 깨워야 하는 것만 남아요.
| 분류 | 기준 | 보내는 곳 | 예시 |
|---|---|---|---|
| 즉시 | 데이터가 손상되거나 사용자에게 바로 영향이 간다 | 긴급 채널 | 백업 실패, 외부 API 동기화 실패 |
| 요약 | 다음 실행에서 복구되고, 하루에 한 번 봐도 된다 | 일일 요약 채널 | 캐시 갱신 실패 |
| 무시 가능 | 실패해도 영향이 없고 재시도가 자동으로 붙는다 | 로그 파일만 | 임시 파일 정리 작업 |
알림 수를 줄여야 실제 장애가 보입니다. 이건 설정을 늘리는 것보다 빼는 쪽에서 더 많이 배운 부분이에요.

이런 작업은 알림이 필요 없다: 과한 모니터링의 경계
모든 작업에 알림을 붙이는 것도 답이 아니에요. 저도 한동안 크론마다 알림과 하트비트를 다 붙였다가, 정작 중요한 작업의 실패가 다른 알림에 묻힌 적이 있습니다. 그 뒤로 기준을 다시 세웠어요.
실패해도 다음 실행에서 자동으로 복구되는 작업에는 알림이 필요 없습니다. 주기가 짧은 캐시 갱신이 여기에 해당해요. 한 번 실패해도 다음 주기에 다시 돌기 때문에 알림은 노이즈만 만듭니다.
알림보다 주기적 점검이 나은 작업도 있어요. 디스크 사용량이나 로그 용량처럼 천천히 변하는 값은 실시간으로 울리기보다 하루 한 번 요약에서 보는 편이 낫습니다. 블로그 파이프라인도 하루 3~4편을 쓰지만, 공개까지 실패했을 때만 알면 충분하고 중간 단계마다 알릴 필요는 없었어요.
모니터링 자체가 부담이 되는 경우도 있습니다. 2026년 10월 6일 기준으로 제 서버에는 크론이 70개, 노트북에는 9개 돌고 있어요. 전부에 하트비트를 붙이면 감시할 대상만 늘고, 감시 스크립트가 서버 자원을 쓰는 만큼 본래 작업이 느려지기도 합니다. 감시는 정말 놓치면 안 되는 작업에만 붙이는 편이 맞다고 지금은 생각해요.
요약: 실패를 알게 만드는 3단계 점검표와 오늘 할 일
3단계 구조를 정리하면 이렇습니다. 래퍼에서 실패 시 exit 1을 내고 로그 경로를 절대 경로로 고정합니다. 실패는 웹훅으로 채널에 보내고, 웹훅 URL은 환경변수나 설정 파일에서 읽습니다. 성공 신호를 남기고, 예정 시각과 허용 시간이 지나도 신호가 없으면 감시가 알립니다.
설정이 끝나면 일부러 실패시켜 봅니다. 아래 명령으로 종료 코드를 확인하고, 웹훅이 실제로 울리는지 봐요.
/home/ailee/jobs/run_job.sh; echo "exit=$?"
무음 실패는 마커 파일의 시각을 일부러 오래전으로 되돌려서 확인합니다. 감시 스크립트가 알림을 보내면 정상이에요.
touch -t 202601010000 /home/ailee/jobs/.sync_ok
/home/ailee/jobs/watch.sh 60
다음 주까지 할 일은 세 가지로 적어 둘게요.
- cron 출력을 전부 로그 파일로 빼고, 래퍼에서 실패 시 exit 1이 나오는지 확인한다
- 예정 시각에 돌아야 하는 작업 가운데 가장 중요한 하나에만 하트비트를 붙인다
- 알림 채널을 긴급과 요약으로 나누고, 반복 실패는 상태가 바뀔 때만 보내도록 바꾼다
이 구조를 현재 운영 중인 작업에 적용하고 나서는, 멈춘 작업을 알림이 안 와서 뒤늦게 찾는 일은 줄었습니다. 다만 감시 크론이 죽으면 그걸 알 방법이 아직 없다는 한계는 그대로 남아 있어요.
1인 빌더 아일리고가 씁니다. 잘된 것도 망한 것도 적습니다. 영상은 제가 만든 ClipSquare 에서 나옵니다.
자주 나오는 질문
크론 작업이 실패하면 cron이 자동으로 알려주나요?
아니요, cron은 실패를 따로 알려 주지 않아요. 작업 출력이 있으면 메일로 넘기려고 시도할 뿐이고, 받을 곳이 없으면 그냥 사라집니다. 출력을 로그 파일로 빼 버리면 메일도 나가지 않아서 기본 설정 그대로는 실패가 조용히 묻혀요.
MAILTO로 크론 실패 메일을 받으면 되지 않나요?
MAILTO는 출력이 있을 때만 메일이 나가서, 출력을 로그로 돌리는 스크립트에서는 알림이 오지 않아요. 저도 메일이 스팸함으로 가서 실패를 한동안 놓쳤습니다. 메일 설정이 번거롭다면 실패할 때만 슬랙이나 디스코드 웹훅을 호출하는 쪽이 대개 더 확실해요.
크론 작업이 아예 실행되지 않은 것도 알림을 받을 수 있나요?
스크립트 안에서 실패를 잡는 방식으로는 아예 안 돈 경우를 잡을 수 없어요. 그래서 정해진 시간 안에 완료 신호가 오지 않으면 알려 주는 외부 감시 방식을 따로 붙여야 합니다. 무음 실패를 막으려면 이 부분이 핵심이에요.
웹훅 URL을 스크립트 안에 그대로 적어도 되나요?
권장하지 않아요. 웹훅 URL 자체가 비밀번호 역할을 해서, 노출되면 누구든 채널에 글을 올릴 수 있습니다. 권한을 좁힌 별도 설정 파일이나 환경변수에 두고 스크립트에서 읽는 편이 안전해요.
크론 로그 경로는 왜 절대 경로로 써야 하나요?
cron은 셸에서 직접 실행할 때와 PATH나 현재 디렉터리가 달라요. 상대 경로로 쓰면 로그가 엉뚱한 곳에 쌓여서 로그 파일이 안 생긴 것처럼 보일 수 있습니다. 처음 설정할 때 한참 헤맸던 부분이라 미리 절대 경로로 잡아 두세요.
스크립트 끝에 exit 0을 붙이면 왜 실패를 못 잡나요?
cron은 종료 코드로 성공과 실패를 판단해요. 중간 명령이 실패해도 마지막에 exit 0으로 끝나면 cron은 성공으로 기록합니다. 실패 시 exit 1로 끝나도록 래퍼를 두는 것이 알림 설정 전에 해야 할 첫 단계예요.
