Telemetriai adatok leképezése az IoT Centralba való bejövő forgalomról

Az adatleképezés lehetővé teszi az összetett eszköztelemetria strukturált adatokká alakítását az IoT Centralon belül. Minden eszközhöz hozzárendelhet egy adott JSON-útvonalat az eszköz telemetriai üzenetében egy aliashoz. Az alias a leképezendő cél rövid neve. Az IoT Central a leképezésekkel átalakítja a telemetriát az IoT Central felé vezető úton. A leképezett telemetriát a következőre használhatja:

• Eszközsablonok és eszközfelügyeleti szolgáltatások létrehozása az IoT Centralban.
• Normalizálja a telemetriát a különböző eszközökről úgy, hogy több eszközön lévő JSON-útvonalakat egy közös aliashoz rendel.
• Exportálás az IoT Centralon kívüli célhelyekre.

Tipp.

Ha automatikusan létre szeretne hozni egy eszközsablont a nem átalakított telemetriából, olvassa el az eszközsablon automatikus létrehozása című témakört.

Az alábbi videó végigvezeti az adatleképezési folyamaton:

Az eszköz telemetriájának leképezése

A leképezés egy JSONPath-kifejezéssel azonosítja a bejövő telemetriai üzenetben szereplő értéket egy aliashoz való leképezéshez.

A JSONPath-kifejezés a $ karakterrel kezdődik, amely az üzenet gyökérelemére hivatkozik. Ezt $ követi a szögletes zárójelekkel elválasztott gyermekelemek sorozata. Példa:

$["messages"]["tmp"]

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

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

Az IoT Central a JSONPath kifejezés szintaxisának egy részhalmazát használja:

• Minden szegmens csak nem negatív szám vagy kettős idézőjelek közé zárt sztring lehet.
• A szegmensek nem tartalmazhatnak fordított perjelet, szögletes zárójelet vagy idézőjelet.
• A JSON-elérési út nem haladhatja meg az 1000 karaktert.

Ha leképezést szeretne létrehozni az IoT Central-alkalmazásban, válassza az alábbi lehetőségek egyikét a Térkép adatpanelre való navigáláshoz:

• Bármelyik eszközoldalon válassza az Eszköztérkép > adatainak kezelése lehetőséget:

  

• Az eszköz Nyers adatnézetében bontsa ki a telemetriai üzeneteket, mutasson az egérmutatóra egy útvonalon, és válassza az Alias hozzáadása lehetőséget. Megnyílik a Leképezés adatpanel a JSON-elérési út mezőre másolt JSONPath-kifejezéssel:

  

A Térkép adatpanel bal oldalán az eszköz legújabb üzenete látható. Mutasson az egérmutatóra az adatok bármely része fölé, és válassza az Alias hozzáadása lehetőséget. A JSONPath-kifejezés a JSON-elérési útra lesz másolva. Legfeljebb 64 karakter hosszúságú aliasnevet adhat hozzá. Az alias használatával nem hivatkozhat az eszközsablonban definiált összetett objektum mezőire.

Adjon hozzá annyi leképezést, amennyit csak szeretne, majd válassza a Mentés elemet:

Adott eszköz esetén:

• Két leképezés nem rendelkezhet ugyanazzal a JSON-elérési útval.
• Két leképezés nem rendelkezhet ugyanazzal az aliasszal.

Tipp.

Előfordulhat, hogy várnia kell néhány percet, amíg az eszköz telemetriai üzenetet küld a bal oldali panelen való megjelenítéshez. Ha továbbra sem találhatók adatok a bal oldali panelen, manuálisan is beírhat egy JSONPath-kifejezést a JSON elérési út mezőjébe.

Annak ellenőrzéséhez, hogy az IoT Central megfelelteti-e a telemetriát, lépjen az eszköz Nyers adatnézetére , és ellenőrizze a szakaszt _mappeddata :

Ha a Nyers adatok többszöri frissítése után nem látja a leképezett adatokat, ellenőrizze, hogy a használt JSONPath-kifejezés megegyezik-e a telemetriai üzenet szerkezetével.

Az IoT Edge-eszközök esetében az adatleképezés az összes IoT Edge-modulból és központból származó telemetriára vonatkozik. Nem alkalmazhat leképezéseket egy adott Azure IoT Edge-modulra.

Az eszközsablonhoz rendelt eszközök esetében nem képezheti le az összetevők vagy az örökölt interfészek adatait. Az eszközről azonban bármilyen adatot leképezhet , mielőtt eszközsablonhoz rendelené.

Leképezések kezelése

A leképezések megtekintéséhez, szerkesztéséhez vagy törléséhez lépjen a Megfeleltetett aliasok lapra. Jelöljön ki egy leképezést a szerkesztéséhez vagy törléséhez. Egyszerre több leképezést is kijelölhet és törölhet:

Alapértelmezés szerint az IoT Centralból származó adatexportok a megfeleltetett adatokat is tartalmazzák. A leképezett adatok kizárásához használjon adatátalakítást az adatexportálásban.

Nemmodellezett telemetriai adatok leképezése

Leképezheti a nem átalakított telemetriát, beleértve a nem átalakított összetevők telemetriáját is. workingSet A gyökérösszetevőben definiált telemetriai adatok és a temperature termosztát-összetevőben definiált telemetriai adatok például az alábbi példában láthatók:

{
  "_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"
}

Ezt a telemetriát a következő leképezési definíciókkal képezheti le:

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

Feljegyzés

Ne adja meg az összetevő nevét a leképezési definícióban.

A leképezési szabályok eredményei a következő példákhoz hasonlóan néznek ki:

{
  "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"
}

Mostantól a megfeleltetett aliasokkal megjelenítheti a telemetriát egy diagramon vagy irányítópulton. A megfeleltetett aliasokat a telemetriai adatok exportálásakor is használhatja.