메트릭
메트릭 페이지(사이드바 > 메트릭)는 API 사용량에 대한 더 깊은 분석 보기를 제공합니다. 전체 결과 분포를 보여주고 API key, 클라이언트 IP 또는 대상 도메인별로 트래픽을 세분화하여 보여줍니다.
실시간 요약 카드 및 타임라인 차트(Concurrency, Requests, Bytes, Response Time)는 Dashboard Overview 페이지를 사용하세요.
필터
페이지 상단에는 API key 선택기와 인터벌 선택기라는 두 가지 컨트롤이 있습니다.
Key 필터
API Key 드롭다운을 사용하여 페이지 범위를 특정 키로 제한할 수 있습니다. 개인 키, 관리 중인 조직 키 또는 팀을 통해 공유된 키 등 귀하의 액세스 범위 내에 있는 키만 표시됩니다.
인터벌 선택기
인터벌 버튼을 사용하여 시간 범위를 제어할 수 있습니다.
| 버튼 | 범위 |
|---|---|
| 1M | 최근 1분 |
| 5M | 최근 5분 |
| 30M | 최근 30분 |
| 1H | 최근 1시간 |
| 6H | 최근 6시간 |
| 1D | 최근 24시간 |
도넛 차트와 테이블 모두 선택한 설정을 따릅니다.
결과 분포
상단의 도넛 차트는 선택한 인터벌 동안의 성공/오류 분석을 보여줍니다. 슬라이스 위에 마우스를 올리면 정확한 request 수와 백분율을 볼 수 있습니다. 이를 통해 성공률의 급격한 감소가 특정 결과 카테고리와 일치하는지 신속하게 파악할 수 있습니다.
결과 유형
모든 API request는 정확히 하나의 결과로 분류됩니다. 청구 가능한 쿼터에는 success만 반영됩니다.
| 결과 | 레이어 | 의미 |
|---|---|---|
success |
해당 없음 | request가 유효한 response를 전달했습니다. validate 규칙이 없으면 이는 HTTP 200을 의미합니다. validate 규칙을 보낸 경우, HTTP 상태에 관계없이 규칙이 수락한 모든 response가 성공으로 간주됩니다. |
application_error |
target | 대상이 HTTP 200을 반환했지만 response body에 오류 필드가 포함되어 있습니다. |
application_fail |
target | 대상이 validate 규칙에서 수락하지 않은 2xx 이외의 상태를 반환했거나 response가 전혀 없습니다. |
client_error |
caller | request가 FourA를 떠나기 전에 거부되었습니다. 잘못된 매개변수, 잘못된 형식의 proxy 값 또는 사설/예약 IP로 확인되는 URL(SSRF 보호)이 원인일 수 있습니다. |
rate_limit |
FourA | RPM 또는 동시성 제한으로 인해 request가 거부되었습니다. Rate Limits를 참조하세요. |
service_error |
FourA | 백엔드가 5xx를 반환했거나 파싱할 수 없는 body로 응답했습니다. |
service_fail |
FourA | 네트워크 실패: 타임아웃, 연결 거부, DNS 오류, 클라이언트 연결 끊김 등입니다. |
레이어 열은 누구에게 책임이 있는지 알려줍니다. target은 호출한 사이트를 의미하고, caller는 귀하의 request가 잘못되었음을 의미하며, FourA는 당사에서 처리할 수 없었음을 의미합니다.
특정 200 이외의 코드를 허용하기 위해 validate.status.accept를 사용하는 경우(예: [200, 403]), 해당 response는 application_fail 대신 success로 반환됩니다. 분류는 원시 HTTP 코드가 아니라 귀하의 규칙에 대한 엔진의 판단을 따릅니다.
전체 분류 체계 및 이것이 빌링에 어떻게 매핑되는지 보려면 Request Outcomes를 참조하세요.
다중 보기 사용량 테이블
도넛 차트 아래의 사용량 테이블은 세 개의 보기 탭으로 트래픽을 세분화하여 보여줍니다.
| 탭 | 데이터 그룹화 기준 |
|---|---|
| API Key | 각 API key |
| Client IP | request를 보내는 소스 IP 주소 |
| Domain | request의 대상 도메인 |
각 탭은 표시되는 열을 변경하는 오른쪽의 네 가지 범위 칩을 지원합니다.
| 범위 | 표시 내용 |
|---|---|
| Bandwidth | Request 수, 수신 바이트, 송신 바이트 |
| Response Time | Request 수, 최소, 평균 및 최대 레이턴시 |
| Concurrency | Request 수 및 동시 request 수 (API Key 보기에만 해당) |
| Outcomes | Request 수 및 결과별 분석 |
관련 문서
- Dashboard Overview: 실시간 통계 및 타임라인 차트
- Request Outcomes: 7가지 결과 값에 대한 자세한 설명
- API Errors: 네트워크를 통해 오류가 반환되는 방식