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

로그

개요

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

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

진입 경로

상단 메뉴 로그 클릭 → 엔드포인트 목록에서 조회할 엔드포인트 선택
엔드포인트 상세 우측 사이드바의 로그 보기 링크

엔드포인트 목록

로그 엔드포인트 목록

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

컬럼	설명
엔드포인트	엔드포인트 이름
총 로그	해당 엔드포인트로 누적된 호출 건수
성공률	성공 호출 비율 (%)
마지막 활동	가장 최근 호출 시각 (상대 시간)

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

상세 페이지 헤더

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

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

검색 필터

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

기간 검색

기간 검색 필터

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

날짜 기준 — 처리 일시 또는 생성 일시 선택. 기본값은 처리 일시
시작일 / 종료일 — 조회할 기간 지정
상태 — 전체 / 성공 / 실패 / 웹훅 실패 중 선택
- 웹훅 실패는 저장은 됐지만 웹훅이 수신 서버에 끝내 도달하지 못했거나 아직 재시도 중인 호출만 골라 보여줍니다. 이 옵션을 고르면 요청 ID·내용 검색 조건은 해제됩니다
협업 키 — 전체 또는 특정 협업 키로 필터링 (해당 키로 호출된 기록만 표시)

필드 검색

필드 검색 필터

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

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

내용 검색의 동작 방식과 한계

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

로그 목록

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

컬럼	설명
요청 ID	레코드 식별자
상태	성공 · 실패 · 대기 배지
웹훅	배달에 실패했거나 재시도 중인 경우에만 배지 표시 (아래 참고)
협업 키	이 호출에 사용된 협업 키 이름 (없으면 기본)
생성 시간	API 호출 수신 시각
처리 시간	저장 및 웹훅 처리 완료 시각

웹훅 컬럼 읽는 법 — 이 컬럼은 웹훅을 설정한 엔드포인트에서만 나타납니다.

배지	뜻
⚠ `502`	실패 — 재시도를 모두 소진했고 끝내 전달되지 않았습니다. 숫자는 수신 서버가 돌려준 응답 코드이고, 응답 자체가 없었다면 `타임아웃`으로 표시됩니다
↻ `502 (3/6)`	재시도 중 — 괄호는 `현재 시도 회차 / 총 시도 횟수`입니다 (프로덕션 6회, 샌드박스 4회 — 최초 배달이 1회차입니다). 다음 재시도 시각은 로그 상세에서 확인하세요
✓ `복구됨`	처음엔 실패했지만 재시도 끝에 전달됐습니다

빈 칸이 곧 성공은 아닙니다. 시스템은 실패한 배달만 기록하므로, 정상 전달된 웹훅은 아무 흔적도 남기지 않습니다. 웹훅을 설정하지 않은 엔드포인트에서는 컬럼 자체가 보이지 않아요.

한 호출에 소유자 웹훅과 협업자 웹훅이 둘 다 걸려 있으면, 목록에는 더 심각한 쪽 하나만 표시됩니다. 둘을 각각 보려면 로그 상세로 들어가세요.

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

로그 상세 페이지

개요

로그 개요

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

요청 ID: 레코드 고유 식별자
엔드포인트: 호출 대상 엔드포인트 이름
버전: 해당 호출 시점의 설정 버전
처리일: 저장 및 웹훅 처리 완료 시각
응답 시간: Gateway 처리 시간(ms)
협업 키: 호출에 사용된 협업 키 이름과 설명 (있는 경우)
오류 메시지 / 에러 상세: 실패한 호출의 경우 에러 유형, 상태 코드, 필드 에러, 발생 시각 표시
엔드포인트 보기 버튼 — 이 엔드포인트의 상세 페이지로 이동

웹훅 배달

이 호출의 웹훅이 실패했거나 재시도 중일 때만 나타나는 카드입니다. 소유자 웹훅이 위, 협업자 웹훅이 아래에 표시됩니다.

상태 배지와 시도 횟수 — 목록과 같은 배지에 N회 시도, 응답 코드, 마지막 오류, 수신 호스트가 함께 표시됩니다
응답 — 수신 서버가 돌려준 응답 본문 원문(앞부분 일부). 방화벽(WAF)이 막은 것인지, 서버까지는 닿았는데 앱이 거부한 것인지를 가르는 거의 유일한 단서입니다. 복사 버튼이 있어요
시도 이력 — 각 시도의 시각 · 응답 코드(또는 타임아웃) · 소요 시간(ms). 자동 재시도로 발생한 시도에는 자동 재시도 표시가 붙습니다
다음 재시도 — 아직 시도가 남아 있으면 다음 예정 시각

실패한 배달만 기록됩니다. 정상 전달된 웹훅은 여기에 남지 않으므로, 이 카드가 없다는 것은 "실패 기록이 없다"는 뜻이지 "전달을 확인했다"는 뜻이 아닙니다.

수동 재전송은 제공하지 않습니다. 재시도는 전부 자동이며, 소진된 뒤에는 다시 보낼 수 없습니다. 수신 서버를 고쳤다면 다음 API 호출부터 정상 전달됩니다.

이 화면을 계속 지켜보실 필요는 없습니다. 프로덕션 소유자 웹훅 배달을 포기하면 메일로 알려드려요 (플랜 무관, 무료 포함) — 엔드포인트당 하루 한 통까지입니다. 개별 시도 이력과 응답 본문을 확인하는 곳은 여전히 이 화면이고요.

재시도 간격과 어떤 응답이 재시도 대상인지는 테스트 및 연동 가이드에서 확인하세요.

페이로드

페이로드 섹션

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

위험 영역

로그 레코드 삭제 — 이 로그 레코드를 영구적으로 제거합니다
레코드 자체와 관련된 페이로드가 함께 삭제되며, 이 작업은 되돌릴 수 없습니다
사용 통계에는 영향을 주지 않습니다

엔드포인트 보기 퀵링크

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

자주 막히는 부분

로그가 비어 있어요: 프로덕션 탭은 프로덕션 배포 전까지 기록이 남지 않습니다. 샌드박스 탭에서 테스트 호출이 기록되는지 먼저 확인하세요
검색해도 결과가 없어요: 검색어가 3자 미만이거나 기간 범위 안에 매칭 레코드가 없는 경우입니다. (1) 검색어를 더 구체적/짧게 줄여보고 (한국어는 2~3글자, 영문은 부분 단어), (2) 기간을 30일 이내로 넓혀보세요. 과거 "검색 가능 필드 지정" 단계는 폐지되어 별도 설정은 필요 없습니다.
특정 협업자의 호출만 보고 싶어요: 기간 검색 탭의 협업 키 드롭다운에서 해당 협업 키를 선택하세요
웹훅 컬럼이 비어 있는데 잘 전달된 건가요?: 아닙니다. 실패한 배달만 기록되므로 빈 칸은 "실패 기록이 없다"는 뜻입니다. 웹훅을 설정하지 않았거나, 아직 배달을 시도하지 않았거나, 정상 전달된 경우가 모두 똑같이 빈 칸으로 보입니다
웹훅 실패 필터를 켜니 검색어가 사라졌어요: 웹훅 실패는 조회 방향이 반대라 요청 ID·내용 검색과 함께 쓸 수 없습니다. 기간과 협업 키 조건은 그대로 유지됩니다
샌드박스 초기화는 되돌릴 수 있나요?: 아니요. 초기화한 샌드박스 호출 기록과 통계는 영구 삭제됩니다. 신중하게 사용하세요

프로덕션 콘솔

통계