> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 모범 사례 및 폴링

> 안정성, 성능, 효율적인 전달을 위해 모니터 설정을 최적화하세요.

## 실시간 빈도

`frequency_minute` 파라미터는 모니터의 스캔 빈도를 제어합니다.

| 설정            | 동작                            | 사용 사례                   |
| ------------- | ----------------------------- | ----------------------- |
| **`0` (기본값)** | **실시간** — 신호가 나타나는 즉시 감지 및 전달 | 대부분의 모니터 — 가장 빠른 전달     |
| `1 - 60`      | 고정 간격(분)                      | 예측 가능한 주기가 필요할 때        |
| `60 - 1440`   | 시간별\~일별                       | 다이제스트 형식 요약, 낮은 우선순위 신호 |

<Tip>
  `frequency_minute: 0`으로 설정하면, Pubrio가 신호가 나타나는 즉시 감지하고 전달합니다 — 폴링 불필요, 지연 없음.
</Tip>

***

## 재시도 구성

Webhook 전달이 실패하면, 재시도가 자동 복구에 도움이 됩니다.

| 파라미터                    | 범위    | 기본값 | 권장                     |
| ----------------------- | ----- | --- | ---------------------- |
| `max_retry_per_trigger` | 0 - 3 | 1   | 중요한 모니터는 2-3으로 설정      |
| `retry_delay_second`    | 1 - 5 | 1   | 일시적인 문제 해결을 위해 3-5초 사용 |

<Note>
  재시도는 동일한 페이로드를 다시 전달합니다 — 신호 감지를 다시 실행하지 않으며, 추가 검색 크레딧도 발생하지 않습니다.
</Note>

***

## 프로세스 재시도

[프로세스 재시도](/ko/api-reference/endpoint/monitors/process_retry) 엔드포인트를 사용하면 특정 실패한 전달을 다시 시도할 수 있습니다. 주요 이점:

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

[통계 로그](/ko/api-reference/endpoint/monitors/statistics_logs)에서 실패한 전달을 확인하고 개별적으로 재시도하세요.

***

## 실패 처리

`max_failure_trigger` 파라미터(범위: 1-10, 기본값: 5)는 모니터가 자동으로 일시 중지되기 전에 허용되는 연속 전달 실패 횟수를 제어합니다.

**권장 접근 방식:**

1. 실패 발생 시 알림을 받기 위해 `notification_email`을 설정
2. 프로덕션 모니터는 `max_failure_trigger`를 3-5로 유지
3. [통계 로그](/ko/api-reference/endpoint/monitors/statistics_logs)를 사용하여 실패 진단 — `error_message`와 `response_status_code` 확인
4. 문제 수정 후 [모니터 업데이트](/ko/api-reference/endpoint/monitors/update)를 통해 다시 활성화
5. [프로세스 재시도](/ko/api-reference/endpoint/monitors/process_retry)를 사용하여 특정 실패 전달을 재시도

***

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

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

### 개요 폴링

[모니터 통계](/ko/api-reference/endpoint/monitors/statistics)를 사용하여 대시보드 수준의 상태 확인을 수행합니다:

<CodeGroup>
  ```bash cURL theme={null}
  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 }'
  ```
</CodeGroup>

집계 지표를 반환합니다: 총 모니터 수, 오늘과 어제의 트리거 수, 성공률, 비교율.

### 로그 기반 폴링

[통계 로그](/ko/api-reference/endpoint/monitors/statistics_logs)를 사용하여 트리거 기록을 검토합니다:

<CodeGroup>
  ```bash cURL theme={null}
  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
    }'
  ```
</CodeGroup>

각 로그 항목에는 상태, 크레딧 사용량, 신호/기업/인물 수, 처리 시간, 오류 세부 정보가 포함됩니다.

<Tip>
  최대 안정성을 위해 webhook 전달과 주기적인 로그 폴링을 결합하세요: webhook이 실시간 처리를 담당하고, 로그 폴링이 누락된 전달을 포착하고 감사 추적을 제공합니다.
</Tip>

***

## 스케일링 권장 사항

<AccordionGroup>
  <Accordion title="집중된 모니터 vs. 광범위한 필터">
    **너무 광범위한 모니터보다 집중된 모니터를 선호하세요.** "미국 엔터프라이즈 기업의 AI 채용"을 추적하는 모니터는 "모든 곳의 모든 채용"보다 디버깅이 쉽습니다. 집중된 모니터는 또한 다른 신호 유형을 다른 webhook 엔드포인트로 라우팅할 수 있습니다.
  </Accordion>

  <Accordion title="Webhook 엔드포인트 안정성">
    Webhook 엔드포인트는 다음을 충족해야 합니다:

    * 30초 이내 응답
    * 즉시 `200`을 반환하고 데이터를 비동기적으로 처리
    * 중복 페이로드를 정상적으로 처리(멱등성)
    * 디버깅을 위해 모든 수신 페이로드를 로깅
  </Accordion>

  <Accordion title="다수의 모니터 관리">
    [모니터 목록 가져오기](/ko/api-reference/endpoint/monitors/monitors)를 필터링과 함께 사용:

    * `detection_mode` 및 `destination_type`으로 필터링
    * `last_modified` 또는 `last_trigger_at`로 정렬
    * `search_term`으로 이름 검색

    [모니터 통계](/ko/api-reference/endpoint/monitors/statistics)를 사용하여 성능이 낮은 모니터를 빠르게 발견하세요.
  </Accordion>
</AccordionGroup>