웹훅 전달 로그 스키마 및 재시도 필드

기록하고 확인할 항목

안전한 응답 디버깅을 위한 웹훅 전달 로그 필드

유용한 전달 스키마는 시도 필드를 정규화하고 최종 상태 코드와 제한된 응답 메타데이터를 유지하며 URL, 요청 헤더, 승인, 페이로드 및 원시 응답 콘텐츠를 제외합니다.

1
배송완료
성공 또는 영구 재시도 소진 후 한 번만 내보냅니다. 로그 줄당 한 번은 내보낼 수 없습니다.
2
필드가 정규화되었습니다.
attempt_number와 같은 소스 필드를 attempt_count에 매핑한 다음 원시 response_body 대신 status_code, response_body_bytes 및 허용 목록에 있는 콘텐츠 유형을 유지합니다.
3
비밀은 유지됩니다
request_headers, 승인 값, 고객 URL 또는 웹훅 페이로드를 저장하지 마십시오.
4
회복이 측정됩니다
대상 유형별로 영구 실패, 반복되는 상태 코드, 재시도 후 복구를 비교합니다.

곡물

논리적 웹훅 전달당 하나의 최종 결과입니다.

소유자

웹훅 전달 작업자

언제 방출

성공 후 또는 영구 재시도 소진 후.

현장 계약

필드 유형과 제외할 데이터

프로덕션 쿼리가 종속된 후에도 기존 필드 이름과 유형을 안정적으로 유지합니다. 선택적 컨텍스트는 특정 결정에 따라 제한되고, 문서화되고, 정당화되어야 합니다.

필드	유형	필수	개인 정보 보호	의미
timestamp_utc	timestamp	yes	non-sensitive	결과 경계의 UTC 시간입니다.
event_id	string	yes	non-sensitive	중복 제거에 사용되는 안정적인 고유 식별자입니다.
release	string	yes	non-sensitive	이벤트를 생성한 애플리케이션 또는 서비스 버전입니다.
account_id	string	yes	pseudonymous	안정적인 내부 계정 식별자이며 이메일이나 이름이 아닙니다.
delivery_id	string	yes	pseudonymous	안정적인 논리적 배달 식별자입니다.
destination_type	string	yes	non-sensitive	도착 URL이 아닌 제한된 통합 카테고리입니다.
attempt_count	number	yes	non-sensitive	최종 결과를 통해 시도합니다.
status_code	number	no	non-sensitive	응답이 존재할 때 최종 HTTP 상태입니다.
response_body_bytes	number	no	non-sensitive	최종 응답 본문 크기(바이트)입니다. 응답 본문 대신 크기를 저장합니다.
response_content_type	string	no	review	application/json과 같은 허용 목록에 있는 응답 미디어 유형 무제한 응답 헤더를 복사하지 마십시오.
status	string	yes	non-sensitive	배송되었거나 영구적으로 실패했습니다.

합성 JSON 이벤트

{
  "timestamp_utc": "2026-07-28T14:29:08Z",
  "event_id": "evt_webhook_01",
  "account_id": "acct_8f31",
  "release": "2026.07.2",
  "delivery_id": "delivery_09cc",
  "destination_type": "slack",
  "attempt_count": 1,
  "status_code": 200,
  "response_body_bytes": 27,
  "response_content_type": "application/json",
  "status": "delivered"
}

개인정보 보호 검토

수집 전 식별자 검토

이 예에서는 합성 식별자를 사용합니다. 가명 값은 여전히 개인 데이터일 수 있으며 검토 필드는 비즈니스 또는 공급자 컨텍스트를 노출할 수 있습니다. 귀하의 동의, 보존, 액세스, 거주 및 삭제 요구 사항을 적용하십시오.

account_id: pseudonymous
delivery_id: pseudonymous
response_content_type: review

검증 체크리스트

대시보드를 구축하기 전에 계약을 증명하세요.

Send one known webhook_delivery_completed fixture after the documented outcome boundary.
Verify all 8 required fields arrive with the documented types.
동일한 이벤트 식별자를 다시 시도하고 선택한 중복 제거 동작을 확인하세요.
워크플로에서 지원하는 경우 제어된 실패 또는 대체 결과를 보냅니다.
고정된 창에서 관련 SQL을 실행하고 결과를 고정 장치에 맞게 조정합니다.

일반적인 실수

하나의 행을 하나의 지속 가능한 결과와 동일하게 유지

Emitting webhook_delivery_completed before webhook delivery worker knows the final outcome.
한 테이블에 여러 곡물이 섞여 있어 개수와 비율이 모호해집니다.
제어된 카테고리를 원시 URL, 페이로드, 프롬프트 또는 오류 텍스트로 대체합니다.
저장된 쿼리 및 대시보드 이후에 필드 유형을 변경하는 것이 이에 따라 달라집니다.
문서화된 조사, 액세스, 보관 요구 없이 식별자를 추가합니다.

계약을 사용하세요