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

로그

개요

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

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

로그 엔드포인트 목록

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

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

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

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

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

기간 검색 필터

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

필드 검색 필터

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

필드 선택:
- 요청 ID — 레코드 ID로 정확히 일치 검색 (앞부분 일치 가능)
- 내용 검색 — payload 전체 텍스트에서 부분 매칭으로 값 검색 (최소 3자, 대소문자 무시)
검색 값 입력 후 검색 실행
내용 검색 선택 시 시작일 / 종료일 입력이 추가로 나타납니다. 날짜를 지정하지 않으면 최근 30일 기준으로 검색됩니다

검색 범위: 레코드의 payload(JSON 전체)를 텍스트로 직렬화한 결과에서 부분 매칭
다국어 지원: 한글·영문·일본어/한자 등 모두 동작 (영문은 대소문자 무관)
숫자 검색: 가능하나 부분 매칭이라 false positive 발생 (예: "32"로 검색하면 age:32뿐 아니라 132, 321 등도 매칭)
JSON 키 이름도 인덱싱: 키 이름과 같은 일반적인 단어("name", "address" 등)로 검색하면 모든 레코드가 매칭됩니다 — 좀 더 구체적인 검색어를 권장
지원하지 않는 것: 대소비교(>, <, =), 정확 일치, 필드 단위 검색

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

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

로그 개요

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

페이로드 섹션

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

프로덕션 환경의 경우 30일이 지나면 백업 아카이브 파일이 추가로 생성되어 대시보드 > 아카이브에서 일별로 다운로드할 수 있어요 (대량 내보내기용).

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

로그가 비어 있어요: 프로덕션 탭은 프로덕션 배포 전까지 기록이 남지 않습니다. 샌드박스 탭에서 테스트 호출이 기록되는지 먼저 확인하세요
검색해도 결과가 없어요: 검색어가 3자 미만이거나 기간 범위 안에 매칭 레코드가 없는 경우입니다. (1) 검색어를 더 구체적/짧게 줄여보고 (한국어는 2~3글자, 영문은 부분 단어), (2) 기간을 30일 이내로 넓혀보세요. 과거 "검색 가능 필드 지정" 단계는 폐지되어 별도 설정은 필요 없습니다.
특정 협업자의 호출만 보고 싶어요: 기간 검색 탭의 협업 키 드롭다운에서 해당 협업 키를 선택하세요
샌드박스 초기화는 되돌릴 수 있나요?: 아니요. 초기화한 샌드박스 호출 기록과 통계는 영구 삭제됩니다. 신중하게 사용하세요