API Gözlemlenebilirliği / Teslimat İzleme
Webhook Delivery Inspector
Webhook teslimatlarını, retry zincirlerini ve hedef sağlık durumunu tek görünümde izlemeyi sağlar.
En uygun alan
webhook debug, retry takibi ve üçüncü taraf teslimat görünürlüğü
Ne açıklar
webhook denemelerinin nerede kırıldığını, retry zincirinin nasıl büyüdüğünü ve hangi hedeflerin SLA dışına taştığını
Neden önemli
Webhook hataları çoğu zaman downstream sistem bayatlayana kadar görünmez kalır. Teslimat görünürlüğü, retry davranışını ve hedef sağlık durumunu destek gürültüsüne dönüşmeden önce açığa çıkarır.
Tasarım Niyeti
Event tipi, destination, payload özeti ve retry geçmişini tek inceleme yüzeyinde toplayarak ekiplerin outbound entegrasyonları loglar arasında kaybolmadan debug etmesini sağlamak.
Sistem Sinyalleri
- teslimat durumu
- retry sayısı
- hedefe gidiş gecikmesi
- deneme zaman çizgisi
Kullanım Senaryoları
- Başarısız teslimatların tek bir hedefe mi yoksa daha geniş bir kesintiye mi ait olduğunu görmek
- Webhook politikasını değiştirmeden önce retry backoff davranışını incelemek
- Partner tarafı eksik event bildirdiğinde mühendislere kompakt bir teslimat izi vermek
Tasarım Notları
- Retry sayısı yalnızca badge değil, sıra halinde okunmalı
- Payload özeti yeterli bağlam vermeli ama ham secret sızdırmamalı
- Destination health durumu genel başarı UI’ı gibi değil, operasyon sinyali gibi görünmeli
Webhook Delivery Inspector
Inspect outbound webhook events, retry chains, and destination failures without stitching together delivery logs by hand.
Invoice payment confirmed for org_1284 and ledger synced.