대시보드 개요
FourA Dashboard는 API key 및 proxy 사용자를 관리하고, 테스트 request를 실행하며, 성능을 모니터링하고, 결제를 처리하며, 계정을 설정하는 공간입니다. 이 페이지에서는 기본 Overview 화면과 사이드바 섹션을 안내합니다.
Dashboard 접속
foura.ai/dashboard에서 로그인합니다. FourA 계정이 필요합니다. 계정이 없다면 여기서 가입하세요.
두 가지 제품, 하나의 페이지 세트
Overview, Metrics 및 Activity는 각각 두 가지 선택지가 있는 Product 스위치로 열립니다.
| Product | 집계 항목 | 단위 |
|---|---|---|
| API | /api/single, /api/proxy, /api/browser 및 /api/auto(으)로 전송한 request |
Request 및 credit |
| Proxy | 자체 도구가 proxy.foura.ai을(를) 통해 여는 터널 |
터널 및 바이트 |
터널은 클라이언트가 전송하는 모든 데이터를 전달하며, CONNECT 내부에서 일어나는 일은 암호화된 사용자 고유 트래픽입니다. 따라서 Proxy 뷰는 터널과 바이트를 집계하며 request나 credit은 절대 집계하지 않습니다. 제품 자체에 대한 내용은 Proxy Port를 참조하세요.
스위치는 항상 둘 중 하나로 설정되어 방문 간에 기억되며, 주소에 #overview/proxy, #metrics/proxy 또는 #activity/proxy(으)로 표시됩니다. 해당 링크 중 하나를 붙여넣으면 페이지가 해당 제품으로 열립니다.
Proxy 제품을 Proxy Finder endpoint 칩과 혼동하지 마세요. Proxy Finder는 API의 4개 endpoint 중 하나인 POST /api/proxy/입니다. Proxy 제품은 proxy port입니다.
Overview 페이지, API 제품
로그인 후 나타나는 랜딩 페이지에는 선택한 기간의 주요 수치가 표시됩니다.
첫 request 전
첫 번째 request가 도착하기 전까지 API 뷰에는 샘플 데이터가 표시됩니다. 각 패널과 차트에는 Sample 태그가 붙고, 두 단계가 포함된 This is sample data. 배너 아래에 표시됩니다. 두 단계는 테스트 명령어가 함께 열리는 Create API key와 request를 전송하는 Open Playground입니다. 스마트폰이나 태블릿에서는 명령어를 실행할 수 없으므로 해당 단계가 Playground로 안내합니다. 첫 번째 실제 request가 발생하면 샘플 데이터가 완전히 대체됩니다.
Proxy 뷰에는 proxy 사용자 중 하나가 트래픽을 전송할 때까지 Create proxy user 및 Open Proxy가 포함된 자체 No traffic yet. 배너가 표시됩니다. 둘 중 하나의 배너를 닫으면 두 배너가 모두 숨겨집니다.
Summary 카드
상단에 5개의 패널이 표시되며, 해당 기간에 Auto가 실행된 경우 6번째 패널이 표시됩니다.
| 패널 | 표시 내용 |
|---|---|
| Concurrency | 현재 동시에 실행 중인 request 수, 그리고 해당 기간의 평균 및 최댓값 |
| Requests | 총 호출 수와 그 아래에 표시되는 Single, Proxy, Browser, Auto 각각의 점유율. Auto 호출은 Auto 아래에 1회로 계산됩니다. |
| Auto attempts | 해당 기간 동안 Auto가 실행된 경우에만 표시됩니다. Auto 호출 이면에서 Auto가 생성한 Single, Proxy, Browser request 및 Auto 호출당 시도 횟수입니다. 이는 request 수나 성공률에 포함되지 않으며, 사용된 크레딧은 Auto의 크레딧 내에 포함됩니다. 단, Single, Proxy, Browser의 rate limit 및 concurrency 한도에는 반영됩니다. |
| Credits | 청구된 크레딧이 기본값으로 표시되고 그 아래에 사용된 크레딧이 표시되며, 전체 및 Auto를 포함한 각 제품별로 제공됩니다. |
| Bytes | 전송된 데이터: In은 보낸 데이터, Out은 반환된 데이터, Premium은 해당 출구의 페이지 전달 여부와 관계없이 프리미엄 출구를 통과한 트래픽 부분입니다. Premium은 두 합계에 이미 포함되어 있으며 별도로 추가되지 않습니다. |
| Response Time | 해당 기간 동안의 평균, 최솟값, 최댓값 |
Billed(청구됨)와 Spent(사용됨)는 서로 다른 수치입니다. 성공한 request에 대해서만 비용이 청구되므로, Billed는 결제 대상 금액을 의미합니다. Spent는 실패한 request 역시 proxy나 browser를 소비하므로 모든 결과를 포함합니다. 둘을 혼동하면 동일한 계정이 서로 다른 두 페이지에서 다른 계정처럼 보일 수 있습니다. 과금되는 결과 유형은 Request Outcomes를 참고하십시오.
Requests 및 Credits 패널에서는 4개의 endpoint를 Single, Proxy, Browser, Auto로 라벨링합니다. 그 위의 Endpoints 필터 행에서는 Proxy를 Proxy Finder로 표시하지만 동일한 대상인 POST /api/proxy/를 가리킵니다.
이 네 항목의 합이 항상 전체 합계와 일치하지는 않습니다. 소수의 호출은 어느 항목에도 속하지 않으며, 이 경우 전체 합계에는 포함되지만 개별 endpoint에는 포함되지 않습니다.
타임라인 차트
패널 아래에는 request 볼륨, 크레딧 지출, 결과 분석, response time, 대역폭, concurrency를 표시하는 6개의 타임라인 차트가 있습니다. 각 차트 헤더의 토글을 사용해 그래프를 원본 테이블로 전환할 수 있습니다.
Overview 페이지, Proxy 제품
Product를 Proxy로 전환하면 동일한 페이지가 터널 기준으로 표시됩니다. 4개의 패널로 구성됩니다:
| 패널 | 표시 내용 |
|---|---|
| Tunnels at Once | 동일한 시점에 열려 있는 터널 수입니다. Current는 지난 몇 초간을 다루며 5초마다 새로고침됩니다. Avg 및 Max는 해당 기간 전체를 다룹니다. 사용 중인 플랜은 모든 proxy 사용자를 합산하여 이 수치를 제한합니다. |
| Tunnels | Success와 Failed, 그리고 각각이 전체에서 차지하는 점유율입니다. Failed는 성공 외의 모든 결과를 의미하며, Outcome 행에 구체적인 내용이 표시됩니다. |
| Traffic | In은 사용자의 도구가 전송한 데이터, Out은 반환된 데이터, Premium은 프리미엄 네트워크를 통해 나간 부분으로 총합에 추가되는 것이 아니라 총합 내에 포함되어 계산됩니다. |
| Setup Time | 성공한 터널에 대해서만 터널이 인계되기 전까지의 Avg, Min, Max 대기 시간입니다. 터널 뒤에 있는 사이트의 속도가 아니라 첫 번째 byte 이전까지의 대기 시간입니다. |
그 아래에는 Tunnel Timeline, Outcome Timeline, Setup Time Timeline, Traffic Timeline, Tunnels at Once Timeline의 5개 타임라인 차트가 있습니다. 각 차트에는 API 차트와 동일한 차트 또는 테이블 전환 토글이 적용됩니다.
Outcome 탭이 활성화되면 세 개 패널이 흐려지며, 이는 해당 결과에 대한 수치가 존재하지 않기 때문입니다. Tunnels at Once는 어떤 결과에서든 흐려집니다. Setup Time과 Traffic은 실패 결과 시 흐려지며 Success only 배지가 표시됩니다. 실패한 터널은 핸드오버되지 않았고 트래픽도 전달하지 않았기 때문입니다.
Period 및 Detail
Period는 조회할 과거 기간을 나타냅니다. 8개의 버튼과 Custom이 제공됩니다.
| Pill | Window |
|---|---|
| 30M | 최근 30분 |
| 3H | 최근 3시간 |
| 12H | 최근 12시간 |
| 24H | 최근 24시간 |
| 7D | 최근 7일 |
| 30D | 최근 30일 |
| 90D | 최근 90일 |
| 1Y | 최근 12개월 |
Custom을 선택하면 네 가지 프리셋(This month, Last month, Last 6 months, All time)과 From, To 날짜 쌍이 포함된 대화상자가 열립니다. 날짜 범위는 선택한 날의 끝까지 적용되며, 현재 시점을 넘어서지 않습니다.
Detail은 각 막대의 너비를 나타냅니다(분 단위, 5분마다, 30분마다, 시간 단위, 6시간마다, 일 단위, 주 단위, 월 단위). 기본값은 Auto로, 차트에 최소 15개 이상의 막대가 표시되는 가장 큰 단계를 선택하므로 1년치 데이터가 365개의 실선 대신 명확한 형태로 표시됩니다. Auto 옵션에는 선택된 단계 이름이 표시됩니다.
Period와 Detail은 두 제품 모두에 적용됩니다.
FourA가 해당 해상도를 보관하는 기간보다 더 이전으로 거슬러 올라가는 Detail 단계는 숨겨지지 않고 회색으로 비활성화됩니다.
| 해상도 | 보관 기간 |
|---|---|
| Per-request | 7일 |
| 5-minute | 30일 |
| Hourly | 12개월 |
| Daily | 전체 기록 |
해당 레벨에서 허용하는 것보다 오래된 기간을 선택하면 더 세밀한 옵션들이 비활성화됩니다. Auto는 비활성화된 옵션을 절대 선택하지 않으므로 데이터 집계로 인해 차트가 비어 있는 상황이 발생하지 않습니다.
필터
필터는 누적 및 조합되며, Period 및 Detail과 함께 적용됩니다.
| 필터 | 제품 | 기능 |
|---|---|---|
| Product | 둘 다 | API 또는 Proxy |
| Endpoints | API | 특정 endpoint로 범위 지정: Single, Proxy Finder, Browser 또는 Auto. Auto 호출은 Auto 아래에 1회로 계산되며, 내부 사다리 구조에서 생성된 Single, Proxy, Browser request는 자체 request가 아닌 Auto 시도 패널에 이름별로 표시됩니다. |
| Outcome | 둘 다 | 한 범주만 분리. API는 7개 전체를 제공하며, Proxy 제품은 터널이 도달할 수 있는 5개 범주를 제공합니다. |
| Owner | 둘 다 | 전체, 개인, 또는 소속 조직 중 하나. 최소 하나 이상의 조직에 속해 있을 때만 나타납니다. |
| Key | API | 단일 API key로 제한 |
| Proxy user | Proxy | 단일 proxy user로 제한 |
API 측의 Concurrency 패널과 차트에는 Endpoints 또는 Outcome 필터가 적용되지 않습니다. 둘 중 하나가 켜져 있으면 패널과 차트가 모두 흐려지며 차트 헤더에 관련 안내가 표시됩니다.
Owner 필터
Owner 드롭다운은 "누구의 트래픽을 보고 있는가"에 대한 답을 제공합니다. Everything, Personal, 그리고 소속된 각 조직별 항목을 제공하며 Metrics, Activity, API Keys, Proxy 페이지의 동일한 컨트롤이 선택 사항을 따르므로 페이지 간 불일치가 발생하지 않습니다.
Usage & Limits 및 Billing에는 의도적으로 이 옵션이 적용되지 않습니다. 해당 페이지는 "나에게 청구되는 항목이 무엇인가"에 대한 답을 제공하며, 여기에는 개인 키와 proxy 사용자 및 사용자가 소유한 조직의 항목이 포함됩니다. Organizations를 참고하십시오.
Sidebar Sections
4개 그룹에 걸친 11개 섹션: Dashboard, Tools, Access, Account.
Dashboard: Overview, Metrics, Activity
"무슨 일이 발생했는가"에 대한 답을 제공하는 세 개 페이지입니다. 세 페이지 모두 Product 스위치를 포함합니다.
Overview는 위에서 설명한 페이지이며 로그인 후 항상 표시되는 시작점입니다.
Metrics는 Usage 패널을 포함합니다. API 측면에서는 API key, 클라이언트 IP 또는 도메인별로 그룹화된 내역을, Proxy 측면에서는 proxy 사용자, 대상, 종료 국가, 클라이언트 IP 또는 결과별로 그룹화된 내역을 제공하며 페이지 매김 테이블 위에 전체 기간에 대한 카드가 표시됩니다. Metrics guide를 참고하십시오.
Activity는 지난 1시간 동안의 실시간 피드입니다. API 측면에서 각 행은 하나의 request(메서드, 대상 도메인, 상태, 결과, 소요 시간, 전송 크기, 크레딧)를 나타냅니다. Proxy 측면에서 각 행은 하나의 터널(proxy 사용자, 대상, 종료 위치, 결과, 설정, 소요 시간, 바이트 수, 클라이언트 IP)을 나타냅니다. Activity Log를 참고하십시오.
Tools: Playground, Extension
코드를 작성하지 않고도 실제 API key를 사용하여 실시간 request를 테스트할 수 있습니다. Auto, Single, Proxy 또는 Browser를 선택하고 URL을 설정한 뒤 플래그와 타임아웃을 조정하고 Send를 누르십시오. 공통 구성을 프리셋으로 저장하고 History에서 최근 20회 실행 기록 중 하나를 다시 실행할 수 있습니다.
사용량은 실제 프로덕션 호출과 동일하게 키의 할당량에 반영됩니다. Playground guide를 참고하십시오.
Beta로 표시된 Extension은 FourA Chrome 확장 프로그램을 다운로드하는 곳입니다. 팝업을 통해 proxy 사용자 중 하나를 거쳐 Chrome을 전송할 수 있으며, DevTools의 FourA 탭을 통해 페이지에서 발생하는 모든 request를 즉시 사용 가능한 API 호출로 변환할 수 있습니다. Chrome Extension을 참고하십시오.
Access: API Keys, Proxy
API Keys는 애플리케이션에서 API를 호출하는 데 사용하는 키를 생성, 확인 및 관리하는 곳입니다. 키는 pk_live_ 접두사를 사용합니다. Managing API Keys를 참고하십시오.
Proxy는 proxy 사용자를 생성하고 proxy URL을 지원하는 모든 클라이언트를 위한 연결 문자열을 복사하는 곳입니다. 포트를 통한 터널 및 트래픽은 API와 동일하게 요금제 사용량에 반영됩니다. Proxy Users 및 Proxy Port 레퍼런스를 참고하십시오.
Account: Organizations, Usage & Limits, Billing, Settings
Organizations를 통해 단일 소유자 아래에서 동료들과 API key 및 proxy 사용자를 공유할 수 있습니다. 이메일로 인원을 추가하고 역할을 설정하며 소유권을 이전해야 할 때 조직을 넘겨줄 수 있습니다. 조직의 자격 증명 사용량은 조직 소유자의 요금제에 청구됩니다. Organizations를 참고하십시오.
사용량 및 한도에서는 현재 요금제, 이번 청구 기간 동안 사용한 양, 적용되는 모든 한도를 키별, endpoint별, proxy 사용자별 세부 내역과 함께 확인할 수 있습니다. 사용량 및 한도를 참고하세요.
청구에서는 구독을 관리하고, 추가 크레딧이나 트래픽을 구매하며, 결제 수단과 인보이스를 관리하고, 요금제 대비 이번 청구 기간의 크레딧, 트래픽 및 프리미엄 트래픽을 확인할 수 있습니다. 청구 및 구독을 참고하세요.
설정에서는 표시 이름, 비밀번호, 활성 세션 및 연결된 로그인 제공업체를 관리합니다. 대시보드에서는 이메일 변경이 불가능하므로 고객 지원팀에 문의하세요.
팁
- 코드를 작성하기 전에 Playground를 사용해 보세요. 새 사이트에 어떤 엔진이 필요한지 모른다면 Auto로 시작하여 자동으로 선택되도록 하세요.
- Credits 카드에서 청구된 금액과 사용된 금액을 비교하세요. 두 수치의 차이가 크다면 해당 endpoint의 실패율이 높다는 의미이며, 시도 리포트에서 그 이유를 확인할 수 있습니다.
- Proxy 제품의 경우, Outcome Timeline에 표시되는 Rate Limited 블록은 대상 사이트의 거부가 아니라 요금제 한도에 도달했음을 의미합니다. Metrics의 Outcome 뷰에서 어떤 한도인지 확인할 수 있습니다.
- API 키와 proxy 사용자를 안전하게 보호하세요. 노출이 의심되는 경우 즉시 비활성화하세요.
다음 단계
- 인증: API 키 생성 및 관리 세부 정보
- 빠른 시작: CLI에서 첫 번째 request 보내기
- 요금제 측정 방식: 크레딧, 트래픽 및 적용되는 한도 기준
- 사용량 및 한도: 요금제 대비 크레딧 및 트래픽 추적
- API Endpoints: API 직접 사용하기