İletim başarısız olduğunda
Bir şey ulaşmıyor. Nerede durduğunu böyle bulursunuz.
Analitik ile başlayın
Analitik, bir zaman aralığında hattın yaptıklarını sayar — Alınan, Teslim edilen, Ölü mektup, Teslimat denemeleri (ve kaçının yeniden deneme olduğu) ve Elenen (bir kuralın düşürdüğü ya da yinelenen) — ve her sayıyı projeye, kiracıya, teknolojiye, sağlayıcıya, mesaj türüne, kaynağa, hedefe, profile ya da cihaza göre daraltmanıza izin verir. Hangisinin yanlış olduğu sistemin hangi yarısına bakacağınızı söyler; Dağılım paneli hangi projenin, hedefin ya da mesaj türünün olduğunu söyler ve her satır eşleşen ölü mektupları açar.
| 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. |
| Ölü mektup > 0 | İletim deneniyor ve reddediliyor. Hedef ya da yapılandırması. Hedefe göre başarısızlıklar hangisi olduğunu söyler. |
| Denemeler teslim edilenden çok fazla | Teslimatlar başarılı, ama ancak yeniden denemelerden sonra. Hedef yavaş ya da kararsız. |
| Elenen > 0 | Kurallar mesaj düşürüyor ya da kaynak yinelenen gönderiyor. |
| İ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. Projesinin teslimat politikasının izin verdiği denemeleri tükettiğinde — varsayılan sekiz, 5 sn → 10 sn → 20 sn … eğrisiyle — ölü mektuba düşer ve Ölü mektuplar sayfasında görünür. Politika proje sayfasındadır (Teslimat ve ölü mektuplar): deneme sayısı, ilk gecikme, çarpan, en uzun bekleme, deneme başına zaman aşımı ve ölü mektupların ne kadar saklanacağı; kart, siz düzenlerken ortaya çıkan yeniden deneme takvimini gösterir.
Ölü mektuplar kaybolmuş değil, park etmiştir. Liste Analitik ile aynı biçimde filtrelenir — kiracı, proje, teknoloji, sağlayıcı, mesaj türü, kaynak, hedef, profil, cihaz — artı hata metni, cihaz kimliği ya da bir kimlik üzerinde arama; her satır kaynak → hedef çiftini, radyoyu, mesaj türünü, HTTP durumunu ve ne zaman ölü mektuba düştüğünü gösterir.
Ne olduğunu görmek için bir mektubu açın. Çekmecedeki zaman çizelgesi her denemeyi — numarası, HTTP durumu, hata sınıfı, süresi ve yük boyutuyla — her yeniden oynatma boyunca listeler; ardından bağlam (proje, kaynak, hedef, cihaz, profil, mesaj türü; hepsi bağlantı), onu yöneten politika ve yeniden gönderilecek gövde gelir.
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 aynı teslimatın yeni bir turunu başlatır: denemeleri bugünkü politikayla birden yeniden başlar ve önceki her deneme, yeniden oynatmanın kendisi ve kimin istediğiyle birlikte zaman çizelgesinde kalır. Eşleşenlerin tümünü yeniden oynat, geçerli filtrelerle eşleşen her ölü mektubu en eskisinden başlayarak yeniden sıraya alır.
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 — hangi sayaç yanlış ve hangi proje, hedef ya da mesaj türü için?
- Ölü mektuplar — park etmiş bir şey var mı? Birini açın: hangi deneme nasıl başarısız oldu?
- 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?