Bu bloklar IoT ana bilgisayarındaki bir cihazın verileri üzerinde çalışır: ölçümleri ve özellikleri saklar, alarm kurallarını değerlendirir ve mesaja cihaz bilgilerini ekler. Neredeyse hepsi kaynağı bir cihaz olan bir mesaj ister: bir cihaz mesajı ya da bir kökün Run flow ile aktardığı bir mesaj. Bir zamanlama, inject, olay veya zamanlayıcı ile başlatılan mesajlar bir cihazla değil kuruluşla ilgilidir; bu bloklar bunları not_a_device ile reddeder.
Telemetri kaydet
Mesajın anahtar-değer çiftlerini cihazın telemetrisi olarak saklar. Telemetriyi yalnızca bu blok saklar: bu bloğu içermeyen bir dal hiçbir şey saklamaz. Yalnızca msg.payload saklanır, meta veriler asla saklanmaz.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| anahtarlar | Yalnızca bu anahtarlar | her anahtar | anahtar adları |
| ts | Kaydın hangi zamanda saklanacağı | kayıt zamanı | kayıt zamanı (msg.metadata.recordTs), alım zamanı (msg.metadata.ts) |
| ts_path | Kayıt zamanıyla: kaydın zamanını bu değerden yeniden ayarla | yok | epoch milisaniyesine bir yol (sayı ya da sayısal metin) |
Çıktılar: out (değerler kaydedildikten sonra), msg.error.code ile error:
| Kod | Anlamı |
|---|---|
not_a_device | Kaynak bir cihaz değil |
invalid_value | Yük bir nesne değil |
bad_ts | ts_path üzerindeki zaman epoch milisaniyesi değil |
too_old | Organizasyonunuzun ham veriyi sakladığı süreden eski |
no_values | Yükte saklanabilecek bir şey yok |
key_limit | Planın anahtar üst sınırı altında yeni bir anahtar için yer yok |
save_failed | Veritabanı satırı reddetti (msg.error.ts onun zamanıdır) |
- Mesajlar en fazla 500’lük dalgalar halinde yazılır ve cihazın bir sonraki mesajı kayıt onaylanana kadar bekler; böylece bu mesajın ssakladığını okur.
- Aynı değerler aynı zamanda bir kez saklanır; aynı zamanda iki farklı mesaj ikisi de tutulur; en son değer yalnızca kesinlikle daha yeni bir zamana taşınır.
- Veritabanına ulaşılamadığında hiçbir şey kaybolmaz: çalıştırma bekler ve geri geldiğinde yeniden oynatılır.
- Test çalıştırması hiçbir şey saklamaz.
Bkz. Ölçümler nasıl saklanır ve Telemetri anahtarları.
Öznitelik kaydet
Mesajın anahtar-değer çiftlerini cihazın istemci öznitelikleri olarak saklar (cihazın kendisi hakkında bildirdikleri, örneğin yazılım sürümü gibi).
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| scope | Hangi öznitelikler | client | client |
| anahtarlar | Yalnızca bu anahtarlar | her anahtar | anahtar adları |
Hatalar: not_a_device, invalid_value, save_failed. Yeniden teslim edilen bir mesaj hiçbir şeyi değiştirmez; daha eski bir mesaj daha yeni bir değerin üzerine yazmaz; değişmeyen bir değer yeniden yazılmaz. Bkz. Öznitelikler.
Paylaşılan öznitelik ayarla
Mesajın cihazının paylaşılan özniteliklerini ayarlar. Bağlı bir cihaz değişikliği hemen alır; çevrimdışı bir cihaz bir sonraki bağlantısında alır. Akışlar değişikliği attributes_updated mesajı olarak duyar.
| Ayar | Anlamı | Değerler |
|---|---|---|
| öğeler | Anahtar ve değer çiftleri | zorunlu; en fazla 32. Anahtar: harfler, rakamlar, _, ., -, en fazla 57 karakter. Değer: bir sabit (true, 22.5, {"mode":"eco"}) ya da msg.payload.setpoint gibi bir yol. |
Hatalar: not_a_device, device_not_found, invalid_value, bad_attribute, too_large, managed_by_settings (ayarları Settings sekmesinde yönetilen bir cihazın cfg.* anahtarı), limit (cihaz son bir dakikada akışlardan çok fazla komut ve ayar aldı; varsayılan 30).
- Kontrol seviyesi: dağıtım için Deploy flows with control-level nodes ve akışın adının yazılması gerekir.
_,fw_ya dacurrent_fw_ile başlayan anahtarlar ilesession_limitsvedeleted, platforma aittir ve ayarlanamaz.- Geç kalmış bir mesaj hiçbir şeyi değiştirmez. Test çalıştırması neyi ayarlayacağını bildirir.
Alarm kuralları
Cihaz profilinin alarm kurallarını değerlendirir ve cihazın alarmlarını açar, günceller ya da temizler. Kurallar cihaz profilinde düzenlenir; bu blok kuralların akışta nerede çalışacağına karar verir. Varsayılan kök, bunu girişten hemen sonra yerleştirir.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| profile_rules | Profilin kurallarını değerlendir | on | on, off |
| rules | Yalnızca bu alarm türleri | her kural | profilin kural türleri |
Çıktılar:
out: mesaj, her zaman, değerlendirmeden sonra (bir sorun günlüğe yazılır ve mesajı asla durdurmaz, bu yüzden sonrasındaki kaydetme blokları yine çalışır).created,updated,cleared:msg.msgTypedeğerialarmolan, alarmımsg.payloadvemsg.metadata.alarmiçinde taşıyan (transition,isNew,isSeverityUpdated,isCleared,repeats,durationMs,ruleId) mesajın bir kopyası.
Telemetri, anahtarlarından birini okuyan kurallara göre değerlendirilir; connect, disconnect, activity ve inactivity çevrimdışı kuralını yönetir. Geç ya da sırası bozuk gelen ölçümler geriye dönük veri olarak değerlendirilir (geçmişte Backfilled olarak işaretlenir, kimseye bildirilmez). Bloğu kaldırırsanız alarm kuralları bu kökün cihazları için durur; geri koyarsanız devam eder. Bkz. Cihaz profillerinde alarm kuralları.
Cihaz ayrıntıları
Mesajın cihazının bilgilerini ve özniteliklerini mesaja ekler.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| fields | Cihaz alanları | name, profile | name, label, type, serial, model, fw_version, status, online, last_activity (epoch ms), profile, profile_id, is_gateway, gateway |
| attributes | Öznitelikler: scope, key, mesajdaki ad | yok | en fazla 50; scope client, shared veya server |
| target | Nesnenin yazıldığı yer | msg.metadata.device | msg.metadata ya da msg.payload altında bir yol |
| with_ts | Öznitelikleri { ts, value } olarak yaz | off | |
| on_missing | Değeri olmayan bir alan ya da öznitelik | error | error, skip, null |
Örnek sonuç: { "name": "Boiler 1", "profile": "Boilers", "online": true, "setpoint": 21 }. Bir ağ geçidinin arkasındaki bir cihaz için gateway { id, name, online } biçimindedir. Ayrıntılar 30 saniye önbelleğe alınır; öznitelikler her seferinde taze okunur. Hatalar: missing (msg.error.keys ile), not_a_device, not_found, invalid_value, read_failed.
Son değerler
Cihazın seçilen anahtarlarının saklanmış son değerlerini ekler.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| anahtarlar | Telemetri anahtarları | zorunlu | en fazla 50 |
| target | Yeri | msg.metadata.latest | msg.metadata ya da msg.payload altında |
| with_ts | Değer yerine { ts, value } | off | |
| on_missing | Saklanmış değeri olmayan bir anahtar | error | error, skip, null |
İşlenen mesajın bir değeri yalnızca onun Telemetri kaydet bloğu çalıştıktan sonra dahil edilir.
Profil ayrıntıları
Cihazın profilinin bilgilerini ekler.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| fields | Profil alanları | name | name, id, transport, inactivity_timeout_s, rpc_timeout_s, downlink_max_bytes, online_rule, expected_interval_s |
| target | Yeri | msg.metadata.profile | msg.metadata ya da msg.payload altında |
| on_missing | Değeri olmayan bir alan | error | error, skip, null |
İlişkili veriler
Mesajın cihazı ya da varlığıyla ilişkili varlık ve cihazların verilerini ekler: bir cihazın yerleştirildiği saha, bir varlığın yönettiği cihazlar, üç seviye yukarıdaki bir ata.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| direction | İlişkileri kaynaktan ya da kaynağa doğru izle | from | from, to |
| relation_types | İzlenen ilişki türleri | CONTAINS | ör. CONTAINS, MANAGES, FEEDS, MONITORS ya da kendi türünüz; none = herhangi |
| exclude_types | Hiçbir zaman izlenmeyen türler | yok | |
| depth | Seviyeler | 1 | 1 ila 8 |
| last_level_only | Yalnızca son seviyeyi tut | off | |
| entity_kind | Hangi varlıklar | any | any, asset, device |
| profiles, kinds | Yalnızca bu profillerdeki cihazlar, bu türlerdeki varlıklar | any | |
| max | Kaç varlık | 1 | 1 ila 100 (1 tek bir nesne yazar, daha fazlası bir liste) |
| data | Ne okunur | attributes | özellikler, en son değerler (cihazlar), alanlar |
| kapsam | Cihaz özelliği kapsamı | sunucu | sunucu, paylaşılan, istemci |
| eşleme | Okunan anahtarlar ve mesajdaki adları | zorunlu | en fazla 50 |
| hedef | Konum | msg.metadata.related | msg.metadata veya msg.payload altında |
| with_ts, on_missing | Yukarıdaki gibi | off, error |
Varlık ağacı ve cihaz yerleşimleri CONTAINS ilişkisi sayılır: yön hedefe, CONTAINS, derinlik 3, yalnızca son seviye; assets, bir cihazın sahasını üç seviye yukarıda bulur. Sıra sabittir, bu yüzden max 1 her seferinde aynı varlığı seçer. Bkz. Varlık hiyerarşisi.
Okumayı kaydet (Genel sunucu)
Anahtar-değer çiftlerini, akışlardan yazmaya kabul eden bir kayıt türünün okuması olarak saklar (örneğin, planınız kapsıyorsa varlık sayaçları için). Cihaz verileri burada asla saklanmaz.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| kind | Kayıt türü | zorunlu | akış yazmalarını kabul eden bir tür |
| entity_path | Kaydın kimliğinin konumu | msg.originator.id | bir UUID’ye giden yol |
| ts, ts_path | Telemetriyi kaydet için olduğu gibi | kayıt zamanı | |
| keys | Yalnızca bu anahtarlar | her anahtar |
Hatalar: invalid_value, invalid_entity, unknown_kind, kind_not_writable, entity_not_writable, bad_ts, save_failed.
Metadatanın bittiği yer
msg.metadata altında yazılan değerler asla saklanmaz; msg.payload altındaki değerler daha sonraki bir Telemetriyi kaydet ile saklanır. Saklamak istemediğiniz zenginleştirmeleri msg.metadata altına koyun.

