아카이브

개요

아카이브는 30일이 지난 프로덕션 데이터를 날짜별로 다운로드할 수 있는 페이지입니다. 분석·백업·외부 시스템 이관 등에 활용할 수 있어요.

아카이빙 정책

• 프로덕션 환경만 대상입니다. 샌드박스 데이터는 아카이빙되지 않고 30일 후 자동 삭제됩니다
• 프로덕션 데이터는 계정이 유효한 동안 영구 보존되며, 로그 페이지에서 언제든 조회할 수 있습니다
• 30일이 지난 프로덕션 데이터는 자동으로 아카이빙되어 이 페이지에서 날짜별로 다운로드할 수 있습니다
• 아카이브 파일은 하루 단위로 생성됩니다
• 다운로드 형식은 JSONL (.jsonl.gz) 또는 CSV 두 가지를 제공합니다
• pandas, DuckDB, jq, Jupyter 등으로 바로 분석 가능합니다

페이지 상단에는 위 정책과 스키마 요약이 안내 카드로 표시됩니다.

진입 경로

• 상단 메뉴 아카이브 클릭 → 엔드포인트 목록에서 다운로드할 엔드포인트 선택

---

엔드포인트 목록

페이지 상단에는 보존 정책과 파일 형식 요약이 안내 카드로 표시되고, 그 아래 데이터 스키마 보기 아코디언을 펼치면 아카이브 파일의 필드 구성을 미리 확인할 수 있어요 (본문 맨 아래 "아카이브 파일 스키마" 섹션과 동일한 내용).

그 아래에는 아카이브 데이터가 있는 엔드포인트 목록이 테이블로 표시됩니다.

컬럼	설명
엔드포인트	엔드포인트 이름
파일 수	해당 엔드포인트의 아카이브 파일 개수 (일 단위)
전체 크기	모든 아카이브 파일의 합계 용량
기간	가장 오래된 날짜 ~ 가장 최근 날짜 범위
최근	가장 최근 아카이브 파일의 날짜

원하는 엔드포인트를 클릭하면 아카이브 파일 목록 페이지로 이동합니다.

아카이브 파일 목록

엔드포인트를 선택하면 해당 엔드포인트의 날짜별 아카이브 파일 목록이 표시됩니다.

컬럼	설명
날짜	아카이브 대상 일자 (UTC 기준)
레코드 수	해당 날짜에 기록된 API 호출 건수
파일 크기	압축된 JSONL.gz 파일 크기
다운로드	JSONL / CSV 버튼 두 가지 제공

두 가지 다운로드 형식

JSONL (.jsonl.gz)

• 하루 단위 프로덕션 기록을 gzip으로 압축한 파일
• 한 줄에 하나의 JSON 레코드
• 원본 형식 그대로 보존되어 프로그램적 분석·백업·재처리에 적합
• 예:

  {"id":"rec_...","payload":{"order_id":"ORD-001"},"status":"success","created_at":"..."}
  {"id":"rec_...","payload":{"order_id":"ORD-002"},"status":"success","created_at":"..."}
  

CSV (.csv)

• 스프레드시트로 바로 열 수 있는 형식
• 시스템 필드가 먼저, 그 다음에 payload_ 접두사가 붙은 평탄화된 비즈니스 필드가 이어짐
• 예: payload.customer.name → payload_customer_name
• Excel·Google Sheets 등에서 즉시 열람 가능
• 주의: CSV 변환은 파일 크기에 따라 시간이 걸리고, PC 브라우저에서만 동작합니다 (대용량 파일 처리 때문)

아카이브 파일 스키마

다운로드한 아카이브 파일에 담긴 각 레코드의 필드 구성입니다. JSONL 기준 한 줄이 하나의 레코드이며, CSV의 경우 시스템 필드가 먼저 나오고 payload_ 접두사가 붙은 평탄화된 비즈니스 필드가 이어집니다.

필드	설명
id	레코드 ID
payload	비즈니스 데이터 (JSON)
config_version	스키마 버전
status	처리 결과 (success / failed)
error_details	에러 상세 (실패 시)
created_at	생성 시각
updated_at	수정 시각
endpoint_name	엔드포인트 이름
endpoint_slug	엔드포인트 URL 경로
collaboration_key_name	호출자 키 이름
gateway_processing_time_ms	처리 시간 (ms)

---

자주 막히는 부분

• 아카이브 목록이 비어 있어요: 프로덕션 데이터가 30일 이상 경과해야 아카이빙됩니다. 그 이전 데이터는 로그 페이지에서 확인하세요
• 모바일에서 CSV 다운로드가 안 돼요: CSV 변환은 대용량 처리가 필요해 PC 브라우저 전용입니다. JSONL은 모바일에서도 다운로드 가능합니다
• CSV를 스프레드시트에서 열었는데 비영어 문자가 깨져요: CSV 파일은 UTF-8 인코딩으로 제공됩니다. 스프레드시트에서 열 때 문자 인코딩을 UTF-8로 지정하면 깨짐 없이 표시됩니다
• Free 플랜에서도 아카이브를 받을 수 있나요?: 아카이빙은 유료 플랜 전용 기능입니다. Free 플랜 엔드포인트는 생성 7일 후 자동 정리되므로 별도 아카이브가 필요하지 않아요