Her cihazın, listelerin, kartları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 yaptıklarından (bağlanma, bağlantıyı kesme, mesaj gönderme) cihaz profilinin çevrimiçi kuralına göre 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 kullanım |
|---|---|---|---|
| Canlı bağlantı | 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. |
| Son mesaj | 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â yeniyse yalnızca bağlantının kesilmesi cihazı çevrimdışı yapmaz. | Rapor edip bağlantısını kesen cihazlar, HTTP cihazları, LoRaWAN sensörleri. |
| Yalnızca son görülme | 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 olayı, daha yeni bir bağlantı kesilmesinden sonra cihazı çevrimiçi yapmaz.
- Dakika başı yapılan denetim, pencereleri sona eren veya oturum kiralaması süresi dolan cihazları çevrimdışı yapar ve değiştirilen çevrimiçi kuralını uygular.
- Gateway alt cihazları, gateway’lerinin
v1/gw/connectvev1/gw/disconnectmesajlarını izler ve gateway çevrimdışı olduğunda onlar da çevrimdışı olur.
Listelerin gösterdikleri
| Gösterim | Anlamı |
|---|---|
| Çevrimiçi | Profilin kuralına göre cihaz şu anda çevrimiçidir. |
| Çevrimdışı | Çevrimiçiydi, şimdi değil. Hızlı görünüm Last disconnect: neden bilgisini ekler. |
| Last seen zaman | Profil Last seen only kullanır. |
| Hiç bağlanmadı | Cihazdan henüz hiçbir şey alınmadı. |
| Stale: no data for zaman | Stale after (seconds) ayarlı bir cihaz tablosu kartında: çevrimiçi, ancak bu süreden uzun süredir veri yok. |
Cihazın Overview sayfası Last activity, Last connected ve Last disconnected değerlerini gösterir. IP address, en yeni bağlantının adresidir; hiç bağlanmayan (HTTP, sorgulanan) bir cihaz için ise en yeni etkinliğinin 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, 10 ile 604.800 arası), cihaz bu süre boyunca hiçbir şey göndermediğinde 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. Rapor vermeyi bırakan bir cihaz için alarmlar, profilin alarm kurallarındaki Device offline rule ile kurulur; bunun kendi süresi vardır (Open after (seconds offline)). Bkz. Offline alarms.
Log sekmesi
Cihazın Log sekmesi, bağlantı geçmişini ve üzerinde yapılan değişiklikleri tek bir zaman çizelgesinde, en yeniden eskiye gösterir. Show seçeneği All, Connections veya Changes ile filtreler; Load more daha eski kayıtları yükler.
Bağlantı olayları
| Olay | Ayrıntı |
|---|---|
| Bağlı | taşıma üzerinden (örneğin mqtts), istemcinin adresinden |
| Bağlantı kesildi | Reason: neden |
| Yeni bir oturum tarafından devralındı | Aynı cihazın ikinci bir bağlantısı devraldı. |
| Yalnızca son görülme durumuna geçirildi | 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.
Bağlantı geçmişi 30 gün saklanır. Last seen only profilindeki cihazlar bağlanma ve bağlantı kesilme kaydı yazmaz.
Webhook’lar
Bağlantı değişikliklerini diğer sistemlere bildiren iki webhook olayı vardır:
| 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ı Devices > ⋯ > Settings (grup Webhooks) altındaki iki ayar kontrol eder:
| Ayar | Varsayılan | Aralık |
|---|---|---|
| Bağlantı webhook’ları: bekleme süresi (saniye) | 30 | 5 ile 3.600 arası. Sürekli bağlanıp kopan bir cihaz hiçbir şey göndermez. |
| Çalışma alanı başına dakikadaki cihaz webhook sayısı | 600 | 1 ile 100.000 arası. Dakikanın geri kalanı atılır ve yöneticilerinize bir kez bildirilir. Cihaz yaşam döngüsü webhook’larının aynı limite sahip kendi sayaçları vardır. |
device.connected içindeki adres yalnızca bir ağ önekidir. Her olay bir idempotency anahtarı taşır; alıcı sisteminiz tekrarları yok sayabilir. Bkz. Webhooks.
Cihazları saymak
Gösterge panelleri Devices, Devices online, Devices offline ve Devices never connected değerlerini sayaç olarak gösterebilir; cihaz tablosu kartı her satırdaki 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 yeni önce (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ç çevrimiçi olmuyor | Profili Live connection kullanıyor. Recent message kullanın. |
| Bir cihaz çevrimiçi ve çevrimdışı arasında gidip geliyor | İki cihaz aynı kimlik bilgisini paylaşıyor (Taken over by a new session kaydına bakın) ya da keepalive ağ için çok kısa. |
| Durduktan çok sonra çevrimdışı olarak işaretleniyor | 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 veya verileri atılıyor (karantinadaki cihaz, hız limiti, hatalı payload). Bkz. Veri ulaşmıyor. |

