전송 로그 및 테스트
웹훅 설정 패널에는 엔드포인트별 기본 전달 로그가 있습니다. 이벤트가 서버에 도착하는지 확인하고 실패를 진단하고 실제 활동을 일으키지 않고 새 샘플 페이로드를 보낼 때 활용하세요.
전송 로그 확인
1
설정 → 웹훅 열기
다음으로 이동:
Dashboard → Settings → Webhooks.2
웹훅 행 펼치기
다음을 클릭하세요: 전송 로그 버튼은 각 웹훅 카드에 있습니다. 최근 50회 시도가 최신순으로 표시됩니다.
3
각 항목 검사
각 행에는 이벤트 유형, HTTP 상태 코드, 응답 시간, 타임스탬프, 오류 메시지가 표시됩니다.
로그 필드
| 필드 | 설명 |
|---|---|
| 이벤트 | 발생한 이벤트 유형(예: post.saved) |
| 상태 | 엔드포인트가 반환한 HTTP 상태입니다. null 시간 초과 또는 연결 거부 시. |
| 응답 시간 | 전송부터 응답의 마지막 바이트까지 왕복 시간(밀리초). |
| 성공 | 초록색 체크 = HTTP 2xx. 빨간색 X = 그 외 모든 결과. |
| 오류 | 전송 실패에 대한 읽기 쉬운 오류 메시지 (예: Request timed out (10s)). |
| 전송 일시 | 전송 시도의 UTC 타임스탬프. |
테스트 이벤트 보내기
1
웹훅 카드 펼치기
내부
Settings → Webhooks에서 웹훅을 찾고 다음을 클릭하세요: 테스트 이벤트 보내기.2
전송 로그 확인
테스트 전송은 몇 초 안에 전송 로그 맨 위에 표시됩니다. 다음이 보이는지 확인하세요.
200 상태.테스트 이벤트는 실제 HTTP 요청입니다
테스트 이벤트는 HMAC 서명을 포함해 실제 이벤트와 완전히 같은 경로를 거칩니다. 테스트에서 서명 검증 코드도 전체적으로 실행됩니다.
자동 재시도 없음
각 전송은 한 번만 시도합니다. 로그는 진단용이며 실패한 실제 이벤트를 재실행하는 버튼은 없습니다. 엔드포인트를 수정한 뒤 테스트를 사용해 해결 여부를 확인하세요.
일반적인 실패 원인
| 오류 / 상태 | 가능한 원인 | 수정 |
|---|---|---|
Request timed out (10s) | 서버 응답에 10초 넘게 걸렸습니다 | 돌아가기 200 즉시 응답한 뒤 비동기로 처리 |
401 | 서명 검증 실패 | JSON 파싱 전에 원시 본문을 읽어야 합니다 |
404 | 엔드포인트 URL 경로가 존재하지 않음 | Savebase 웹훅 설정의 URL을 다시 확인하세요 |
500 | 수신 처리 코드에서 처리하지 않은 오류 | 서버 로그에서 예외를 확인하세요 |
| 연결 거부 / null 상태 | 서버가 중단되었거나 URL이 잘못되었습니다 | 서버가 실행 중이며 공개적으로 접근 가능한지 확인하세요 |