콘텐츠로 건너뛰기
Telemetry
웹훅 SQL 레시피

웹훅 지연 시간 및 중복률 측정

웹훅 제공자 및 이벤트 유형별로 처리 지연 시간, 중복 전달, 실패를 비교합니다.

중급webhook_deliveries검토됨 2026-07-27테스트됨 아파치 DataFusion 45.2.0

검토자 Telemetry 제품 팀 . SQL 호환성, 이벤트 계약, 합성 출력 및 운영상의 주의사항. 표준 및 소유권 검토

질문에 답변됨

느리거나, 중복되거나, 신뢰할 수 없는 웹훅 소스는 무엇입니까?

최소 한 번 이상 시스템에서는 중복 전달이 일반적이지만 중복 부작용은 그렇지 않습니다. 전달 결과와 멱등성 결정을 별도로 추적합니다.

이벤트 계약

쿼리가 예상하는 필드

필드유형그것이 존재하는 이유
timestamp_utcTimestamp처리 완료 시간.
providerUtf8웹훅 제공자.
event_typeUtf8제공자 이벤트 카테고리.
idempotency_outcomeUtf8new_event 또는 중복.
statusUtf8성공 또는 실패.
latency_msFloat64처리 기간.
DataFusion SQL

쿼리 복사

sql
SELECT
  provider,
  event_type,
  COUNT(*) AS deliveries,
  SUM(CASE WHEN idempotency_outcome = 'duplicate' THEN 1 ELSE 0 END) AS duplicates,
  SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END) AS failures,
  100.0 * SUM(CASE WHEN idempotency_outcome = 'duplicate' THEN 1 ELSE 0 END)
    / NULLIF(COUNT(*), 0) AS duplicate_rate_pct,
  approx_percentile_cont(latency_ms, 0.95) AS p95_latency_ms
FROM webhook_deliveries
WHERE timestamp_utc >= now() - INTERVAL '7 days'
GROUP BY provider, event_type
ORDER BY duplicate_rate_pct DESC, failures DESC;

이 읽기 전용 쿼리는 빈 유형의 테이블에 대해 계획되고 실행됩니다. 아파치 DataFusion 45.2.0. 결정론적 샘플 출력은 합성되어 별도로 검토됩니다. 자신의 데이터에 대해 필드 유형, 임계값 및 비즈니스 정의를 검증합니다. 테스트 방법론을 읽어보세요.

쿼리 결과

중복 및 실패한 웹훅 전달

Stripe 결제 실패는 중복률이 가장 높고 단말기 실패도 더 많습니다.

providerevent_typedeliveriesduplicatesfailuresduplicate_rate_pctp95_latency_ms
stripeinvoice.payment_failed4803497.081,180
githubpush2,9404231.43420

합성 예제 출력. 운영 결정에 사용하기 전에 자체 이벤트 스키마 및 임계값에 대해 쿼리를 실행하세요.

Duplicate and failed webhook deliveries: Measure Webhook Latency and Duplicate Rate 예제 결과의 합성 duplicates 값에 대한 정적 차트
결정론적 예제 출력의 색인 생성 가능한 SVG입니다. 기사, 런북 또는 저작자가 포함된 디자인 검토를 위해 다운로드하세요.

예제 재현

공공 픽스처 다운로드

JSON 번들은 타입이 지정된 이벤트 계약을 포함합니다. illustrative 입력 행, 정확한 SQL, 예상 출력, 검토 참고 사항 및 엔진 버전. CSV에는 표시된 결과가 포함됩니다.

SQL 작동 방식

  1. 1CASE 표현식은 동일한 배달 모집단에서 중복 및 실패 횟수를 계산합니다.
  2. 2중복 비율은 배송 특성입니다. 이는 중복된 비즈니스 효과를 입증하지 않습니다.
  3. 3테일 대기 시간은 핸들러가 공급자 시간 초과 또는 재시도 경계에 접근하고 있는지 여부를 보여줍니다.

결정해야 할 극단적인 경우

  • 중복은 성공적으로 중복 제거될 수 있으며 자동으로 실패로 간주되어서는 안 됩니다.
  • 공급자 재시도 정책과 이벤트 볼륨이 다르므로 공급자와 이벤트 유형을 유지하세요.
  • 이 테이블에 웹훅 서명이나 원시 결제 페이로드를 저장하지 마세요.

추천 대시보드

  • 누적 막대: 이벤트 유형별 중복 및 실패
  • 추세: p95 웹훅 대기 시간
  • 표: 최근 실패한 다운스트림 작업

알림 안내

예상되는 중복 제거 전달이 아닌 반복되는 처리 실패 또는 중복 부작용에 대해 알림합니다.

알림 설정 읽기

레시피를 활용해 보세요

관련 계측 및 가이드

분석 계속하기

실제 이벤트에서 실행

테이블을 만들고, 필드를 조정하고, 결과를 저장하세요.

무료로 시작하고, 구조화된 이벤트를 보내고, 쿼리 결과를 차트, 공유 대시보드 위젯 또는 알림 입력으로 사용하세요.

API 키 받기