Yeni: Yapay zekâ güvenlik duvarı tüm platformu izliyor ve her olayı sade bir dille açıklıyor. Nasıl çalıştığını görün

IoT veri blokları

Telemetriyi kaydet, Özellikleri kaydet, Paylaşılan özellik ayarla, Alarm kuralları, Cihaz ayrıntıları, En son değerler, Profil ayrıntıları, İlgili veriler ve Okumayı kaydet başvurusu.

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.

AyarAnlamıVarsayılanDeğerler
anahtarlarYalnızca bu anahtarlarher anahtaranahtar adları
tsKaydın hangi zamanda saklanacağıkayıt zamanıkayıt zamanı (msg.metadata.recordTs), alım zamanı (msg.metadata.ts)
ts_pathKayıt zamanıyla: kaydın zamanını bu değerden yeniden ayarlayokepoch milisaniyesine bir yol (sayı ya da sayısal metin)

Çıktılar: out (değerler kaydedildikten sonra), msg.error.code ile error:

KodAnlamı
not_a_deviceKaynak bir cihaz değil
invalid_valueYük bir nesne değil
bad_tsts_path üzerindeki zaman epoch milisaniyesi değil
too_oldOrganizasyonunuzun ham veriyi sakladığı süreden eski
no_valuesYükte saklanabilecek bir şey yok
key_limitPlanın anahtar üst sınırı altında yeni bir anahtar için yer yok
save_failedVeritabanı 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).

AyarAnlamıVarsayılanDeğerler
scopeHangi özniteliklerclientclient
anahtarlarYalnızca bu anahtarlarher anahtaranahtar 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.

AyarAnlamıDeğerler
öğelerAnahtar ve değer çiftlerizorunlu; 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 da current_fw_ ile başlayan anahtarlar ile session_limits ve deleted, 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.

AyarAnlamıVarsayılanDeğerler
profile_rulesProfilin kurallarını değerlendironon, off
rulesYalnızca bu alarm türleriher kuralprofilin 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.msgType değeri alarm olan, alarmı msg.payload ve msg.metadata.alarm iç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.

AyarAnlamıVarsayılanDeğerler
fieldsCihaz alanlarıname, profilename, label, type, serial, model, fw_version, status, online, last_activity (epoch ms), profile, profile_id, is_gateway, gateway
attributesÖznitelikler: scope, key, mesajdaki adyoken fazla 50; scope client, shared veya server
targetNesnenin yazıldığı yermsg.metadata.devicemsg.metadata ya da msg.payload altında bir yol
with_tsÖznitelikleri { ts, value } olarak yazoff
on_missingDeğeri olmayan bir alan ya da öznitelikerrorerror, 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.

AyarAnlamıVarsayılanDeğerler
anahtarlarTelemetri anahtarlarızorunluen fazla 50
targetYerimsg.metadata.latestmsg.metadata ya da msg.payload altında
with_tsDeğer yerine { ts, value }off
on_missingSaklanmış değeri olmayan bir anahtarerrorerror, 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.

AyarAnlamıVarsayılanDeğerler
fieldsProfil alanlarınamename, id, transport, inactivity_timeout_s, rpc_timeout_s, downlink_max_bytes, online_rule, expected_interval_s
targetYerimsg.metadata.profilemsg.metadata ya da msg.payload altında
on_missingDeğeri olmayan bir alanerrorerror, 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.

AyarAnlamıVarsayılanDeğerler
directionİlişkileri kaynaktan ya da kaynağa doğru izlefromfrom, to
relation_typesİzlenen ilişki türleriCONTAINSör. CONTAINS, MANAGES, FEEDS, MONITORS ya da kendi türünüz; none = herhangi
exclude_typesHiçbir zaman izlenmeyen türleryok
depthSeviyeler11 ila 8
last_level_onlyYalnızca son seviyeyi tutoff
entity_kindHangi varlıklaranyany, asset, device
profiles, kindsYalnızca bu profillerdeki cihazlar, bu türlerdeki varlıklarany
maxKaç varlık11 ila 100 (1 tek bir nesne yazar, daha fazlası bir liste)
dataNe okunurattributesözellikler, en son değerler (cihazlar), alanlar
kapsamCihaz özelliği kapsamısunucusunucu, paylaşılan, istemci
eşlemeOkunan anahtarlar ve mesajdaki adlarızorunluen fazla 50
hedefKonummsg.metadata.relatedmsg.metadata veya msg.payload altında
with_ts, on_missingYukarıdaki gibioff, 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.

AyarAnlamıVarsayılanDeğerler
kindKayıt türüzorunluakış yazmalarını kabul eden bir tür
entity_pathKaydın kimliğinin konumumsg.originator.idbir UUID’ye giden yol
ts, ts_pathTelemetriyi kaydet için olduğu gibikayıt zamanı
keysYalnızca bu anahtarlarher 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.