Telemetri, cihazlarınızın zaman içinde ölçtüğü ve bildirdiği şeylerdir: sıcaklıklar, seviyeler, sayaçlar, durumlar. Bu bölüm, bir ölçüm geldikten sonra neler olduğunu, her ayrıntı düzeyinin ne kadar süreyle saklandığını, ölçümlerin nasıl geri okunduğunu (konsolda, panolarda, API üzerinden) ve ölçümlerin planınızdaki kotaya nasıl sayıldığını açıklar.
Bir ölçümün izlediği yol
- Bir cihaz bir mesaj gönderir (MQTT, HTTP, LoRaWAN, bir ağ geçidi veya bir poller). Mesaj, aylık mesaj kotanıza sayılır.
- Mesaj kök akışınıza girer, kayıtlara (her zaman damgası için bir kayıt) ayrılır ve anahtarlar ile değerler anahtar kurallarına göre denetlenir.
- Alarm kuralları bloğu, cihaz profilinin alarm kurallarını değerlendirir.
- Telemetriyi kaydet bloğu kaydı yazar. Telemetriyi yalnızca bu blok saklar; bu bloğu içermeyen bir dal hiçbir şey saklamaz.
- Depo mesajı tutar, cihazın her anahtar için en son değerini günceller ve dakika işi sayıları 1 dakikalık toplamlara dönüştürür; ardından saat ve gün özetleri oluşturulur.
- Paneller, cihazın Telemetri sekmesi, akışlar ve API, zaman aralığına bağlı olarak en son değerlerden, ham satırlardan veya özetlerden okur.
Bkz. Ölçümler nasıl saklanır ve Ana bilgisayarlar, kök akış ve profil kök akışları.
Temel bilgiler
| Konu | Bilgi |
|---|---|
| Anahtarlar | A-Z a-z 0-9 _ . - karakterlerinden oluşan, en fazla 64 karakter; büyük/küçük harf duyarlı. _, fw_, current_fw_ ve cfg. önekleri ayrılmıştır. |
| Değerler | Sayılar, true/false, en fazla 1.024 karakterlik metin, en fazla 4 KiB’lik JSON nesneleri veya dizileri. Yalnızca sayılar grafiklenir ve toplanır. |
| Zaman damgaları | Epoch’tan bu yana milisaniye, UTC. Gelecekte 10 dakikadan fazla olan atılır (ayarlanabilir). |
| Yinelenenler | Aynı cihaz için aynı zamanda aynı değerler bir kez saklanır. |
| Son değer | Yalnızca kesinlikle daha yeni bir zaman damgasına taşınır. |
| Toplamlar | Sayısal anahtar başına 1 dakikalık toplam, sayı, en küçük, en büyük ve son değer; ardından saat ve gün özetleri. |
| Saklama süresi | Planınızdan gelen 7, 30, 90, 365 veya 1.095 günlük bir sınıf. Ham satırlar en fazla 90 gün tutulur. |
| Mesaj kotası | Aylık olarak sayılır. Kotanın aşılması cihazlarınızı asla durdurmaz. |
Bu bölümde
| Sayfa | Kapsamı |
|---|---|
| Ölçümler nasıl saklanır | Mesaj satırları, anahtar sözlüğü, en son değerler, özetler |
| Telemetri anahtarları | Anahtar kuralları, ayrılmış önekler, raw, anahtar sınırı, profil anahtar ayarları |
| Zaman damgaları, geç ve yinelenen ölçümler | Cihaz zamanı ve alım zamanı, ileri ve eski ölçümler, yinelenenler, kesintiler |
| Sayılar, metin ve true/false değerleri | Grafiklerin neyi okuduğu ve durumların nasıl saklanacağı |
| Toplamlar ve özetler | Zaman aralıkları, yedi toplam fonksiyonu, sayaçlar için increase |
| Veriler ne kadar süreyle saklanır | Saklama sınıfları ve her ayrıntı düzeyinin neyi tuttuğu |
| Cihazın Telemetri sekmesi | Cihaz sayfasındaki en son değerler ve eğilim grafiği |
| Verileri dışa aktarma | CSV ve Excel indirmeleri, API, kuruluş dışa aktarımı |
| Geçmiş API’si | GET /api/telemetry/series ve latest, örneklerle |
| Türetilmiş değerler | Bir akışta yeni anahtarları hesaplama ve saklama |
| Mesaj kotası ve kullanım | Neyin mesaj sayıldığı, plan kotaları, uyarılar |
İlgili bölümler
- Cihazlar: cihazları bağlama ve gönderdikleri yük biçimleri. Bkz. MQTT konuları ve yük başvurusu.
- Paneller: grafikler, tablolar ve değer kartları. Bkz. Veri kaynakları ve parametreler.
- Akışlar: verileri saklayan kök akış ve yeni değerleri hesaplayan akışlar.