Her okuma bir anahtar ve bir değerdir; örneğin "temperature": 21.5. Bu sayfa anahtarların ve değerlerin uyması gereken kuralları, kurala uymayan birine ne olduğunu ve anahtar adlarınızı nasıl planlayacağınızı listeler.
Anahtar kuralları
| Kural | Ayrıntı |
|---|---|
| Karakterler | Yalnızca A-Z, a-z, 0-9, _, . ve - |
| Uzunluk | 1 ila 64 karakter |
| Büyük/küçük harf | Büyük/küçük harfe duyarlı: Temp ve temp iki ayrı anahtardır |
| Ayrılmış önekler | Bir anahtar _, fw_, current_fw_ veya cfg. ile başlayamaz. Bunlar öznitelikler (yazılım durumu, istenen yapılandırma) ve platform için ayrılmıştır. |
Bir kuralı ihlal eden anahtar kayıttan çıkarılır; aynı kayıttaki diğer anahtarlar korunur. Çıkarma, akışın çalıştırma kaydında bildirilir (aşağıdaki nedenlere bakın).
Değer kuralları
| Değer | Şu biçimde saklanır | Sınır |
|---|---|---|
| Sonlu bir sayı | Bir sayı (grafiklenir ve toplanır) | |
true / false | Bir bayrak | |
| Metin | Metin | 1.024 karakter |
| Bir JSON nesnesi veya dizisi | JSON | JSON olarak yazıldığında 4 KiB |
null | Hiçbir şey: “okuma yok”, bir hata değil |
Sınırını aşan bir değer yalnızca kendi anahtarını düşürür. Bkz. Sayılar, metin ve true/false değerleri.
Bir mesajın boyutu
Bir mesaj, kayıtlara bölündükten sonra en fazla 1.000 anahtar-değer noktası içerebilir. Daha fazlası içeren bir mesaj bütünüyle reddedilir (bad_form); içinden hiçbir şey saklanmaz. Cihazın profili ayrıca yük boyutunu sınırlar (varsayılan 64 KiB). Bkz. Cihaz profilleri.
Ham anahtar
JSON olmayan bir gövde (ikili veri, düz metin ya da özel bir konuda JSON skaler veya dizi) metin olarak tek raw anahtarı altında saklanır. raw anahtarı 1.024 karakter sınırından muaftır; bunun yerine profilin Maks. ham yük (bayt) ayarıyla sınırlandırılır: varsayılan 4.096 bayt, 256 ila 65.536 bayt. İkili bir gövde base64 kodlu gelir (msg.metadata.encoding değeri base64tür).
Bir akışta raw anahtarını çözün (örneğin Base64, Hex veya Bytes blokları ya da bir betik ile) ve adlandırılmış anahtarları kaydedin. Bkz. Veri dönüştürme blokları.
Konu önekli anahtarlar
Anahtarları konu ile önekle profil ayarıyla, özel bir konudaki veriler <topic>.<key> olarak saklanır:
- Konudaki
/,.olur; anahtar kuralının dışındaki diğer karakterler_olur. - Ayrılmış önek kuralı ve 64 karakter sınırı birleştirilmiş anahtar için geçerlidir. 64 karakteri aşan birleştirilmiş bir anahtar düşürülür.
raw,<topic>.rawolur; ham sınırlar aynı kalır.
Örnek: konu site1/boiler ve anahtar temp ise site1.boiler.temp elde edilir. Önek olmadan, iki konuda gelen aynı anahtar tek bir anahtardır ve son yazılan kazanır.
Anahtar sınırı
Planınız, kuruluşunuzun saklayabileceği ayrı anahtar sayısını sınırlayabilir:
| IoT plan kademesi | Ayrı telemetri anahtarları |
|---|---|
| Starter | 250 |
| Growth | 400 |
| Scale | 2,050 |
- Bir anahtar, kaç cihaz tarafından gönderilirse gönderilsin bir kez sayılır.
- Bir anahtar, onu gönderen cihazlar silindikten sonra da sayılmaya devam eder: anahtar sözlüğü hiçbir zaman budanmaz.
- Sayı dakikada en fazla bir kez okunur.
- Sınırı aşan yeni bir anahtar saklanmaz; kaydın diğer anahtarları saklanır. Bir kayıttan hiçbir şey kalmazsa, Telemetri kaydet
key_limitbildirir.
Anahtar adlarını sabit tutun ve cihaz türleri arasında paylaşın (temperature, temp_dev42 değil). Bir cihazın kimliğini anahtarda değil, cihazın kendisinde tutun.
Profil anahtar ayarları
Bir cihaz profilinin Telemetri anahtarları listesi (en fazla 500 anahtar), cihazlarının gönderdiği anahtarları tanımlar:
| Alan | Kullanım |
|---|---|
| Tür | Sayı, Tam sayı, Evet / hayır, Metin veya JSON |
| Birim | En fazla 32 karakter; değerlerin yanında ve grafik eksenlerinde gösterilir |
| Etiket | En fazla 128 karakter; anahtar yerine gösterilen ad |
| Min, Maks | Beklenen aralık; bir gösterge bunu varsayılan ölçek olarak kullanır |
| Ondalık | 0 ila 10 |
Liste saklananı filtrelemez: listede olmayan bir anahtar yine de saklanır. Anahtarları Telemetri sekmesinde, panolarda ve SCADA bağlamalarında adlandırır ve biçimlendirir. Bkz. Cihaz profilleri.
Bir değerin neden çıkarıldığı
Kök akışın çalıştırma kaydı ve Telemetri kaydet hatası şu kodları kullanır:
| Kod | Anlamı |
|---|---|
key_invalid | Anahtar kuralının dışında bir karakter veya boş bir anahtar |
key_too_long | 64 karakteri aşan (konu önekinden sonra da) |
key_reserved | _, fw_, current_fw_ veya cfg. ile başlar |
string_too_long | 1.024 karakteri aşan metin |
value_too_large | 4 KiB’yi aşan JSON, sınırını aşan raw veya sonlu olmayan bir sayı |
bad_form | Deponun okumadığı bir biçim veya tek bir mesajda 1.000’den fazla nokta |
bad_ts | Epoch milisaniyesi olmayan, çok ileri tarihli veya ayarlar için çok eski bir zaman damgası |
too_old | Saklama sınıfınızın ham veriyi tutma süresinden daha eski |
key_limit | Planın anahtar sınırını aşan yeni bir anahtar |
no_values | Kayıtta hiçbir şey saklanamadı |
Adlandırma ipuçları
- Küçük harf ve alt çizgi kullanın:
flow_rate,pump_1_running. - Gruplamak istediğiniz yapı için nokta kullanın:
p1.running,p1.value(SCADA öğe anahtarları bu biçimi kullanır). - Birimleri anahtar adlarının dışında tutun; bunları profilin Birim alanına yazın.
- Durumların geçmişini tutmanız gerektiğinde durumları sayısal kodlar olarak saklayın. Bkz. Sayılar, metin ve true/false değerleri.
Ayrıca bkz. Ayrılmış anahtarlar ve öznitelikler.