İletim başarısız olduğunda
Bir şey ulaşmıyor. Nerede durduğunu böyle bulursunuz.
Analitik ile başlayın
Analitik son yedi gün için üç sayı verir: Alınan, İletilen, Başarısız. Hangisinin yanlış olduğu, sistemin hangi yarısına bakacağınızı söyler.
| Görünen | Anlamı |
|---|---|
| Alınan 0 | Hiçbir şey gelmiyor. Sorun yukarıda — Merkez'de değil, kaynakta. |
| Alınan > 0, İletilen 0, Başarısız 0 | Mesajlar geliyor ve içeride duruyor. Bir kural atıyor ya da yönlendirme yok. |
| Başarısız > 0 | İletim deneniyor ve reddediliyor. Hedef ya da yapılandırması. |
| İletilen > 0 ama aşağıda bir şey yok | Hedef başarı dönüp gövdeyi atıyor. Alıcıya bakın. |
Son satır insanları yanıltır. Yükü yok sayarken 200 OK dönen bir hedef,
Merkez'den bakınca kusursuz görünür.
Hiçbir şey alınmıyor
Merkez'den dışarı doğru ilerleyin:
- Callback doğru adrese mi bakıyor? Ağın yapılandırmasını Akış → Uç nokta ve şema ile karşılaştırın.
- Uç nokta anahtarı döndürüldü mü? Döndürme eskisini anında geçersiz kılar — hâlâ eskisini kullanan her gönderici o andan itibaren başarısız olur.
- Paylaşılan gizli anahtar iki tarafta da aynı mı?
- Zorunlu başlıklar gönderiliyor mu? Eksik bir zorunlu başlık, başka hiçbir şey çalışmadan önce reddedilir.
- Cihaz hiç iletiyor mu? Ağın kendi konsoluna bakın.
Alınıyor ama iletilmiyor
Mesaj içeri girdi ve durdu. İki olağan sebebi vardır:
Bir kural attı. Akış → Kurallar'ı açın ve yukarıdan aşağıya okuyun. İlk eşleşme kazanır ve Dur içeren bir kural, sonrakilerin hiç çalışmasını engelleyebilir. Test ederken şüpheli kuralı silmek yerine devre dışı bırakın.
Yönlendirme yok. Projede herhangi bir yönlendirme varsa iletim açıktır — hiçbir hedefe bağlı olmayan bir kaynak hiçbir yere iletmez. Akış → Yönlendirme'yi kontrol edin. Gereksiz görünen bir yönlendirmeyi kaldırmak bir kaynağı sessizce yalnız bırakabilir.
Başarısız iletimler ve ölü mektuplar
Başarısız bir iletim artan beklemelerle yeniden denenir. Sekiz başarısız denemeden sonra ölü mektuba düşer ve deneme sayısıyla Ölü mektuplar sayfasında görünür.
Ölü mektuplar kaybolmuş değil, park etmiştir.
Düzeltin, sonra yeniden gönderin
- Sebebi düzeltin — hedef adresini düzeltin, belirteci yenileyin, çıktı yapısını onarın; hata neyse.
- Ölü mektuplar'ı açın ve Yeniden gönder'e basın.
Yeniden gönderim eski kaydın üzerine yazmak yerine yeni bir iletim oluşturur; böylece neyin yanlış gittiğinin geçmişi bozulmaz.
Yaygın sebepler
| Hata | Genelde |
|---|---|
| Bağlantı reddedildi / zaman aşımı | Hedef kapalı ya da Merkez'den erişilemiyor |
| 401 / 403 | Süresi dolmuş belirteç, döndürülmüş kimlik bilgisi, IP kısıtı |
| 404 | Uç nokta adresi değişmiş |
| 400 / 422 | Hedef biçimi reddediyor — çıktı yapısını kontrol edin |
| 5xx | Alıcının kendi sorunu; sağlıklı olunca yeniden gönderin |
Her düzeltmeden sonra hedefin Test et düğmesini kullanın. Bir sonraki uplink'i beklemek yerine bağlantıyı hemen dener.
İletildi ama veri yanlış görünüyor
İletim başarılı olduğuna göre bu bir biçimlendirme veya çözme sorusudur. İşleme hattı sırası nereye bakacağınızı söyler:
- Yük hâlâ hex — çözücü yok, yanlış profil ya da çözücü hata verdi.
payload.decodeErroralanına bakın. - Alanlar eksik — çıktı yapısı onları dışarıda bırakıyor ya da o mesajda
yoklardı. Eksik alanlar
nullolarak değil, hiç gönderilmez. - Biçim mesajdan mesaja değişiyor — bazı callback'ler yük taşımadığı için yalnızca-çözülmüş bir yapı geri düşüyor.
- Tekrarlar — beklenen durum. Merkez
en az bir kez iletir;
idempotencyKeyüzerinden ayıklayın.
Kısa kontrol listesi
- Analitik — alınan / iletilen / başarısız'dan hangisi yanlış?
- Ölü mektuplar — park etmiş bir şey var mı, kaç deneme?
- Akış → Kurallar — bir şey atıyor mu?
- Akış → Yönlendirme — çift gerçekten bağlı mı?
- Hedef → Test et — bağlantı çalışıyor mu?
- Alıcının kendi günlükleri — kabul edip atıyor mu?