Rehberler

İletim başarısız olduğunda

Mesajın nerede durduğunu bulun, sebebi düzeltin ve yeniden gönderin.

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ünenAnlamı
Alınan 0Hiçbir şey gelmiyor. Sorun yukarıda — Merkez'de değil, kaynakta.
Alınan > 0, İletilen 0, Başarısız 0Mesajlar 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 fazlaTeslimatlar başarılı, ama ancak yeniden denemelerden sonra. Hedef yavaş ya da kararsız.
Elenen > 0Kurallar mesaj düşürüyor ya da kaynak yinelenen gönderiyor.
İletilen > 0 ama aşağıda bir şey yokHedef 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:

  1. Callback doğru adrese mi bakıyor? Ağın yapılandırmasını Akış → Uç nokta ve şema ile karşılaştırın.
  2. 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.
  3. Paylaşılan gizli anahtar iki tarafta da aynı mı?
  4. Zorunlu başlıklar gönderiliyor mu? Eksik bir zorunlu başlık, başka hiçbir şey çalışmadan önce reddedilir.
  5. 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

  1. Sebebi düzeltin — hedef adresini düzeltin, belirteci yenileyin, çıktı yapısını onarın; hata neyse.
  2. Ölü mektuplar'ı açın ve Yeniden gönder'e basın.
Yeniden gönderim bugünkü yapılandırmayı kullanır
Yeniden gönderilen bir iletim, başarısız olduğu andaki değil, güncel çıktı yapısı ve hedef ayarlarıyla yeniden kurulur. "Dönüşümü düzelt, sonra yeniden gönder" yönteminin çalışmasının sebebi budur.

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

HataGenelde
Bağlantı reddedildi / zaman aşımıHedef kapalı ya da Merkez'den erişilemiyor
401 / 403Süresi dolmuş belirteç, döndürülmüş kimlik bilgisi, IP kısıtı
404Uç nokta adresi değişmiş
400 / 422Hedef biçimi reddediyor — çıktı yapısını kontrol edin
5xxAlı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.decodeError alanına bakın.
  • Alanlar eksik — çıktı yapısı onları dışarıda bırakıyor ya da o mesajda yoklardı. Eksik alanlar null olarak 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

  1. Analitik — hangi sayaç yanlış ve hangi proje, hedef ya da mesaj türü için?
  2. Ölü mektuplar — park etmiş bir şey var mı? Birini açın: hangi deneme nasıl başarısız oldu?
  3. Akış → Kurallar — bir şey atıyor mu?
  4. Akış → Yönlendirme — çift gerçekten bağlı mı?
  5. Hedef → Test et — bağlantı çalışıyor mu?
  6. Alıcının kendi günlükleri — kabul edip atıyor mu?

Sırada

İşleme hattı
Aşama sırası ve belirtiden aşamaya tablosu.
Mesajlar ve iletimler
Yeniden denemeler, ölü mektuplar ve gerçekte ne saklanır.
Copyright © 2026