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 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ü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.
Başarısız > 0İletim deneniyor ve reddediliyor. Hedef ya da yapılandırması.
İ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. 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

  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 eski kaydın üzerine yazmak yerine yeni bir iletim oluşturur; böylece neyin yanlış gittiğinin geçmişi bozulmaz.

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 — alınan / iletilen / başarısız'dan hangisi yanlış?
  2. Ölü mektuplar — park etmiş bir şey var mı, kaç deneme?
  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