Bu sayfa, bir akış bir okumayı kaydettiğinde Hermetry’nin neyi ve neden yazdığını açıklar. Bunu bilmek, bir grafiğin ya da API’nin ne döndüreceğini tahmin etmenize ve bazı değerlerin neden bir yerde görünüp başka bir yerde görünmediğini anlamanıza yardımcı olur.
Yalnızca akışlar veri saklar
Bir cihaz mesajı, bir akış bunu söylediği için saklanır. Her kuruluş, her cihaz mesajını alan ve telemetriyi ve istemci özniteliklerini kaydeden bir Varsayılan kök akış ile başlar. Telemetri kaydet bloğu, telemetrinin yazılmasının tek yoludur:
- Bloğu (veya ona giden dalı) kaldırırsanız okumalar artık saklanmaz. Bağlantı ayrı izlendiği için cihaz yine de çevrimiçi görünür.
- Yalnızca
msg.payloadsaklanır. Mesajın meta verileri (konu, aktarım, cihaz adı) hiçbir zaman saklanmaz. - Bir akışın test çalıştırması hiçbir şeyi kaydetmez.
Bkz. Ana bilgisayarlar, kök akış ve profil kök akışları.
Mesaj başına bir satır
Telemetri kaydet bloğu bir kayıt yazdığında, depo anahtar başına değil, tüm kayıt için bir satır ekler:
| Satırın parçası | İçerir |
|---|---|
| Cihaz ve zaman | Cihazın kimliği ve kaydın zaman damgası (milisaniye, UTC) |
| Sayılar | Her sayısal değer, anahtar kimliğiyle saklanır |
| Diğer değerler | Mantıksal değerler, metin ve JSON değerleri, anahtar adıyla saklanır |
| Mesaj parmak izi | Değerlerin karma özeti; aynı mesajın iki kez iletildiğini tanımak için kullanılır |
8 anahtarlı bir kayıt tek bir satırdır. Bu, depolamayı kompakt tutar ve API’nin bir bütün mesajı tek seferde döndürmesine olanak tanır.
Anahtar sözlüğü
Kuruluşunuzun kullandığı her anahtar, ilk kez saklandığında kuruluşa özel sözlükte küçük bir numara alır. Sözlük tüm cihazlarınız tarafından paylaşılır: temperature, bunu bir cihaz gönderse de on bin cihaz gönderse de tek bir anahtardır.
- Anahtarlar hiçbir zaman yeniden adlandırılmaz ya da yeniden kullanılmaz. Bir anahtar, onu gönderen cihazlar silindikten sonra da sözlükte kalır.
- Planınız farklı anahtar sayısına bir üst sınır koyabilir. Sınırı aşan yeni bir anahtar saklanmaz, aynı kaydın diğer anahtarları saklanır. Bkz. Telemetri anahtarları.
Son değerler
Geçmişin yanında depo, cihaz ve anahtar başına zaman damgasıyla birlikte bir son değer tutar. Gösterge panellerinin değer kartları, cihazın Telemetri sekmesi ve Son değerler akış bloğu bunu okur.
Son değer yalnızca kesinlikle daha yeni bir zaman damgasına geçer:
- Daha eski bir zaman damgasına sahip bir okuma (daha yeni bir okumadan sonra gelen tamponlanmış bir birikim) geçmişte saklanır ancak son değerin yerini almaz.
- Aynı zaman damgasıyla yapılan bir düzeltme yeniden gönderimi, değerleri farklıysa kendi mesajı olarak saklanır, ancak son değer ilkini korur.
Böylece geçmiş, son değerler ve canlı görünüm her zaman uyumlu kalır.
Toplamlar ve özetler
Uzun zaman aralıklarının hızlı okunabilmesi için sayılar ayrıca özetlenir:
| Düzey | İçerik | Dolduran |
|---|---|---|
| 1 dakikalık toplamlar | Sayısal anahtar ve dakika başına: toplam, sayı, en küçük, en büyük ve son değer | Her dakika çalışan bir iş |
| Saatlik özetler | Saat başına aynı beş değer | Dakika toplamlarından türetilir |
| Günlük özetler | Gün başına aynı beş değer (UTC) | Dakika toplamlarından türetilir |
Metin, mantıksal değerler ve JSON değerleri toplanmaz. Zaten özetlenmiş bir dakika için geç gelen bir okuma, o dakikayı yeniden işleme için işaretler, böylece geç veriler dahil edilir. Bkz. Toplamlar ve özetler.
Bir okuma hangi kaynağı kullanır
| Zaman aralığı | Okunan kaynak |
|---|---|
| 24 saate kadar | Ham mesaj satırları (her okuma) |
| Daha uzun | 10.000 kovanın altında kalan en ince özet: dakika, sonra saat, sonra gün |
API’de belirli bir çözünürlük de isteyebilirsiniz. Bkz. Geçmiş API’si.
Saklama süresi
Her düzey kendi süresi boyunca tutulur. Ham satırlar en fazla 90 gün, dakika toplulaştırmaları en fazla 31 gün, saat ve gün rollup’ları ise planınızın tam saklama sınıfı boyunca tutulur. Bkz. Veriler ne kadar süre saklanır.
Canlı değerler
Bir kayıt onaylandıktan sonra, yeni değerler cihazı izleyen açık gösterge panellerine ve cihaz sayfalarına gönderilir. Kaydedilmemiş bir değer (örneğin kök akışın süzdüğü bir anahtar) hiçbir zaman canlı görünmez. Canlı iletim anahtar başına saniyede en fazla dört güncellemedir; aradaki değerler yine de saklanır.
Bir cihaz silindiğinde
Bir cihazın silinmesi, okumalarını, dakika toplamlarını, özetlerini ve son değerlerini arka planda, seferde bir günlük veri olarak kaldırır. Cihazın kullandığı anahtarlar sözlükte kalır.
Sayım
| Sayaç | Anlamı |
|---|---|
| IoT mesajları | Cihazlardan kabul edilen telemetri ve öznitelik mesajları; bir akış saklasa da saklamasa da geldikleri anda sayılır |
| Saklanan IoT veri noktaları | Deponun gerçekten eklediği değerler. Depo tarafından atılan yinelenen değer sayılmaz. Kota yoktur. |
Bkz. Mesaj kotası ve kullanım.