메인 콘텐츠로 건너뛰기

​
실시간 빈도

frequency_minute 파라미터는 모니터의 스캔 빈도를 제어합니다.
설정동작사용 사례
0 (기본값)실시간 — 신호가 나타나는 즉시 감지 및 전달대부분의 모니터 — 가장 빠른 전달
1 - 60고정 간격(분)예측 가능한 주기가 필요할 때
60 - 1440시간별~일별다이제스트 형식 요약, 낮은 우선순위 신호
frequency_minute: 0으로 설정하면, Pubrio가 신호가 나타나는 즉시 감지하고 전달합니다 — 폴링 불필요, 지연 없음.

​
재시도 구성

Webhook 전달이 실패하면, 재시도가 자동 복구에 도움이 됩니다.
파라미터범위기본값권장
max_retry_per_trigger0 - 31중요한 모니터는 2-3으로 설정
retry_delay_second1 - 51일시적인 문제 해결을 위해 3-5초 사용
재시도는 동일한 페이로드를 다시 전달합니다 — 신호 감지를 다시 실행하지 않으며, 추가 검색 크레딧도 발생하지 않습니다.

​
프로세스 재시도

프로세스 재시도 엔드포인트를 사용하면 특정 실패한 전달을 다시 시도할 수 있습니다. 주요 이점:
  • 실패 시 과금 없음 — 전달이 실패하면 크레딧이 소비되지 않습니다. 크레딧은 성공적인 전달 시에만 과금됩니다.
  • 문제 해결 — 실패한 로그 항목을 재시도하여 새 트리거를 생성하지 않고도 Webhook 문제를 진단할 수 있습니다.
  • 원본 대상 옵션 — is_use_original_destination을 사용하면 원본 로그의 대상 스냅샷으로 재시도할 수 있습니다. 장애 후 Webhook URL을 업데이트한 경우에 유용합니다.
통계 로그에서 실패한 전달을 확인하고 개별적으로 재시도하세요.

​
실패 처리

max_failure_trigger 파라미터(범위: 1-10, 기본값: 5)는 모니터가 자동으로 일시 중지되기 전에 허용되는 연속 전달 실패 횟수를 제어합니다. 권장 접근 방식:
  1. 실패 발생 시 알림을 받기 위해 notification_email을 설정
  2. 프로덕션 모니터는 max_failure_trigger를 3-5로 유지
  3. 통계 로그를 사용하여 실패 진단 — error_message와 response_status_code 확인
  4. 문제 수정 후 모니터 업데이트를 통해 다시 활성화
  5. 프로세스 재시도를 사용하여 특정 실패 전달을 재시도

​
통계 엔드포인트를 통한 폴링

Webhook이 실시간 전달을 처리하는 동안, 통계 엔드포인트는 모니터링, 디버깅, 감사 기능을 제공합니다.

​
개요 폴링

모니터 통계를 사용하여 대시보드 수준의 상태 확인을 수행합니다: 
curl -X POST https://api.pubrio.com/monitors/statistics \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{ "profile_id": 1 }'
집계 지표를 반환합니다: 총 모니터 수, 오늘과 어제의 트리거 수, 성공률, 비교율.

​
로그 기반 폴링

통계 로그를 사용하여 트리거 기록을 검토합니다: 
curl -X POST https://api.pubrio.com/monitors/statistics/logs \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "profile_id": 1,
    "monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "page": 1,
    "per_page": 10
  }'
각 로그 항목에는 상태, 크레딧 사용량, 신호/기업/인물 수, 처리 시간, 오류 세부 정보가 포함됩니다.
최대 안정성을 위해 webhook 전달과 주기적인 로그 폴링을 결합하세요: webhook이 실시간 처리를 담당하고, 로그 폴링이 누락된 전달을 포착하고 감사 추적을 제공합니다.

​
스케일링 권장 사항

너무 광범위한 모니터보다 집중된 모니터를 선호하세요. “미국 엔터프라이즈 기업의 AI 채용”을 추적하는 모니터는 “모든 곳의 모든 채용”보다 디버깅이 쉽습니다. 집중된 모니터는 또한 다른 신호 유형을 다른 webhook 엔드포인트로 라우팅할 수 있습니다.
Webhook 엔드포인트는 다음을 충족해야 합니다:
  • 30초 이내 응답
  • 즉시 200을 반환하고 데이터를 비동기적으로 처리
  • 중복 페이로드를 정상적으로 처리(멱등성)
  • 디버깅을 위해 모든 수신 페이로드를 로깅
모니터 목록 가져오기를 필터링과 함께 사용:
  • detection_mode 및 destination_type으로 필터링
  • last_modified 또는 last_trigger_at로 정렬
  • search_term으로 이름 검색
모니터 통계를 사용하여 성능이 낮은 모니터를 빠르게 발견하세요.