contrato de evento común
Campos que mantienen estas consultas reutilizables
- timestamp_utc, proveedor, event_type, delivery_id y estado
- intento, latency_ms, status_code y idempotency_outcome
- downstream_job_count, error_type y medio ambiente
Definiciones antes de SQL
Decisiones que la consulta no puede tomar por usted
- 1Almacene identificadores de proveedores, no firmas o cargas útiles de webhooks sin procesar.
- 2Distinga los intentos de entrega del resultado final de un webhook.
- 3Defina si un duplicado reconocido es un éxito o un resultado separado.
Secuencia recomendada
Primero la detección de compilación, luego el diagnóstico
Patrones de análisis
Hacer que el resultado explique una decisión.
Siga una entrega de principio a fin
Utilice un identificador de entrega estable para conectar la recepción, la validación, el acuse de recibo, los reintentos, el procesamiento y el efecto posterior.
Distinguir los intentos de los resultados.
Un error a nivel de intento es diferente de un webhook que falla permanentemente. Mantenga ambos para que las tasas de recuperación sigan siendo interpretables.
Verificar idempotencia
Realice un seguimiento del reconocimiento de duplicados y de los efectos secundarios posteriores para confirmar que los reintentos no repitan operaciones comerciales.
recetas completas
Copie la consulta y luego valide las suposiciones.
Medir la recuperación del reintento del webhook
Separe las fallas permanentes del webhook de las entregas que se recuperaron en un intento posterior.
¿Los reintentos de webhook están recuperando fallas o creando más trabajo?
Ver SQL y resultadoMedir la latencia del webhook y la tasa de duplicados
Compare la latencia de procesamiento, las entregas duplicadas y las fallas por proveedor de webhook y tipo de evento.
¿Qué fuentes de webhooks son lentas, duplicadas o poco confiables?
Ver SQL y resultadoMedir la finalización del webhook de un extremo a otro
Siga cada webhook desde su recepción hasta su finalización y mida el porcentaje que finaliza dentro de un objetivo operativo.
¿Qué tipos de webhooks finalizan su trabajo posterior en cinco minutos?
Ver SQL y resultadoAdaptar el contrato del evento antes del umbral.
Mantenga el patrón de análisis, pero valide los nombres de las tablas, los tipos de campos, las definiciones comerciales, las ventanas de tiempo y las reglas de volumen mínimo con respecto a sus propios eventos. Cada consulta publicada también se planifica y ejecuta en una tabla escrita vacía con el motor fijado.