Seu endpoint de webhook do Stripe processa confirmacoes de pagamento. Faz 2 horas que retorna erros 500. Stripe tentou 3 vezes e seguiu em frente. Voce tem 47 pagamentos nao processados.
O que monitorar
| Metrica | Por que importa | Limiar de alerta |
|---|---|---|
| Taxa de sucesso | % de webhooks processados sem erro | < 99% |
| Tempo de resposta | Stripe timeout: 20s, GitHub: 10s | > 5 segundos |
| Taxa de erro por tipo | 4xx vs 5xx vs timeout | Qualquer spike de 5xx |
Melhores praticas
- Retornar 200 imediatamente, processar assincrono
- Verificar assinaturas de webhook
- Implementar idempotencia
Como instrumentar seus webhooks
Um webhook é só mais uma API route: registre o status e a duração de cada entrega com logs estruturados (ou métricas do OpenTelemetry) e configure um alerta quando a taxa de erro de /api/webhooks/stripe passar da sua linha de base. Some o dashboard de entregas do provedor e você descobre em minutos, não pelo email de um cliente.