Tu endpoint de webhook de Stripe procesa confirmaciones de pago. Lleva 2 horas devolviendo errores 500. Stripe reintento 3 veces y siguio adelante. Tenes 47 pagos sin procesar.
Que monitorear
| Metrica | Por que importa | Umbral de alerta |
|---|---|---|
| Tasa de exito | % de webhooks procesados sin error | < 99% |
| Tiempo de respuesta | Stripe timeout: 20s, GitHub: 10s | > 5 segundos |
| Error rate por tipo | 4xx vs 5xx vs timeout | Cualquier spike de 5xx |
Mejores practicas
- Devolver 200 inmediatamente, procesar asincrono
- Verificar firmas de webhook
- Implementar idempotencia
Cómo instrumentar tus webhooks
Un webhook es una API route más: registrá el status y la duración de cada entrega con logs estructurados (o métricas de OpenTelemetry) y configurá una alerta cuando la tasa de error de /api/webhooks/stripe supere tu línea base. Sumale el dashboard de entregas del proveedor y te enterás en minutos, no por el mail de un cliente.