Azure Digital Twins-események átirányítása

Ez a cikk azt a folyamatot ismerteti, amellyel az Azure Digital Twins eseményadatokat küld, mind az Azure Digital Twins belső útválasztási eseményeihez, mind az eseményadatok szolgáltatáson kívüli alárendelt szolgáltatásokhoz vagy csatlakoztatott számítási erőforrásokhoz való külső küldéséhez.

Az Azure Digital Twins eseményértesítéseinek átirányítása kétlépéses folyamat: végpontok létrehozása, majd eseményútvonalak létrehozása az adatoknak a végpontokra való küldéséhez. Ez a cikk részletesebben ismerteti ezeket a fogalmakat. Azt is ismerteti, hogy mi történik, ha egy végpont nem tud időben eseményt kézbesíteni (egy folyamat, más néven holt betű).

Esemény-útválasztás áttekintése

Az Azure Digital Twins-adatok küldésének két fő forgatókönyve van, az eseményútvonalak pedig mindkettő végrehajtására szolgálnak:

• Eseményadatok küldése az egyik ikerpéldányról az Azure Digital Twins-grafikonon egy másikba. Ha például egy digitális ikerpéldány tulajdonsága megváltozik, érdemes lehet értesíteni és frissíteni egy másik digitális ikerpéldányt a frissített adatok alapján.
• Adatok küldése az Azure Digital Twinsen kívül az alsóbb rétegbeli adatszolgáltatásokba további tárolás vagy feldolgozás céljából. Ha például már használja az Azure Mapst, érdemes lehet Azure Digital Twins-adatokkal hozzájárulni a megoldás integrált modellezéssel vagy lekérdezésekkel való továbbfejlesztéséhez.

Minden eseménycél esetében az eseményútvonal úgy működik, hogy eseményadatokat küld az Azure Digital Twinsből az előfizetések egyénileg meghatározott végpontjaira . Jelenleg három Azure-szolgáltatás támogatott végpontokhoz: Event Hubs, Event Grid és Service Bus. Ezen Azure-szolgáltatások mindegyike csatlakoztatható más szolgáltatásokhoz, és közvetítőként is működik, adatokat küldve a végső célhelyekre, például az Azure Mapsbe, vagy vissza az Azure Digital Twinsbe függő gráffrissítésekhez.

Az alábbi ábra egy nagyobb IoT-megoldáson keresztül mutatja be az eseményadatok áramlását, amely magában foglalja az Azure Digital Twins-adatok végpontokon keresztül más Azure-szolgáltatásokba, valamint az Azure Digital Twinsbe való visszaküldését:

Az Azure Digital Twinsen kívüli adatforgalom esetében az eseményútvonalak tipikus alárendelt céljai a Time Series Insights, az Azure Maps, a storage és az elemzési megoldások. Az Azure Digital Twins legalább egyszer végrehajtja a kimenő szolgáltatásoknak kibocsátott adatok kézbesítését.

Az ugyanazon Azure Digital Twins-megoldáson belüli belső digitális ikeresemények útválasztásához folytassa a következő szakaszsal.

Belső digitális ikeresemények irányítása

Az eseményútvonalak az ikergráfon belüli események kezelésére szolgáló mechanizmus, amely digitális ikerpéldányról digitális ikerpéldányra küld adatokat. Ezt az eseménykezelést úgy végezheti el, hogy eseményútvonalakat csatlakoztat az Event Griden keresztül a számítási erőforrásokhoz, például az Azure Functionshez. Ezek a függvények ezután meghatározzák, hogy az ikerpéldányok hogyan fogadják és válaszoljanak az eseményekre.

Ha egy számítási erőforrás egy eseményútvonalon kapott esemény alapján szeretné módosítani az ikergráfot, érdemes előre tudnia, hogy melyik ikerpéldányt kell módosítania. Az eseményüzenet tartalmazza az üzenetet küldő forrás ikerpéldány azonosítóját is, így a számítási erőforrás lekérdezések vagy kapcsolati kapcsolatok használatával megkeresheti a kívánt művelet cél ikerpéldányát.

A számítási erőforrásnak független biztonsági és hozzáférési engedélyeket is létre kell hoznia.

Az Azure-függvények digitális ikeresemények feldolgozására való beállításának folyamatáról az iker-ikeresemények kezelésének beállítása című témakörben olvashat.

Végpontok létrehozása

Eseményútvonal definiálásához az a fejlesztőknek először végpontokat kell definiálniuk. A végpont az Azure Digital Twinsen kívüli célhely, amely támogatja az útvonalkapcsolatot. A támogatott célhelyek a következők:

• Egyéni Event Grid-témakörök
• Event Hubs
• Service Bus

Végpont létrehozásához használhatja az Azure Digital Twins REST API-kat, parancssori felületi parancsokat vagy az Azure Portalt.

Végpont definiálásakor a következőket kell megadnia:

• A végpont neve
• A végpont típusa (Event Grid, Event Hubs vagy Service Bus)
• A hitelesítés elsődleges kapcsolati sztring és másodlagos kapcsolati sztring
• A végpont témakörútvonala, például your-topic.westus2.eventgrid.azure.net

Lehetőség van arra, hogy identitásalapú hitelesítéssel hozza létre a végpontot, hogy a végpontot rendszer által hozzárendelt vagy felhasználó által hozzárendelt felügyelt identitással használja. Ez a beállítás csak az Event Hubs és a Service Bus típusú végpontok esetében érhető el (az Event Grid esetében ez nem támogatott).

A vezérlősíkon elérhető végponti API-k a következők:

• Végpont létrehozása
• Végpontok listájának lekérése
• Végpont lekérése név alapján
• Végpont törlése név szerint

A végpontok létrehozásával kapcsolatos részletes utasításokért lásd a Végpontok létrehozása című témakört.

Eseményútvonalak létrehozása

Eseményútvonal létrehozásához használhatja az Azure Digital Twins REST API-kat, parancssori felületi parancsokat vagy az Azure Portalt.

Íme egy példa egy eseményútvonal ügyfélalkalmazáson belüli létrehozására a CreateOrReplaceEventRouteAsync .NET (C#) SDK-hívással :

string eventFilter = "$eventType = 'DigitalTwinTelemetryMessages' or $eventType = 'DigitalTwinLifecycleNotification'";
var er = new DigitalTwinsEventRoute("endpointName", eventFilter);
await client.CreateOrReplaceEventRouteAsync("routeId", er);

1. Először létrejön egy DigitalTwinsEventRoute objektum, és a konstruktor egy végpont nevét veszi fel. Ez a endpointName mező azonosít egy végpontot, például az Event Hubsot, az Event Gridet vagy a Service Bust. Ezeket a végpontokat az előfizetésben kell létrehozni, és az Azure Digital Twinshez kell csatolni a vezérlősík API-jaival, mielőtt ezt a regisztrációs hívást indítanák.

2. Az eseményútvonal-objektum szűrőmezővel is rendelkezik, amellyel korlátozhatja az ezt az útvonalat követő eseménytípusokat. A szűrő lehetővé true teszi az útvonalat további szűrés nélkül (az útvonal szűrője false letiltja az útvonalat).

3. Ezt az eseményútvonal-objektumot ezután átadja CreateOrReplaceEventRouteAsynca rendszer az útvonal nevével együtt.

Tipp.

Minden SDK-függvény szinkron és aszinkron verzióban jön létre.

Az eseményútvonalak létrehozásával kapcsolatos részletes útmutatásért lásd : Útvonalak és szűrők létrehozása.

Holt betűs események

Ha egy végpont egy adott időszakon belül nem tud eseményt kézbesíteni, vagy miután többször megpróbálta kézbesíteni az eseményt, elküldheti a nem kézbesített eseményt egy tárfiókba. Ezt a folyamatot holtbetűsnek nevezzük. Az Azure Digital Twins az alábbi feltételek teljesülése esetén nem küldi el az eseményt:

• Az esemény nem lesz kézbesítve az élőben töltött időszakon belül
• Az esemény kézbesítési kísérleteinek száma túllépte a korlátot

Ha valamelyik feltétel teljesül, az esemény el lesz dobva vagy elhalt betűvel. Alapértelmezés szerint az egyes végpontok nem kapcsolják be a halott betűket. Az engedélyezéshez meg kell adnia egy tárfiókot a nem kézbesített események tárolásához a végpont létrehozásakor. Ezután lekérheti az eseményeket ebből a tárfiókból a szállítások feloldásához.

A kézbesíthetetlen levelek helyének megadása előtt rendelkeznie kell egy tárolóval rendelkező tárfiókkal. A végpont létrehozásakor meg kell adnia a tároló URL-címét. A holtbetű tároló URL-címként van megadva SAS-jogkivonattal. Ehhez a jogkivonathoz csak write a tárfiókon belüli céltároló engedélyére van szükség. A teljesen formázott URL-cím formátuma a következő lesz: https://<storage-account-name>.blob.core.windows.net/<container-name>?<SAS-token>

További információ az SAS-jogkivonatokról: Korlátozott hozzáférés biztosítása az Azure Storage-erőforrásokhoz közös hozzáférésű jogosultságkódok (SAS) használatával

Ha meg szeretné tudni, hogyan állíthat be végpontot holt betűvel, tekintse meg a végpontbeállításokat: Dead-lettering.

Eseményüzenetek típusai

Az IoT Hub és az Azure Digital Twins különböző eseménytípusai különböző típusú értesítési üzeneteket hoznak létre az alábbiak szerint.

Értesítés típusa	Útválasztási forrás neve	Létrehozva...
Digitális ikerpéldány változási értesítése	Digitális ikerpéldány változási értesítése	a digitális ikertulajdonságok módosítása
Digitális ikerpéldány életciklus-értesítése	Digitális ikerpéldány életciklus-értesítése	bármely digitális ikerpéldány létrehozási vagy törlési művelete
Digitális ikerpéldány kapcsolati változásról szóló értesítése	Digitális ikerpéldány kapcsolati változásról szóló értesítése	bármilyen digitális ikerkapcsolat-változás
Digitális ikerpéldány telemetriai üzenetei	Telemetriai üzenetek	bármilyen telemetriai üzenet

Következő lépések

Folytassa a végpontok és eseményútvonalak beállítására vonatkozó részletes utasításokat:

• Végpontok létrehozása, útvonalak és szűrők létrehozása

Vagy kövesse ezt az útmutatót egy Azure-függvény beállításához az iker-ikeresemények kezeléséhez az Azure Digital Twinsben:

• Iker-iker eseménykezelés beállítása.