Bu sayfa cihaz yazılımı veya ağ geçidi yazılımı yazan kişilere yöneliktir. Hermetry’nin bir bağlantıyı reddettiğinde ya da sonlandırdığında ne yaptığını ve bir cihazın bağlantıya nasıl geri dönmesi gerektiğini tek bir yerde toplar. Bağlantı ayarları, oturum açma bilgileri ve Log sekmesinde gösterilen bağlantı kesilme nedenleri MQTT sayfasındadır; genel cihaz kuralları ise Protokol sürümleri ve cihaz kuralları sayfasındadır.
Hermetry’nin gönderdiği CONNACK kodları
| Kod | Hermetry bunu ne zaman gönderir | Zamanlama |
|---|---|---|
| 0 | Oturum açma kabul edilir | 60 saniye bağlı kaldıktan sonra sıfırla (aşağıya bakın) |
| 1 | CONNECT, Hermetry’nin desteklemediği bir protokol seviyesi içindir, örneğin MQTT 5 | Dur. İstemciyi düzelt. |
| 3 | Servis başlıyor, duruyor ya da meşgul; cihazın adresi başarısız oturum açmalardan sonra kısa süreliğine engellenir; bir MQTT kullanıcı adı tekrarlanan yanlış parolalardan sonra geri tutulur; cihaz bir devralma çekişmesinden sonra geri tutulur; platform yük altındadır ve kuruluşunuzu geri tutar | Normal |
| 4 | Bilinmeyen erişim belirteci, yanlış MQTT kullanıcı adı veya parola ya da kullanıcı adı olmayan bir CONNECT | Uzun |
| 5 | Yetkisiz: cihaz devre dışı, sertifikası iptal edilmiş ya da süresi dolmuş, kuruluş askıya alınmış ya da cihaz veya bağlı cihaz sınırına ulaşmış ya da profil bu oturum açma türüne, ağa veya bağlantı noktasına izin vermiyor | Uzun |
Hermetry, MQTT 3.1.1 üzerinden CONNACK 2 göndermez. İstemci kimliği hiçbir zaman oturum açmayı reddetme nedeni değildir: her istemci kimliği kabul edilir ve oturum, cihazın seri numarasının altına (seri numarası yoksa cihaz kimliğinin altına) kaydedilir. Bir kodun arkasındaki neden cihaza asla gönderilmez; cihazın Log sekmesine yazılır.
CONNACK gönderilmeden kapatılan bağlantılar
Bazı bağlantılar CONNACK gönderilemeden önce kapatılır. Cihaz yalnızca kapanmış bir soket görür ve normal zamanlamayı izler.
| Durum | Varsayılan |
|---|---|
| TLS el sıkışması ve CONNECT zamanında tamamlanmaz | TCP bağlantısından itibaren 5 saniye |
| Aynı herkese açık adresten çok fazla bağlantı aynı anda oturum açmaya çalışıyor | Her broker düğümünde adres başına 64 |
| Adres, başarısız oturum açmalardan sonra engellenir | 5 dakika içinde 10’dan fazla başarısız oturum açma, adresi 60 saniye engeller |
Hermetry’nin sonlandırdığı oturumlar
Hermetry bir bağlantı kesilmesinde neden kodu göndermez: cihaz bağlantının kapandığını görür. Cihazın bundan sonra yapması gerekenler:
| Oturumun sona ermesinin nedeni | Yapılması gerekenler |
|---|---|
| Keepalive süresinin 1,5 katı kadar bir süre hiçbir şey gelmedi | Normal zamanlamaya göre yeniden bağlanın. Cihazın boşta iken PINGREQ gönderdiğini kontrol edin. |
| Aynı cihazın başka bir bağlantısı oturumu devraldı | Normal zamanlamaya göre yeniden bağlanın. Bu tekrarlanıyorsa iki cihaz aynı kimlik bilgisini paylaşıyor demektir. |
| Kimlik bilgisi yenilendi ya da iptal edildi, cihaz devre dışı bırakıldı ya da silindi, kuruluş askıya alındı (yaklaşık 60 saniyede bir yeniden kontrol edilir) | Normal zamanlamaya göre yeniden bağlanın. Bir sonraki CONNACK (4 veya 5), cihazı uzun zamanlamaya alır. |
| Cihaz hız sınırını sürekli aşıyordu | Normal zamanlamaya göre yeniden bağlanın, ardından daha az gönderin. Bkz. Cihaz profilleri. |
| Bir broker düğümü yeniden başlatılıyor | Bağlantıları yaklaşık 30 saniye içinde rastgele sırayla kapatılır. Normal zamanlamaya göre yeniden bağlanın; kapanmakta olan bir düğüme ulaşan CONNECT, CONNACK 3 alır. |
| Bir ileti kuyruğa alınamadı (PUBACK almadı) | Oturum yaklaşık 5 saniye sonra kapatılır. Yeniden bağlanın, ardından onaylanmamış iletileri yeniden gönderin. |
Keepalive
- 60 saniye keepalive ile bağlanın ve gönderilecek başka bir şey yokken PINGREQ gönderin.
- Hermetry, keepalive süresinin 1,5 katı kadar bir süre hiçbir şey gelmezse oturumu kapatır: 60 için 90 saniye.
- Keepalive değeri 0 ise ya da broker’ın maksimumunun (varsayılan 300 saniye) üzerindeyse, maksimum değerle işlenir.
- Will iletisi kabul edilir ve yok sayılır. Bağlantı durumuna Hermetry kendisi karar verir.
İki geri çekilme zamanlaması
| Normal zamanlama | Uzun zamanlama | |
|---|---|---|
| Kullanım koşulu | Ağ kesintisi, kapanmış soket, CONNACK 3 | İlk CONNACK 4 veya 5 |
| İlk bekleme | 1 saniye (bir cihaz 5 saniyeye kadar geç başlayabilir) | 5 dakika (bir cihaz 15 dakikaya kadar geç başlayabilir) |
| Sonraki beklemeler | Her seferinde iki katına çıkar | Her seferinde iki katına çıkar |
| En uzun bekleme | 5 dakika (cihazın aktif uplink’i ölçümlü iken 30 dakikaya kadar) | 1 saat |
| Jitter | Her bekleme, 0,5 ile 1,5 arasında rastgele bir çarpanla çarpılır | Aynı |
Zamanlamalara eşlik eden kurallar:
- En az 60 saniye süren bir bağlantıdan sonra zamanlamayı sıfırlayın. Daha erken kopan bir bağlantı sıfırlamaz; böylece sunucunun sürekli kapattığı bir cihaz sıkı bir döngüde yeniden bağlanmaz.
- Normal zamanlama, cihaz aktif uplink’ini değiştirdiğinde de yeniden başlar; örneğin Ethernet’ten mobil veriye geçiş gibi.
- Açılıştan veya firmware güncellemesinden sonra, ilk denemeden önce rastgele 0 ile 30 saniye bekleyin. Böylece güncellenen cihazların dalgası tek bir yükseliş olarak yeniden bağlanmaz.
- CONNACK 1 alındığında, istemci düzeltilene kadar durun.
Uzun zamanlama, sorun giderildikten sonra cihazı yaklaşık 90 dakika içinde geri getirir; örneğin cihaz yeniden etkinleştirildiğinde ya da planı yükseltildiğinde.
/* Wait before reconnect attempt n (n = 0, 1, 2 ...), in seconds. */
double backoff_s(int n, int long_schedule)
{
double first = long_schedule ? 300.0 : 1.0;
double cap = long_schedule ? 3600.0 : 300.0;
double wait = first * pow(2.0, n);
if (wait > cap)
wait = cap;
return wait * (0.5 + (double)rand() / RAND_MAX); /* factor 0.5 to 1.5 */
}
İpucu
Rastgele sayı üretecini her cihazda farklı bir tohumla başlatın; örneğin seri numarasından ve bir donanım rastgele kaynağından. Aynı tohumu paylaşan cihazlar aynı beklemeleri seçer ve yine aynı anda gelir.
Tekrarlanan yanlış parolalar
15 dakika içinde aynı ağdan aynı MQTT kullanıcı adı için 5’ten fazla başarısız oturum açmadan (CONNACK 4) sonra, o kullanıcı adına 15 saniye boyunca CONNACK 3 yanıtı verilir ve her yeni başarısızlıkta 5 dakikaya kadar iki katına çıkar. CONNACK 4 almış ve sonra CONNACK 3 alan bir cihaz genellikle hâlâ yanlış parolayı kullanıyordur: bir bağlantı başarılı olana kadar onu uzun zamanlamada tutun.
Cihaz HTTP API’si üzerinden
| Durum | Anlamı | Yapılması gerekenler |
|---|---|---|
429 rate_limited | Cihazın veya kuruluşun hızının, ya da istemci adresinin istek hızının üzerinde (varsayılan olarak saniyede 50, 200’e kadar patlamalar) | İstek kaydedilmedi. Retry-After saniye kadar bekleyin, ardından yeniden gönderin. |
429 blocked | Adres, başarısız oturum açmalardan sonra engellendi | Retry-After saniye kadar bekleyin (engelin kalanı). Belirteci düzeltin. |
503 | Servis meşgul, hazır değil ya da kapanıyor, ya da kuruluşunuzu geri tutuyor | Retry-After saniye (30) bekleyin, ardından normal zamanlamayı izleyin. |
401 | Belirteç yok ya da bilinmiyor | Uzun zamanlama. Belirteci kontrol edin. |
403 | Yetkisiz: cihaz devre dışı, kuruluş askıya alınmış, profilin izin verilen ağlarının dışında ya da bir profil kuralı (tls_required, quarantined) | Uzun zamanlama ya da yapılandırmayı düzeltin. |
400, 413 | İleti kendisi hatalı ya da çok büyük | Aynı iletiyi yeniden göndermeyin. |
Cihaz geri geldikten sonra
MQTT sayfasındaki bağlantı sırasını izleyin: abone olun, hello gönderin, paylaşılan öznitelikleri isteyin, ardından canlı verilerden önce tamponlanmış okumaları gönderin. Uzun bir kesintiden sonra iki nokta önemlidir:
- Tamponlanmış okumalar, cihazın paylaşılan
session_limitsözniteliğinde bulduğu yeniden oynatma hızına uymalıdır. Bağlantının izin verdiği en yüksek hızda tüm tamponu göndermeyin. - Bir kesintiden sonra birçok cihaz ayarlarını aynı anda ister ve Hermetry bunları zamanlar. Yanıtta eksik olan ayar bölümleri birkaç an sonra aynı biçimde
v1/attributes/setüzerinden gelebilir. Geldikleri anda uygulayın.

