CronBark지원연동 가이드

연동 가이드

5분이면 충분해요

기존 crontab 한 줄도 바꾸지 않고 연결할 수 있어요

Python SDK · Ping · REST API · CLI 4가지 중 워크플로우에 맞는 것을 고르세요.

빠른 시작 · 3단계

연동 방식 비교

각 방식의 trade-off
방식난이도세밀도최적 케이스
Ping (curl)
cb_live_a8f3.../ping
쉬움성공만 보고단순 cron 끝에 && curl 추가만 필요할 때가이드
Python SDK
pip install cronbark
쉬움start·success·fail 자동Python 스크립트, APScheduler, Airflow가이드
REST API
POST .../start|success|fail
보통명시적 이벤트시작 시각·실패 메시지·소요 시간 분석가이드
CLI
cronbark start/success/fail
쉬움4 서브커맨드bash 스크립트 안에서 명시 호출가이드
Python SDK
전체 문서
bash
$ pip install cronbark
python
import cronbark
 
cronbark.configure(token="cb_live_a8f3...")
 
# 컨텍스트 매니저 (자동)
with cronbark.monitor():
    run_daily_backup()
 
# 데코레이터
@cronbark.job(token="cb_live_...")
def generate_report():
    ...
Ping · 가장 간단
전체 문서
crontab
# 기존 cron entry
0 3 * * * /usr/bin/python /app/backup.py
 
# CronBark 연결
0 3 * * * /usr/bin/python /app/backup.py \
  && curl https://api.cronbark.com/p/cb_live_a8f3
💡 Ping은 성공만 알려요. 실패까지 잡으려면 || curl .../fail를 추가하거나 REST API를 쓰세요.
REST API · 세밀한 제어
전체 문서
bash
# 시작 이벤트
curl -X POST \
  https://api.cronbark.com/h/cb_live_a8f3/start
 
# 성공
curl -X POST .../success
 
# 실패 (메시지 첨부 가능)
curl -X POST .../fail \
  -H "Content-Type: application/json" \
  -d '{"message":"DB connection refused"}'
CLI · bash에서 자유롭게
전체 문서
bash
# SDK 설치 시 cronbark 명령어 자동 제공
$ pip install cronbark
 
# 단순 ping
$ backup.py && cronbark ping $TOKEN
 
# 세밀하게 (start / success / fail)
$ cronbark start $TOKEN
$ backup.py && cronbark success $TOKEN \
  || cronbark fail $TOKEN --msg "백업 실패"
전체 API 레퍼런스 보기
모든 엔드포인트, 상태 코드, SDK API, 고급 예제 — docs.cronbark.com
문서 열기

자주 묻는 연동 질문

전체 FAQ →
Q. API 토큰이 유출됐어요. 어떻게 해야 하나요?
크론잡 상세 > 토큰 / 연동 탭에서 즉시 회전(Rotate)하세요. 기존 토큰은 무효화되고 새 토큰이 발급됩니다.
Q. 연동이 잘 됐는지 어떻게 확인하나요?
크론잡 상세 > 실행 이력 탭에 ping이 도착하면 즉시 표시돼요. 보통 3초 이내. 알림 채널이 연결됐는지는 채널의 '테스트 발송' 버튼으로 확인하세요.
Q. Ping과 REST API 중 무엇을 써야 하나요?
성공 여부만 보고하면 Ping, 시작 시각·실패 메시지·소요 시간 같은 세밀한 제어가 필요하면 REST API를 권장해요.
Q. Python 외 다른 언어도 연동되나요?
REST API와 Ping은 curl만 있으면 모든 언어에서 연동돼요. 전용 SDK는 현재 Python을 지원하며 Node.js SDK가 다음 분기 예정입니다.