Eseményútvonalak és -szűrők létrehozása az Azure Digital Twinsben

Ez a cikk végigvezeti az eseményútvonalak létrehozásának folyamatán az Azure Portal, az Azure CLI az dt route parancsok, az Event Routes adatsík API-k és a .NET (C#) SDK használatával.

Az Eseményértesítések átirányítása az Azure Digital Twinsből az alsóbb rétegbeli szolgáltatásokhoz vagy a csatlakoztatott számítási erőforrásokhoz 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 a második lépést ismerteti, amely útvonalak beállításával szabályozza, hogy mely események érkeznek az Azure Digital Twin-végpontokra. A cikk folytatásához már létre kell hoznia végpontokat .

Előfeltételek

• Szüksége lesz egy Azure-fiókra, amely ingyenesen beállítható

• Szüksége lesz egy Azure Digital Twins-példányra az Azure-előfizetésében. Ha még nincs példánya, létrehozhat egyet a példány és a hitelesítés beállításának lépéseivel. A cikk későbbi részében a következő értékeket használhatja a beállítástól kezdve:

  • Példány neve
  • Erőforráscsoport

  Ezeket a részleteket az Azure Portalon találja a példány beállítása után.

  

• Hozzon létre egy végpontot a Végpontok létrehozása című témakörben található utasítások alapján. Ebben a cikkben létrehoz egy útvonalat, amellyel adatokat küldhet az adott végpontra.

Ezután kövesse az alábbi utasításokat, ha az Azure CLI-t szeretné használni az útmutató követésével.

A környezet előkészítése az Azure CLI-hez

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.

  

• Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.

  • Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.

  • Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

Eseményútvonal létrehozása

A végpont létrehozása után meg kell határoznia egy eseményútvonalat, hogy ténylegesen adatokat küldjön a végpontnak. Ezek az útvonalak lehetővé teszik a fejlesztők számára az eseményfolyamatok továbbítását a teljes rendszerben és az alsóbb rétegbeli szolgáltatásokban. Egyetlen útvonal több értesítés és eseménytípus kijelölését is lehetővé teheti. További információ a végpontok és az eseményútvonalak eseményútvonalairól.

Az útvonaldefiníciók a következő elemeket tartalmazhatják:

• A használni kívánt útvonalnév
• A használni kívánt végpont neve
• A végpontnak küldött eseményeket meghatározó szűrő
  • Ha le szeretné tiltani az útvonalat, hogy ne legyen eseményküldés, használja a következő szűrőértéket: false
  • Egy adott szűréssel nem rendelkező útvonal engedélyezéséhez használja a következő szűrőértéket: true
  • Bármilyen más típusú szűrővel kapcsolatos részletekért tekintse meg az alábbi Szűrési események szakaszt

Ha nincs útvonalnév, a rendszer nem irányít át üzeneteket az Azure Digital Twinsen kívül. Ha van egy útvonalnév, és a szűrő az true, az összes üzenet a végpontra lesz irányítva. Ha van egy útvonalnév, és egy másik szűrőt ad hozzá, az üzenetek szűrése a szűrő alapján történik.

Az eseményútvonalak az Azure Portalon, az EventRoutes adatsík API-kkal vagy az dt route CLI-parancsokkal hozhatók létre. A szakasz többi része végigvezeti a létrehozási folyamaton.

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

public static async Task CreateEventRouteAsync(DigitalTwinsClient client, string routeId, DigitalTwinsEventRoute er)
{
    try
    {
        Console.WriteLine("Create a route: testRoute1");

        // Make a filter that passes everything
        er.Filter = "true";
        await client.CreateOrReplaceEventRouteAsync(routeId, er);
        Console.WriteLine("Create route succeeded.");

        // List routes
        AsyncPageable<DigitalTwinsEventRoute> results = client.GetEventRoutesAsync();
        await foreach (DigitalTwinsEventRoute route in results)
        {
            Console.WriteLine($"Route {route.Id} to endpoint {route.EndpointName} with filter {route.Filter} ");
        }

        // Delete route created earlier
        Console.WriteLine($"Deleting route {routeId}:");
        await client.DeleteEventRouteAsync(routeId);
    }
    catch (RequestFailedException e)
    {
        Console.WriteLine($"*** Error in event route processing ({e.ErrorCode}):\n${e.Message}");
    }
}

Események szűrése

A fentiekben leírtak szerint az útvonalak szűrőmezővel rendelkeznek. Ha az útvonal szűrőértéke az false, a rendszer nem küld eseményeket a végpontnak.

Miután engedélyezte a minimális szűrőt true, a végpontok különböző típusú eseményeket kapnak az Azure Digital Twinstől:

• Digitális ikerpéldányok által aktivált telemetriai adatok az Azure Digital Twins szolgáltatás API-val
• Ikertulajdonság-változási értesítések, aktiválva az Azure Digital Twins-példány bármely ikerpéldányának tulajdonságváltozásai miatt
• Életciklus-események, amelyek ikerpéldányok vagy kapcsolatok létrehozásakor vagy törlésekor aktiválódnak

Az elküldött események típusait egy konkrétabb szűrő definiálásával korlátozhatja.

{
    "endpointName": "<endpoint-name>",
    "filter": "<filter-text>"
}

Támogatott útvonalszűrők

Íme a támogatott útvonalszűrők.

Az alábbi adattípusok támogatottak a fenti adatokra mutató hivatkozások által visszaadott értékekként:

Az útvonalszűrők meghatározásakor a következő operátorok támogatottak:

Az útvonalszűrők meghatározásakor a következő függvények támogatottak:

Szűrő implementálása vagy frissítése esetén a módosítás néhány percet is igénybe vehet, amíg megjelenik az adatfolyam.

Eseményútvonalak figyelése

Az útválasztási metrikákat, például a darabszámot, a késést és a hibaarányt az Azure Portalon tekintheti meg.

A metrikák Azure Monitorral való megtekintésével és kezelésével kapcsolatos információkért tekintse meg a Metrikák kezelő használatának első lépéseit. Az Azure Digital Twinshez elérhető útválasztási metrikák teljes listájáért tekintse meg az Azure Digital Twins útválasztási metrikáit.

Következő lépések

További információ a különböző típusú eseményüzenetekről:

• Eseményértesítések