Her cihazın; listelerin, panoların ve kuralların ve alarmların okuduğu bir bağlantı durumu vardır: çevrimiçi mi, en son ne zaman haber alındı, sessizliğe mi gömüldü. Hermetry bunu, cihazın ne yaptığından (bağlanır, bağlantısını keser, mesaj gönderir) cihaz profilinin çevrimiçi kuralı uyarınca türetir. Bu sayfa kuralları, zaman damgalarını, cihazın Log sekmesini ve webhook’ları açıklar.
Çevrimiçi kuralı
Kural, profilin Online status sekmesinde ayarlanır ve hiçbir zaman taşıma katmanından türetilmez. Bkz. Device profiles.
| Kural | Çevrimiçi | Çevrimdışı | Uygun olduğu durumlar |
|---|---|---|---|
| Live connection | Cihaz MQTT üzerinden bağlandığında. | MQTT oturumu sona erdiğinde (bağlantı kesilmesi, keepalive zaman aşımı, yeni oturum açılmadan devralma, reddetme). | MQTT bağlantısını açık tutan cihazlar. |
| Recent message | Cihaz bağlandığında veya herhangi bir şey gönderdiğinde. | Expected interval × Factor süresi boyunca hiçbir şey gelmediğinde (örneğin 3.600 s × 3 = 3 saat). Son mesajı hâlâ yeniyken yalnızca bağlantı kesilmesi cihazı çevrimdışı yapmaz. | Rapor edip bağlantısını kesen cihazlar, HTTP cihazları, LoRaWAN sensörleri. |
| Last seen only | Hiçbir zaman çevrimiçi veya çevrimdışı olarak gösterilmez. | — | Sorgulanan (polled) cihazlar, ritmi bilinmeyen cihazlar. |
Ayrıntılar:
- Bir HTTP isteği bir bağlantı değil, etkinliktir. Live connection profilinde bir HTTP cihazı hiçbir zaman çevrimiçi olmaz.
- Sırası karışık gelen olaylar durumu hiçbir zaman geriye taşımaz: eski bir bağlanma, daha yeni bir bağlantı kesilmesinden sonra cihazı çevrimiçi yapmaz.
- Dakikada bir yapılan denetim, pencere süresi dolan veya oturum kiralaması sona eren cihazları çevrimdışı yapar ve değiştirilmiş çevrimiçi kuralını uygular.
- Ağ geçidi alt cihazları, ağ geçitlerinin
v1/gw/connectvev1/gw/disconnectmesajlarını izler ve ağ geçidi çevrimdışı olduğunda onlar da çevrimdışı olur.
Listelerin gösterdikleri
| Gösterilen | Anlamı |
|---|---|
| Online | Profilin kuralına göre cihaz şu anda çevrimiçidir. |
| Offline | Daha önce çevrimiçiydi, şimdi değil. Hızlı görünüm Last disconnect: reason bilgisini ekler. |
| Last seen time | Profil Last seen only kullanıyor. |
| Never connected | Cihazdan henüz hiçbir şey alınmadı. |
| Stale: no data for time | Stale after (seconds) ayarlı bir cihaz tablosu kartında: çevrimiçi, ama bu süreden uzun süredir veri yok. |
Cihazın Overview sayfasında Last activity, Last connected ve Last disconnected gösterilir. IP address, en yeni bağlanmanın adresidir; hiç bağlanmayan cihazlarda (HTTP, sorgulanan) ise en yeni etkinliğin adresidir.
Hareketsizlik: çevrimiçi ama sessiz
Bir cihaz bağlantısını koruyup yine de hiçbir şey göndermeyebilir. Profilin Inactivity timeout (seconds) ayarı (varsayılan 600, aralık 10 ila 604.800), cihazın bu süre boyunca hiçbir şey göndermemesi halinde onu etkin değil olarak işaretler. Etkin değil, çevrimdışı demek değildir.
Bunu Rules kartındaki A device connects or disconnects > goes quiet tetikleyicisinde kullanın. Raporlamayı durdurduğunda bir cihaz için alarmlar, profilin alarm kurallarındaki ve kendi süresi (Open after (seconds offline)) olan Device offline rule ile ayarlanır. Bkz. Offline alarms.
Log sekmesi
Cihazın Log sekmesi, bağlantı geçmişini ve bu geçmişte yapılan değişiklikleri tek bir zaman çizelgesinde, en yeniden eskiye gösterir. Show, All, Connections veya Changes olarak filtreler; Load more daha eskiye gider.
Bağlantı olayları
| Olay | Ayrıntı |
|---|---|
| Connected | taşıma katmanı üzerinden (örneğin mqtts), istemcinin adresinden |
| Disconnected | Reason: reason |
| Taken over by a new session | Aynı cihazın ikinci bir bağlantısı devraldı. |
| Switched to last seen only | Profilin kuralı Last seen only olarak değişti. |
Bağlantı kesilme nedenleri: client_disconnect, keepalive_timeout, takeover, auth_revoked, rate_limit, server_shutdown, uplink_window_expired (Recent message penceresi sona erdi) ve online_rule_changed. Reddedilen bir giriş (CONNACK 5) da nedeniyle birlikte kaydedilir; bu neden cihaza hiçbir zaman gönderilmez.
Changes, denetlenen değişikliklerdir: Device created, Device edited (değişen alanlarla), Device activated, Device quarantined, Device disabled, Credential replaced, Credential rotated, Credential revoked, Attributes saved, Attributes deleted, gönderilen, iptal edilen, reddedilen ve tamamlanan komutlar ile onaylanan ve temizlenen alarmlar; her biri by bir kişi veya by the system tarafından yapılmış olarak kaydedilir.
Bağlantı geçmişi 30 gün saklanır. Last seen only kullanan cihazlar bağlanma ve bağlantı kesilme satırı yazmaz.
Webhook’lar
İki webhook olayı, bağlantı değişiklikleri hakkında diğer sistemleri bilgilendirir:
| Olay | Gönderilme zamanı |
|---|---|
device.connected | Cihaz çevrimiçi oldu ve bekleme süresi boyunca çevrimiçi kaldı. |
device.disconnected | Cihaz çevrimdışı oldu ve bekleme süresi boyunca çevrimdışı kaldı. |
{ "deviceId": "…", "name": "router-17", "profileId": "…", "transport": "mqtts", "connectedAt": "2026-11-03T10:00:00.000Z", "remoteIpPrefix": "203.0.113.0/24" }{ "deviceId": "…", "name": "router-17", "profileId": "…", "reason": "timeout", "disconnectedAt": "2026-11-03T12:00:00.000Z", "lastSeenAt": "2026-11-03T11:59:40.000Z", "onlineSeconds": 7200 }Bunları denetleyen iki ayar, Devices > ⋯ > Settings (grup Webhooks) altındadır:
| Ayar | Varsayılan | Aralık |
|---|---|---|
| Connection webhooks: hold time (seconds) | 30 | 5 ila 3.600. Sürekli bağlanıp kopan bir cihaz hiçbir şey göndermez. |
| Device webhooks per workspace and minute | 600 | 1 ila 100.000. Dakikanın kalanı atılır ve yöneticileriniz bir kez bilgilendirilir. Cihaz yaşam döngüsü webhook’ları kendi sayacına sahiptir ve aynı sınır geçerlidir. |
device.connected içindeki adres yalnızca bir ağ önekidir. Her olay bir idempotency anahtarı taşır, bu yüzden alıcı sisteminiz tekrarları yok sayabilir. Bkz. Webhooks.
Cihazları sayma
Paneller Devices, Devices online, Devices offline ve Devices never connected değerlerini sayaç olarak gösterebilir; cihaz tablosu kartı ise her satırda canlı bağlantı durumunu gösterir. Bkz. Tables and lists.
API
| Çağrı | Döndürür |
|---|---|
GET /tenant/{tenantId}/api/iot/devices/{deviceId}/connections?page=1&pageSize=50 | Bağlantı günlüğü, en yeniden eskiye (sayfa başına en fazla 100). |
GET …/devices/{deviceId}/log?source=connection | Log sekmesinin günlüğü; source değeri connection veya audit olabilir, en fazla 1.000 kayıt derinliğindedir. |
GET …/devices/{deviceId}/connection | Cihazın bağlandığı yer: broker, HTTPS tabanı, konular ve anahtarlar. Gizli bilgi yoktur. |
Sorun giderme
| Belirti | Neden |
|---|---|
| Bir HTTP cihazı hiçbir zaman çevrimiçi olmaz | Profili Live connection kullanıyor. Recent message kullanın. |
| Bir cihaz çevrimiçi ile çevrimdışı arasında gidip gelir | İki cihaz tek bir kimlik bilgisini paylaşıyor (Taken over by a new session satırına bakın) ya da keepalive ağ için çok kısa. |
| Durduktan çok sonra hâlâ çevrimdışı görünmüyor | Expected interval × Factor çok uzun. Kısaltın ya da kendi süresi olan bir çevrimdışı alarmı ekleyin. |
| Çevrimiçi ama değer yok | Cihaz hiçbir şey göndermiyor ya da verisi düşürülüyor (karantinaya alınmış cihaz, hız sınırı, hatalı yük). Bkz. Data does not arrive. |