활동 로그

활동 로그는 가장 최근의 API request를 실시간으로 보여줍니다. 이를 통해 개별 request를 디버깅하고, response 코드를 확인하며, 연동이 올바르게 작동하는지 검증할 수 있습니다.

표시되는 정보

로그에는 지난 1시간 동안 발생한 request가 가장 최근 항목부터 순서대로 표시됩니다. 각 항목에는 다음 정보가 포함됩니다:

필드	설명
Timestamp	request가 발생한 시간
Method	대상에 전송된 HTTP method (GET, POST 등)
Route	사용된 FourA endpoint (single, proxy 또는 browser)
Domain	request URL에서 추출한 대상 도메인
Status	대상이 반환한 HTTP status 코드
App Status	response body에 반환된 애플리케이션 수준의 상태
Outcome	request 분류 (success, client_error, rate_limit 등)
Duration	밀리초 단위의 총 response 시간
Bytes In	request 페이로드 크기
Bytes Out	response 페이로드 크기
Key Name	사용된 API key
Client IP	request를 보낸 클라이언트 IP 주소

필터링

세 가지 컨트롤을 사용하여 로그를 좁힐 수 있습니다.

API Key 기준

API key 드롭다운을 사용하여 특정 key의 request만 표시합니다. 액세스 권한 범위 내에 있는 key만 드롭다운에 나타납니다.

제품 기준

single / proxy / browser 선택기를 사용하여 특정 endpoint로 필터링합니다. single request와 별개로 browser 전용 실패를 디버깅하려는 경우에 유용합니다.

제한 기준

활동 로그는 기본적으로 50개의 항목을 표시합니다. 제한 선택기를 사용하여 표시할 항목 수를 변경할 수 있습니다:

제한	참고 사항
10	빠른 스캔
50	기본값
100	확장 보기
200	최대값

모든 항목은 지난 1시간 동안의 데이터입니다. 과거 데이터를 확인하려면 일 단위 및 주 단위로 데이터를 집계하는 Metrics 섹션을 사용하세요.

Request 열기

임의의 행을 클릭하면 전체 request 및 response 페이로드 미리보기가 포함된 상세 대화 상자가 열립니다. 대화 상자에는 다음이 표시됩니다:

메타 그리드: timestamp, key, HTTP status, app status, outcome, duration 및 request의 X-Foura-Request-Id.
Request: 전송된 정확한 body를 보기 좋게 정렬한 JSON과 복사 버튼.
Response: 메타 스트립 및 body 미리보기, 해당하는 경우 truncated 및 binary 배지 표시.

페이로드는 24시간 동안 보관되며, API key당 최근 200개로 제한됩니다. 이보다 오래된 행은 행 자체만 표시되며 상세 대화 상자는 열리지 않습니다.

Body 창 메시지

body 창에는 발생한 상황에 따라 다른 플레이스홀더 텍스트가 표시됩니다:

메시지	의미
`(no body — the request failed: <error>)`	대상이 body를 반환하기 전에 request에 오류가 발생함
`(no body captured)`	페이로드가 만료되었거나 저장되지 않음
`(empty body — the server returned 0 bytes)`	대상이 실제로 비어 있는 response를 반환함

Playground에서 열기

상세 대화 상자에는 Open in Playground 버튼이 있습니다. 이 버튼을 클릭하면 아카이브된 request와 response가 모두 Playground 폼에 로드됩니다. 여기에서 파라미터를 조정하고 라이브 API에 대해 다시 실행하거나, request를 다시 실행하지 않고 반환된 내용을 검사할 수 있습니다.

단, 다시 실행할 수 없는 페이로드(크기가 초과된 request 스텁 및 API가 아닌 라우트)의 경우 버튼이 비활성화되며, 그 이유를 설명하는 힌트가 표시됩니다.

Request ID 사용하기

모든 API response에는 X-Foura-Request-Id header가 포함되어 있습니다. 이를 귀사 측에 기록해 두면, 지원 티켓에 붙여넣어 활동 로그의 정확한 request를 지칭할 수 있습니다. 이 ID는 대화 상자에서 사용되는 ID와 동일하며, API가 반환하는 X-Foura-Request-Id와 일치합니다. 자세한 내용은 API Endpoints 참조 문서를 확인하세요.