메트릭
Metrics 페이지(사이드바 > Metrics)는 API 사용량에 대한 더 깊은 분석 뷰를 제공합니다. 전체 결과 분포를 보여주며, API 키, 클라이언트 IP 또는 대상 도메인별로 트래픽을 분류합니다.
실시간 요약 카드 및 타임라인 차트(동시성, 요청, 바이트, 응답 시간, 예산)의 경우 Dashboard Overview 페이지를 사용하십시오.
필터
페이지 상단에는 API 키 선택기와 간격 선택기라는 두 가지 컨트롤이 있습니다.
키 필터
API Key 드롭다운을 사용하여 페이지의 범위를 특정 키로 지정하십시오. 개인 키, 귀하가 관리하는 조직 키 또는 팀을 통해 공유된 키 등 액세스 범위 내의 키만 표시됩니다.
간격 선택기
시간 범위를 제어하려면 간격 버튼을 사용하십시오:
| 버튼 | 기간 |
|---|---|
| 1M | 최근 1분 |
| 5M | 최근 5분 |
| 30M | 최근 30분 |
| 1H | 최근 1시간 |
| 6H | 최근 6시간 |
| 1D | 최근 24시간 |
도넛 차트와 테이블 모두 선택한 항목을 따릅니다.
결과 분포
상단의 도넛 차트는 선택한 간격에 대한 성공/오류 내역을 보여줍니다. 조각에 마우스를 올리면 정확한 요청 수와 백분율을 확인할 수 있습니다. 성공률의 갑작스러운 하락이 특정 결과 범주와 일치하는지 신속하게 파악할 때 사용하십시오.
결과 유형
모든 API 요청은 정확히 하나의 결과로 분류됩니다. success만 청구 가능 할당량에 포함됩니다.
| 결과 | 계층 | 의미 |
|---|---|---|
success |
해당 없음 | 요청이 유효한 응답을 전달했습니다. validate 규칙이 없으면 HTTP 200을 의미합니다. validate 규칙을 보낸 경우 규칙에서 허용한 모든 응답은 HTTP 상태에 관계없이 성공으로 간주됩니다. |
application_error |
target | 대상이 HTTP 200을 반환했지만, 응답 본문에 오류 필드가 포함되어 있습니다. |
application_fail |
target | 대상이 validate 규칙에서 허용하지 않는 2xx가 아닌 상태를 반환했거나, 응답을 전혀 반환하지 않았습니다. |
client_error |
caller | 잘못된 매개변수, 잘못된 형식의 프록시 값 또는 프라이빗/예약된 IP로 해석되는 URL(SSRF 방어)로 인해 요청이 FourA를 떠나기 전에 거부되었습니다. |
rate_limit |
FourA | RPM 또는 동시성 제한으로 인해 요청이 거부되었습니다. Rate Limits를 참조하십시오. |
service_error |
FourA | 백엔드가 5xx를 반환했거나, 구문 분석할 수 없는 본문으로 응답했습니다. |
service_fail |
FourA | 네트워크 오류: 시간 초과, 연결 거부, DNS 오류, 클라이언트 연결 해제. |
계층 열은 책임 소재를 나타냅니다. target은 호출한 사이트, caller는 요청이 잘못됨, FourA은 처리할 수 없음을 의미합니다.
특정 200이 아닌 코드(예: [200, 403])를 허용하기 위해 validate.status.accept을 사용하는 경우 해당 응답은 application_fail 대신 success으로 반환됩니다. 분류는 원시 HTTP 코드가 아니라 엔진이 규칙에 대해 내린 판정을 따릅니다.
전체 분류 및 청구 매핑 방법은 Request Outcomes을 참조하십시오.
다중 뷰 사용량 테이블
도넛 차트 아래의 사용량 테이블은 트래픽을 분석하여 3개의 뷰 탭으로 제공합니다:
| 탭 | 데이터 그룹화 기준 |
|---|---|
| API Key | 각 API Key |
| Client IP | request를 요청하는 소스 IP 주소 |
| Domain | request의 타겟 도메인 |
각 탭은 표시되는 열을 변경하는 우측의 scope 칩을 지원합니다:
| Scope | 표시 내용 |
|---|---|
| Bandwidth | request 수, 수신 바이트, 송신 바이트 |
| Response Time | request 수, 최소, 평균 및 최대 지연 시간 |
| Concurrency | request 수 및 동시 request 수 (API Key 뷰 전용) |
| Outcomes | request 수 및 결과별 내역 |
| Budget | request 수 및 사용된 크레딧 (Single, Proxy, Browser 등 제품별 분석) |
Budget scope는 모든 request에서 API가 기록하는 credits 메트릭을 읽어옵니다 (Response Headers 참조). 합계는 측정된 원시 비용입니다. 청구 시 요금제에 대해 success 결과만 계산합니다.
열 헤더를 클릭하여 해당 열을 기준으로 정렬합니다. 정렬 상태는 페이지가 로드될 때 각 테이블마다 유지됩니다. 헤더를 초기화하려면 Ctrl 또는 Cmd 키를 누른 상태에서 클릭하십시오.
관련 문서
- Dashboard Overview: 실시간 통계 및 타임라인 차트
- Request Outcomes: 7가지 결과 값에 대한 상세 설명
- Response Headers: 크레딧 출처
- API Errors: 네트워크를 통한 오류 반환 방식