Girişte telemetriyi IoT Central'a eşleme

  • Makale

Veri eşleme, karmaşık cihaz telemetrisini IoT Central içindeki yapılandırılmış verilere dönüştürmenizi sağlar. Cihazlarınızın her biri için, cihaz telemetri iletisindeki belirli bir JSON yolunu bir diğer adla eşleyebilirsiniz. Diğer ad, eşlediğiniz hedefin kolay adıdır. IoT Central, IoT Central'a giden yolda telemetriyi dönüştürmek için eşlemeleri kullanır. Eşlenen telemetriyi kullanarak şunları yapabilirsiniz:

  • IoT Central'da cihaz şablonları ve cihaz yönetimi deneyimleri oluşturun.
  • Birden çok cihazdaki JSON yollarını ortak bir diğer adla eşleyerek farklı cihazlardan telemetri verilerini normalleştirin.
  • IoT Central dışındaki hedeflere aktarın.

IoT Central'daki eşleme işlemini özetleyen diyagram.

Aşağıdaki video, veri eşleme işleminde size yol göstermiştir:

Cihazınız için harita telemetrisi

Eşleme, bir diğer adla eşlemek üzere gelen telemetri iletisindeki değeri tanımlamak için JSONPath ifadesi kullanır.

JSONPath ifadesi, iletinin $ kök öğesine başvuran karakterle başlar. ardından $ köşeli ayraçlar kullanılarak ayrılmış bir alt öğe dizisi gelir. Örneğin:

$["messages"]["tmp"]

$["opcua"]["payload"][0]["value"]

$["Messages"]["Payload"]["nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt1"]["Value"]

IoT Central, JSONPath ifade söz diziminin bir alt kümesini kullanır:

  • Her segment yalnızca negatif olmayan bir sayı veya çift tırnak içine alınmış bir dize olabilir.
  • Bir segment ters eğik çizgi, köşeli ayraç veya çift tırnak işareti içeremez.
  • JSON yolu 1.000 karakteri aşamaz.

IoT Central uygulamanızda eşleme oluşturmak için aşağıdaki seçeneklerden birini belirleyerek Verileri eşle paneline gidin:

  • Herhangi bir cihaz sayfasında Cihaz > Eşleme verilerini yönet'i seçin:

    **Verileri eşle** menü öğesini gösteren ekran görüntüsü.

  • Cihazınızın Ham veri görünümünden herhangi bir telemetri iletisini genişletin, fare işaretçisini bir yolun üzerine getirin ve Diğer ad ekle'yi seçin. Verileri eşle paneli açılır ve JSONPath ifadesi JSON yol alanına kopyalanır:

    **Ham veri** görünümünde **Diğer ad ekle** seçeneğini gösteren ekran görüntüsü.

Harita veri panelinin sol tarafında cihazınızdan gelen en son ileti gösterilir. Fare işaretçisini verilerin herhangi bir bölümünün üzerine getirin ve Diğer Ad Ekle'yi seçin. JSONPath ifadesi JSON yoluna kopyalanır. 64 karakterden uzun olmayan bir Diğer Ad ekleyin. Cihaz şablonunda tanımlanan karmaşık nesnedeki bir alana başvurmak için diğer adı kullanamazsınız.

İhtiyacınız olan sayıda eşleme ekleyin ve kaydet'i seçin:

Json yolunu ve diğer adını gösteren **Verileri eşle** görünümünün ekran görüntüsü.

Belirli bir cihaz için:

  • Hiçbir iki eşleme aynı JSON yoluna sahip olamaz.
  • Hiçbir iki eşleme aynı diğer adına sahip olamaz.

İpucu

Cihazınızın sol panelde bir telemetri iletisi göndermesi için birkaç dakika beklemeniz gerekebilir. Sol panelde hala veri yoksa, JSON yolu alanına el ile JSONPath ifadesi girebilirsiniz.

IoT Central'ın telemetriyi eşlediğini doğrulamak için cihazınızın Ham veri görünümüne gidin ve şu bölüme _mappeddata bakın:

**Ham veriler** görünümündeki bir iletide eşlenen veriler bölümünü gösteren ekran görüntüsü.

Raw verilerini birkaç kez yeniledikten sonra eşlenen verilerinizi görmüyorsanız, kullandığınız JSONPath ifadesinin telemetri iletisinin yapısıyla eşleşip eşleşmediğini denetleyin.

IoT Edge cihazlar için veri eşlemesi tüm IoT Edge modüllerinden ve hub'dan telemetriye uygulanır. Belirli bir Azure IoT Edge modülüne eşleme uygulayamazsınız.

Bir cihaz şablonuna atanan cihazlar için, bileşenler veya devralınan arabirimler için verileri eşleyemezsiniz. Ancak, bir cihaz şablonuna atamadan önce cihazınızdaki tüm verileri eşleyebilirsiniz.

Eşlemeleri yönetme

Eşlemeleri görüntülemek, düzenlemek veya silmek için Eşlenen diğer adlar sayfasına gidin. Düzenlemek veya silmek için bir eşleme seçin. Birden çok eşlemeyi seçip bunları aynı anda silebilirsiniz:

Düzenle ve sil düğmeleriyle **Eşlenmiş diğer adlar** görünümünü gösteren ekran görüntüsü.

Varsayılan olarak, IoT Central'dan yapılan veri dışarı aktarma işlemleri eşlenmiş verileri içerir. Eşlenen verileri dışlamak için, veri dışarı aktarma işleminizde veri dönüştürmeyi kullanın.

Modellenmemiş telemetriyi eşleme

Modellenmemiş bileşenlerden gelen telemetri de dahil olmak üzere modellenmemiş telemetriyi eşleyebilirsiniz. Örneğin, kök bileşende tanımlanan telemetri ve temperature aşağıdaki örnekte gösterilen termostat bileşeninde tanımlanan telemetri göz önünde bulundurulduğundaworkingSet:

{
  "_unmodeleddata": {
    "workingSet": 74
  },
  "_eventtype": "Telemetry",
  "_timestamp": "2022-07-18T09:22:40.257Z"
}

{
  "_unmodeleddata": {
    "thermostat2": {
      "__t": "c",
      "temperature": 44
    }
  },
  "_eventtype": "Telemetry",
  "_timestamp": "2022-07-18T09:21:48.69Z"
}

Aşağıdaki eşleme tanımlarını kullanarak bu telemetriyi eşleyebilirsiniz:

  • $["workingSet"] ws
  • $["temperature"] temp

Not

Eşleme tanımına bileşen adını eklemeyin.

Bu eşleme kurallarının sonuçları aşağıdaki örneklere benzer:

{
  "telemetries": {
    "workingSet": 84,
    "_mappeddata": {
      "ws": 84
    }
  }
}

{
  "_unmodeleddata": {
    "thermostat2": {
      "__t": "c",
      "temperature": 12
    },
    "_mappeddata": {
      "thermostat2": {
        "__t": "c",
        "temp": 12
      }
    }
  },
  "_eventtype": "Telemetry",
  "_timestamp": "2022-07-18T09:31:21.088Z"
}

Artık eşlenen diğer adları kullanarak bir grafikte veya panoda telemetri görüntüleyebilirsiniz. Telemetriyi dışarı aktarırken eşlenmiş diğer adları da kullanabilirsiniz.

Sonraki adımlar

Cihazınız için verileri eşlemeyi öğrendiğinize göre, bir sonraki adım cihaz verilerini analiz etmek için veri gezginini kullanmayı öğrenmektir.