메트릭
Metrics 페이지(사이드바 > Metrics)에서는 사용량에 대한 심층적인 분석 뷰를 제공합니다. 이 페이지에는 트래픽을 그룹별로 나누고 행 목록 상단에 전체 기간의 총계를 표시하는 단일 패널인 Usage가 포함되어 있습니다.
요약 카드와 타임라인 차트는 Dashboard Overview 페이지를 참조하십시오.
제품
페이지 상단에는 Product 전환 스위치가 있습니다. API 엔드포인트로 전송하는 요청을 확인하는 API와 자체 도구가 proxy.foura.ai를 통해 여는 터널을 확인하는 Proxy가 있습니다. 터널에는 요청 수와 크레딧이 없으므로, 각 제품은 고유한 뷰, 범위 및 열을 갖춘 별도의 Usage 패널을 가집니다. 선택한 스위치 상태는 저장되며 #metrics/proxy 형태로 딥 링크가 지원됩니다.
필터
패널 상단에는 Product, Endpoints(API 전용), Owner, Key(API) 또는 Proxy user(Proxy), Period 필터가 있습니다. Owner와 Period는 Overview와 동일한 컨트롤이며 상태를 공유하므로, 두 페이지 간을 전환해도 조회 대상이 변경되지 않습니다.
소유자 필터
Everything, Personal, 또는 소속 조직 중 하나를 선택할 수 있습니다. 최소 하나의 조직에 속해 있어야만 표시됩니다. 소유자를 선택하면 Key 및 Proxy user 드롭다운도 새로 구성되므로, 이전 소유자의 자격 증명이 그대로 유지되어 빈 결과가 반환되는 상황을 방지합니다.
선택한 소유자에게 정지된 키를 포함해 API 키가 전혀 없는 경우, 기간 필터 아래 줄에 **You have no API keys here yet. Create one to see its usage.**라는 문구가 표시됩니다. 집계할 데이터가 없으므로 패널에는 0이 표시됩니다. 자세한 내용은 Managing API Keys를 참조하십시오.
키 및 프록시 사용자 필터
페이지 범위를 단일 자격 증명으로 제한합니다. 본인 소유의 자격 증명 및 소속 조직의 자격 증명 등 접근 권한이 있는 자격 증명만 표시됩니다.
기간
30M, 3H, 12H, 24H, 7D, 30D, 90D, 1Y 등 8개의 버튼이 제공되며, 특정 달, 최근 6개월, 전체 기간 또는 지정한 날짜 범위를 설정할 수 있는 Custom 옵션도 지원합니다.
엔드포인트
API 제품에서는 Single, Proxy Finder, Browser, Auto 중 하나를 선택하여 카드와 테이블 범위를 단일 엔드포인트로 제한할 수 있습니다. Auto 호출은 Auto 항목 아래에서 1회로 계산됩니다. 엔드포인트를 선택한 상태에서는 Concurrency 범위를 사용할 수 없습니다.
사용량 패널
이 패널은 두 가지 정보를 한 번에 제공합니다. 테이블 상단 카드는 전체 기간을 나타내며, 포함된 그룹 수와 전체 그룹에 걸친 총계를 보여줍니다. 하단 테이블은 선택한 열 기준으로 정렬된 그룹의 단일 페이지입니다.
두 영역은 항상 동일한 트래픽을 다룹니다. 카드는 테이블 행과 동일한 기간 및 필터를 적용합니다. 그룹 수는 반올림되지 않고 전체 숫자로 표시됩니다. 이번 달에 접근한 도메인 수가 몇 개인지 확인할 때는 반올림된 수치 대신 정확한 수치가 필요하기 때문입니다.
뷰, 범위 또는 기간을 변경하면 데이터 세트가 첫 페이지부터 다시 시작됩니다. 도메인의 4페이지와 클라이언트 IP의 4페이지는 서로 일치하지 않습니다.
열 헤더를 클릭하여 정렬합니다. API 제품의 Domain 및 Client IP 뷰에서는 페이지로 나누어지기 전에 전체 목록을 대상으로 정렬이 실행되므로 첫 번째 행이 실제로 가장 큰 값이 되며, 테이블은 첫 페이지부터 다시 시작합니다. API Key 뷰는 모든 키를 단일 목록에 유지하고 그 자리에서 바로 정렬합니다. 뷰나 범위를 전환하거나 페이지를 새로고침하면 정렬 상태가 해당 범위의 기본 순서로 초기화됩니다. 즉, 요청이 가장 많은 순서로 정렬되거나 Routes 아래에서는 Auto의 브라우저 시도가 가장 많은 순서로 정렬됩니다. 헤더를 Ctrl 또는 Cmd 클릭하면 재설정됩니다. 첫 번째 열의 헤더에는 이름을 기준으로 행을 필터링하는 입력 필드(API 키 필터링..., IP 필터링..., 또는 도메인 필터링...)도 있습니다. Client IP 및 Domain 뷰에서는 현재 페이지만 검색하므로 다른 페이지에 있는 그룹은 표시되지 않습니다. Esc를 누르면 입력 내용이 지워집니다.
사용량, API 제품
세 가지 뷰:
| 뷰 | 데이터 그룹화 기준 |
|---|---|
| API Key | 액세스 권한이 있는 각 키 |
| Client IP | 요청을 보낸 소스 주소 |
| Domain | 요청의 대상 도메인 |
범위 칩을 선택하면 열과 카드가 변경됩니다:
| 범위 | 표시 내용 |
|---|---|
| Bandwidth | 요청 수, 수신 바이트, 송신 바이트, 해당 바이트 중 프리미엄 점유율(합계에 추가되는 것이 아니라 총합 내에 포함된 프리미엄 출구를 통해 전달된 트래픽) |
| Response Time | 요청 수, 최소, 평균, 최대 대기 시간 |
| Concurrency | 요청 수 및 동시 요청 수 (API Key 뷰 전용) |
| Outcomes | 요청 수 및 결과별 세부 내역, 결과 도넛 차트 포함 |
| Budget | 요청 수, 청구된 크레딧, 사용된 크레딧. 특정 endpoint를 확인하려면 Endpoints 행에서 선택합니다 |
| Routes | 요청 수, 경로별 요청 수, Auto가 호출 배후에서 실행한 작업, 각 Auto 호출에 응답한 단계 (아래 참조) |
Budget 범위는 청구된 크레딧과 사용된 크레딧을 구분하여 유지합니다. 청구된 크레딧은 success 결과가 발생한 요청만 계산하며, 이는 플랜에서 비용을 지불하는 대상입니다. 사용된 크레딧은 실패한 요청을 포함하여 API가 매 요청마다 보고하는 크레딧이며(Response Headers 참조), 청구되지 않습니다.
Budget 카드는 청구된 크레딧 하단에 총 N개 사용됨 중을 표시하며, 요청당 항목에는 요청당 평균 청구 크레딧을 표시합니다. 테이블에는 청구된 크레딧 및 사용된 크레딧 열이 포함되어 있으며, 둘 중 어느 쪽으로든 정렬할 수 있습니다.
Routes 범위
Routes는 각 키, 클라이언트 IP 또는 도메인의 요청을 경로별로 분할하고 Auto가 호출 시 수행한 작업을 표시합니다. 열은 세 개의 그룹으로 나뉘며 각각 위에 캡션이 표시됩니다:
| 그룹 | 열 | 집계 대상 |
|---|---|---|
| Requests by route | Single, Proxy Finder, Browser, Auto | 요청을 전송한 경로별 사용자 요청 수입니다. 이들을 합산하여 Requests가 됩니다. Auto 호출은 Auto 아래에 1회로 계산됩니다. 각 숫자 아래: Requests 내 해당 비중. |
| Auto attempts | Single, Proxy Finder, Browser | 실패한 시도를 포함하여 Auto가 각 호출 배후의 각 엔진에서 실행한 요청 수입니다. 각 숫자 아래: Auto 호출당 시도 횟수. |
| Auto answered by | Saved session, Plain request, Proxy Finder, Browser, Failed | 각 Auto 호출을 완료한 단계입니다. 이들을 합산하여 Auto가 됩니다. 각 숫자 아래: Auto 내 해당 비중. |
Saved session은 Auto가 호스트에 대해 이미 유지하고 있던 세션입니다. Browser에는 브라우저가 먼저 페이지를 연 후 해당 세션을 재생하여 응답을 전달한 호출이 포함됩니다. Failed에는 Auto가 실행되기 전에 거부된 호출이 포함됩니다.
Auto가 실제 브라우저를 사용하는 위치를 확인하려면 Auto attempts 아래의 Browser 열을 참조하십시오. 브라우저는 일반적으로 페이지를 한 번 열고 Auto는 더 가벼운 요청으로 해당 세션을 재사용하므로, 이 열은 대체로 Auto answered by의 Browser보다 훨씬 큽니다. Routes는 이 열을 기준으로 정렬되어 열리므로 브라우저가 가장 많이 필요한 도메인이 먼저 표시되며, 브라우저 시도가 없는 그룹은 요청 수 순으로 뒤따릅니다.
표 위의 카드에는 해당 기간 동안의 Auto attempts 및 Auto 호출당 시도 횟수, 그리고 직접 또는 Auto에 의해 열린 모든 브라우저가 표시됩니다.
Auto attempts는 Requests나 성공률에 절대 포함되지 않습니다. 단, Overview의 Auto attempts 카드에서와 같이 플랜의 Single, Proxy Finder, Browser rate limit 및 동시성 제한에는 반영됩니다. Endpoints 행에서 특정 endpoint를 선택하면 Routes에는 해당 경로만 표시됩니다. 이 경우 Browser에는 직접 보낸 브라우저 요청만 나열되고 Auto가 실행한 요청은 Auto 아래에 유지됩니다.
결과 도넛 차트
Outcomes 범위에서는 패널 내에 도넛 차트가 표시되어 선택한 기간의 성공 및 오류 분석을 보여줍니다. 조각 위에 마우스를 올리면 정확한 요청 수와 백분율을 확인할 수 있습니다. 다른 질문에 답하는 표 위에 전체 기간의 차트를 얹으면 서로 연관 없는 두 요소로 보이기 때문에, 이 차트는 해당 범위에서만 표시됩니다.
사용량, Proxy 제품
5가지 뷰:
| 뷰 | 데이터 그룹화 기준 |
|---|---|
| Proxy user | 접근 권한이 있는 각 프록시 사용자 |
| Target | 각 터널이 도달한 호스트 |
| Exit country | 터널이 나간 국가 |
| Client IP | 연결이 시작된 주소 |
| Outcome | 결과 및 발생 이유 |
4가지 범위:
| 범위 | 열 |
|---|---|
| Traffic | Tunnels, Bytes In, Bytes Out, Premium |
| Setup | Tunnels, Setup Min, Setup Avg, Setup Max, Duration Avg, Duration Max |
| Outcomes | Tunnels 및 결과별 1개 열, 결과 도넛 차트 포함 |
| Budget | Tunnels, Standard, Premium, Total |
Setup은 터널이 전달되기 전 대기 시간입니다. Duration은 이후 터널이 열려 있던 시간입니다. Premium은 프리미엄 네트워크를 통해 나간 트래픽의 일부로, 합계에 포함되어 계산되며 별도로 추가 합산되지 않습니다.
어떤 스코프에도 크레딧 열이나 요청 수 카운트가 없습니다. CONNECT 내부로 이동하는 것은 사용자 고유의 암호화된 트래픽이므로, 포트는 터널과 바이트만 카운트하며 그 외에는 아무것도 카운트하지 않습니다.
결과 유형
모든 API 요청은 정확히 하나의 결과로 분류됩니다. success에 대해서만 요금이 청구됩니다.
| 결과 | 레이어 | 의미 |
|---|---|---|
success |
해당 없음 | 요청이 유효한 응답을 반환했습니다. validate 규칙이 없으면 HTTP 200을 의미합니다. validate 규칙이 있으면 상태와 무관하게 규칙에서 수락한 모든 응답을 의미합니다. FourA가 감지한 확인 페이지나 거부 페이지는 결코 성공으로 처리되지 않습니다. |
application_error |
대상 | 대상이 HTTP 200을 반환했으나 본문에 오류 필드가 포함되어 있거나, 본문이 FourA에서 감지한 확인 페이지 또는 거부 페이지였습니다. |
application_fail |
대상 | 대상이 validate 규칙에서 수락하지 않은 2xx 이외의 코드를 반환했거나 응답이 전혀 없었습니다. |
client_error |
호출자 | 잘못된 매개변수, 잘못된 형식의 프록시 값, 사설 또는 예약된 주소로 확인되는 URL 등의 이유로 요청이 FourA를 벗어나기 전에 거부되었습니다. |
rate_limit |
FourA | 요청이 RPM 또는 동시성 제한에 의해 거부되었습니다. 속도 제한을 참고하십시오. |
service_error |
FourA | 엔진이 서버 오류를 반환했거나 파싱할 수 없는 본문을 반환했습니다. |
service_fail |
FourA | 네트워크 실패: 타임아웃, 연결 거부됨, DNS 오류, 클라이언트 연결 끊김. |
레이어 열은 누구에게 책임이 있는지를 나타냅니다. target는 호출한 사이트, caller은 잘못된 요청, FourA은 엔진에서 처리할 수 없었음을 의미합니다.
validate.status.accept를 사용하여 특정 200 이외의 코드(예: [200, 403])를 허용하는 경우, 해당 응답은 application_fail 대신 success로 반환됩니다. 분류는 원시 HTTP 코드가 아니라 사용자의 규칙에 대한 엔진의 판단을 따릅니다.
프록시 포트를 통과하는 터널은 두 가지 target 결과를 제외하고 동일한 분류 어휘로 분류됩니다. 터널의 응답은 사용자 자신의 암호화된 트래픽이므로 FourA는 그 뒤의 사이트 응답 상태를 감지할 수 없습니다. 전체 분류 체계와 청구 매핑 방식에 대한 자세한 내용은 요청 결과를 참고하십시오.