메뉴 경로: 대시보드 > 로그

로그

개요

로그는 엔드포인트로 들어온 모든 API 호출 기록을 한자리에서 조회할 수 있는 페이지입니다. 요청 성공/실패 여부, 전송된 페이로드, 웹훅 전달 상태, 에러 메시지까지 확인할 수 있어요.

샌드박스와 프로덕션 환경이 별도 탭으로 분리되어 있어, 테스트 호출과 실제 운영 호출을 각각 따로 추적할 수 있습니다.

로그 엔드포인트 목록

로그 페이지에 진입하면 먼저 엔드포인트 목록이 보입니다. 각 엔드포인트별 로그 현황을 요약해 보여줍니다.

원하는 엔드포인트를 클릭하면 해당 엔드포인트의 상세 로그 페이지로 이동합니다.

엔드포인트를 선택하면 상단에 다음 요소가 표시됩니다.

엔드포인트 이름과 설명
API 상세 보기 버튼 — 엔드포인트 상세 페이지로 이동
샌드박스 데이터 초기화 버튼 — 이 엔드포인트의 샌드박스 호출 기록과 사용 통계를 영구 삭제합니다
- 협업자가 접근한 경우에는 내 샌드박스 데이터 초기화 로 표시되며, 자신이 발생시킨 샌드박스 기록만 삭제됩니다
- 프로덕션 데이터에는 영향을 주지 않습니다
Sandbox | Production 환경 탭 — 두 환경의 로그를 독립적으로 조회 (환경 탭 개념 자세히 보기)

검색 영역은 기간 검색과 필드 검색 두 가지 탭으로 나뉘어 있어요.

기간 검색 필터

시간 범위와 상태로 로그를 필터링합니다.

필드 검색 필터

특정 값을 기준으로 로그를 찾고 싶을 때 사용합니다.

필드 선택:
- 요청 ID — 레코드 ID로 정확히 일치 검색
- 내용 검색 — 엔드포인트의 검색 가능 필드(예: order_id, customer_email)에서 값 검색 (최소 3자)
검색 값 입력 후 검색 실행
내용 검색 선택 시 시작일 / 종료일 입력이 추가로 나타납니다. 날짜를 지정하지 않으면 최근 1개월 기준으로 검색됩니다

검색 필터 아래에 엔드포인트의 호출 기록이 테이블로 표시됩니다.

각 행을 클릭하면 로그 상세 페이지로 이동합니다.

로그 개요

개별 호출의 상세 정보를 확인하는 화면입니다.

페이로드 섹션

API 호출 시 전송된 원본 JSON 데이터가 표시됩니다.

프로덕션 환경의 경우 30일이 지난 페이로드는 자동으로 아카이빙되어 목록에서는 직접 보이지 않습니다. 이 경우 원본 페이로드 보기 버튼을 눌러 아카이빙된 페이로드를 불러올 수 있어요.

상세 페이지 오른쪽에는 현재 보고 있는 로그의 엔드포인트 상세 페이지로 이동하는 바로가기 카드가 표시됩니다. 해당 엔드포인트의 설정, 웹훅, 협업 키 등을 바로 확인할 수 있어요.

로그가 비어 있어요: 프로덕션 탭은 프로덕션 배포 전까지 기록이 남지 않습니다. 샌드박스 탭에서 테스트 호출이 기록되는지 먼저 확인하세요
검색해도 결과가 없어요: 내용 검색은 엔드포인트의 검색 가능 필드(Searchable)가 지정되어 있어야 동작합니다. 엔드포인트 상세 > 필수 필드에서 검색 가능으로 설정되어 있는지 확인하세요
페이로드가 안 보여요: 프로덕션 환경에서 30일이 지난 호출은 페이로드가 아카이빙됩니다. 원본 페이로드 보기 버튼으로 불러올 수 있어요
특정 협업자의 호출만 보고 싶어요: 기간 검색 탭의 협업 키 드롭다운에서 해당 협업 키를 선택하세요
샌드박스 초기화는 되돌릴 수 있나요?: 아니요. 초기화한 샌드박스 호출 기록과 통계는 영구 삭제됩니다. 신중하게 사용하세요