모니터

모니터란?

모니터는 하나의 API나 작업의 상태를 나타내는 프로젝트 리소스입니다. 이벤트는 모니터 slug를 기준으로 연결됩니다. 결과는 ok, degraded, down, error 같은 상태로 표현할 수 있습니다.

REST로 모니터 만들기

관리 API 키의 admin:write scope가 필요합니다.

curl -X POST https://crm.theseeker.io/api/v1/monitors \
  -H "Authorization: Bearer $THESEEKER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectSlug":"payments",
    "slug":"checkout-api",
    "name":"Checkout API",
    "intervalSec":60,
    "degradedAfter":120,
    "downAfter":240
  }'

응답은 201이며 monitor 객체를 담습니다. 같은 프로젝트에서 slug는 중복될 수 없습니다.

목록과 변경

목록 조회에는 admin:read 또는 모니터 상태를 읽을 수 있는 키가 필요합니다.

curl "https://crm.theseeker.io/api/v1/monitors?projectSlug=payments" \
  -H "Authorization: Bearer $THESEEKER_API_KEY"

모니터의 이름, 주기, 상태 전환 설정은 UI 또는 관리 API에서 관리합니다. 이벤트를 보낼 때는 프로젝트 키와 모니터 slug를 사용하세요.

운영 팁

intervalSec는 정상 이벤트가 도착해야 하는 예상 간격입니다. 외부 서비스의 실제 SLA보다 너무 짧게 설정하면 일시적인 네트워크 지연이 장애로 보일 수 있습니다.