Bu sayfa, bir akış bir okumayı kaydettiğinde Hermetry’nin neyi ve neden yazdığını açıklar. Bunu bilmek, bir grafiğin veya 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 telemetri ile istemci özniteliklerini kaydeden bir Varsayılan kök akış ile başlar. Telemetriyi kaydet bloğu, telemetrinin yazıldığı tek yoldur:
- Bloğu (veya ona giden dalı) kaldırırsanız okumalar artık saklanmaz. Bağlantı ayrı izlendiği için cihaz yine çevrimiçi görünür.
- Yalnızca
msg.payloadsaklanır. Mesajın meta verileri (konu, taşıma, cihaz adı) hiçbir zaman saklanmaz. - Bir akışın test çalıştırması hiçbir şey saklamaz.
Bkz. Ana bilgisayarlar, kök akış ve profil kök akışları.
Mesaj başına bir satır
Telemetriyi kaydet bloğu bir kayıt yazdığında, depo her anahtar için değil, tüm kayıt için bir satır ekler:
| Satırın bölümü | İçeriği |
|---|---|
| Cihaz ve zaman | Cihazın kimliği ve kaydın zaman damgası (milisaniye, UTC) |
| Sayılar | Her sayısal değer, anahtar kimliğine göre saklanır |
| Diğer değerler | Mantıksal değerler, metin ve JSON değerleri, anahtar adına göre saklanır |
| Mesaj parmak izi | Değerlerin karma değeri; 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 mesajın tamamını tek seferde döndürmesini sağlar.
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 arasında ortaktı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 veya yeniden kullanılmaz. Bir anahtar, onu gönderen cihazlar silindikten sonra da sözlükte kalır.
- Planınız farklı anahtar sayısını sınırlayabilir. Sınırın üzerindeki yeni bir anahtar saklanmaz, aynı kaydın diğer anahtarları ise 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. Panolardaki 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şe kaydedilir 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.
Bu sayede 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 | Dakikalık toplamlardan türetilir |
| Günlük özetler | Gün başına aynı beş değer (UTC) | Dakikalık toplamlardan 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şlenmek üzere işaretler, böylece geç veriler de dahil edilir. Bkz. Toplamlar ve özetler.
Bir okumanın hangi kaynağı kullandığı
| 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 toplamları en fazla 31 gün, saatlik ve günlük özetler ise planınızın tam saklama sınıfı boyunca tutulur. Bkz. Veriler ne kadar süre tutulur.
Canlı değerler
Bir kayıt işlendikten sonra, yeni değerler cihazı izleyen açık panolara ve cihaz sayfalarına gönderilir. Kaydedilmeyen 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ı silmek, 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 bir yinelenen kayıt sayılmaz. Kota yoktur. |
Bkz. Mesaj kotası ve kullanım.