빠른 시작 — 3분 안에 첫 Cronjob 모니터링
이 가이드는 가장 빠른 연동 방식인 **Ping(GET)**을 사용합니다. SDK 설치 없이 curl 한 줄로 시작할 수 있습니다.
대시보드 URL이 아직 없다면, 조직 관리자에게 CronBark 초대를 요청하거나 회원가입 페이지에서 계정을 만드세요. 가입 방식은 두 가지입니다.
- Google OAuth — Google 계정으로 즉시 로그인
- 이메일 / 비밀번호 — Gmail · Naver · Daum · Kakao · 회사 이메일 등 어떤 이메일이든 가입 가능
이메일 가입 시 인증 메일의 링크를 클릭해야 로그인할 수 있습니다. 인증 전 로그인 시도는 403으로 차단됩니다.
1. Cronjob 등록 & API 토큰 발급
- CronBark 대시보드에 로그인
- Cronjobs → 새 Cronjob 버튼 클릭
- 이름 · 스케줄(cron expression) · 타임아웃을 입력하고 저장
- 생성된 Cronjob 상세 페이지에서 API 토큰을 복사
Cronjob을 생성하면 기본 API 토큰 1개가 자동으로 함께 발급됩니다. 별도의 “토큰 발급” 단계를 거치지 않아도, 상세 페이지에서 바로 복사해 Ping·REST·SDK·CLI 어디에든 사용할 수 있습니다. 추가 토큰(스테이징 분리 등)이 필요하면 상세 페이지의 API 토큰 섹션에서 새 토큰을 생성하세요.
2. 실행 스크립트에 Ping 한 줄 추가
아래 중 환경에 맞는 예제를 골라서 기존 스크립트에 추가하세요. {token} 자리에 위에서 복사한 토큰을 넣으면 됩니다.
# 매 5분마다 backup.sh 실행 후 결과를 CronBark에 보고
*/5 * * * * /scripts/backup.sh && \
curl -s https://api.cronbark.com/api/v1/ping/{token} || \
curl -s https://api.cronbark.com/api/v1/ping/{token}/fail3. 알림 채널 연결
- 대시보드 Alert Channels 메뉴로 이동
- Slack Webhook URL 또는 이메일 추가
- Cronjob 상세 → Alert Rules 탭에서 알림 조건 선택
- 실패 즉시
- 지연 N분 (예: 5분 이상 걸리면)
- 타임아웃 T분 (예: 30분을 초과하면)
4. 대시보드에서 확인
대시보드 메인 페이지에서 60초마다 자동 새로고침되는 실시간 상태를 확인하세요.
다음 단계
- Ping 연동 상세 — 전체 엔드포인트 목록과 예제
- Python SDK — 컨텍스트 매니저로 더 깔끔하게
- CLI —
cronbark exec로 기존 crontab을 수정 없이 감싸기 - 상태 판정 로직 — CronBark이 실패·지연·타임아웃을 판단하는 기준