문서

빠른 시작

1. 로그인 후 대시보드에서 "새 모니터링 항목"을 클릭하고, 작업 이름과 체크인 간격을 설정하세요.
2. 모니터링 항목의 Ping URL을 복사하세요.
3. 작업이 성공적으로 실행될 때마다 이 URL을 요청하도록 설정하세요.
4. 설정한 간격 내에 체크인이 없으면 즉시 알려드립니다.

Ping URL

모든 모니터링 항목에는 아래 형식의 전용 Ping URL이 있습니다 (api_key는 교체 가능한 키이며 모니터링 항목 자체와는 무관합니다):

https://ping.doyouok.com/ping/{api_key}

GET 또는 POST 요청을 지원하며 항상 고정된 200 상태 코드를 반환합니다. api_key의 유효 여부와 관계없이 응답에서 어떤 정보도 노출되지 않아 무차별 대입 추측을 방지합니다.

경로	용도
/ping/{api_key}	체크인 (하트비트)
/ping/{api_key}/start	작업 시작을 표시 (태스크 모드에서만 실행 시간 계산에 사용)

Ping URL이 유출된 경우 대시보드에서 언제든지 교체(Rotate)할 수 있습니다. 이전 URL은 즉시 무효화되며 모니터링 항목을 다시 만들 필요가 없습니다.

하트비트 모드 (LifeMonitor)

"계속 발생해야 하지만 반드시 고정된 일정으로 실행되지는 않는" 프로세스에 적합합니다. 예약 작업(예: "매일 새벽 백업 실행")일 수도 있고, 이벤트 기반 프로세스(예: 웹훅을 받을 때마다, 주문을 처리할 때마다 체크인)일 수도 있습니다. 설정한 간격 내에 Ping을 한 번이라도 받으면 모니터링 항목은 Up 상태를 유지합니다. 간격이 지나도 Ping을 받지 못하면 모니터링 항목은 Down으로 바뀌고 알림이 발송됩니다.

태스크 모드 (TaskMonitor)

실행마다 로그와 소요 시간을 기록하고 싶은 작업에 적합합니다. /start와 종료 시점의 체크인을 함께 사용하면 이번 실행의 소요 시간을 기록할 수 있습니다. 종료 체크인만 요청하면 소요 시간이 없는 실행 로그가 기록됩니다.

모니터링 항목 상태

• New —— 방금 생성되어 아직 체크인을 받지 못한 상태입니다.
• Up —— 정상적으로 체크인 중이며 모든 것이 정상입니다.
• Down —— 설정한 간격 내에 체크인을 받지 못해 알림이 발송되었습니다.

알림 방식

모니터링 항목이 타임아웃되면 알림을 보냅니다. 첫 번째는 최초 알림이며, 계속 복구되지 않으면 마지막 알림을 보내 한 번의 장애당 최대 2회까지 발송됩니다. 체크인을 한 번이라도 받으면 카운트가 즉시 초기화됩니다.