Vytváření tras a filtrů událostí ve službě Azure Digital Twins

Tento článek vás provede procesem vytváření tras událostí pomocí webu Azure Portal, Azure CLI az dt route příkazů, rozhraní API roviny dat tras událostí a sady .NET (C#).

Směrování oznámení událostí z Azure Digital Twins do podřízených služeb nebo připojených výpočetních prostředků je dvoustupňový proces: vytvoření koncových bodů a následné vytvoření tras událostí pro odesílání dat do těchto koncových bodů. Tento článek popisuje druhý krok, který nastavuje trasy pro řízení, které události se doručují do koncových bodů služby Azure Digital Twin. Pokud chcete pokračovat v tomto článku, měli byste mít už vytvořené koncové body .

Požadavky

• Budete potřebovat účet Azure, který si můžete zdarma nastavit.

• Ve svém předplatném Azure budete potřebovat instanci Azure Digital Twins. Pokud ještě instanci nemáte, můžete ji vytvořit pomocí kroků v části Nastavení instance a ověřování. Můžete použít následující hodnoty z nastavení, které můžete použít dále v tomto článku:

  • Název instance
  • Skupina prostředků

  Tyto podrobnosti najdete na webu Azure Portal po nastavení instance.

  

• Vytvořte koncový bod podle pokynů v části Vytvoření koncových bodů. V tomto článku vytvoříte trasu pro odesílání dat do tohoto koncového bodu.

V dalším kroku postupujte podle následujících pokynů, pokud chcete použít Azure CLI a postupujte podle této příručky.

Příprava prostředí pro rozhraní příkazového řádku Azure

• Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.

  

• Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.

  • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.

  • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.

  • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Vytvoření trasy události

Po vytvoření koncového bodu budete muset definovat trasu události, která skutečně odesílá data do koncového bodu. Tyto trasy umožňují vývojářům připojit tok událostí v celém systému a do podřízených služeb. Jedna trasa může povolit výběr více oznámení a typů událostí. Přečtěte si další informace o trasách událostí v koncových bodech a trasách událostí.

Definice trasy může obsahovat tyto prvky:

• Název trasy, kterou chcete použít
• Název koncového bodu, který chcete použít
• Filtr, který definuje, které události se posílají do koncového bodu
  • Pokud chcete trasu zakázat, aby se neposílaly žádné události, použijte hodnotu filtru false
  • Pokud chcete povolit trasu, která nemá žádné konkrétní filtrování, použijte hodnotu filtru true
  • Podrobnosti o jakémkoli jiném typu filtru najdete v části Události filtru níže.

Pokud název trasy neexistuje, žádné zprávy se nesměrují mimo Službu Azure Digital Twins. Pokud existuje název trasy a filtr je true, všechny zprávy se směrují do koncového bodu. Pokud je název trasy a přidá se jiný filtr, zprávy se budou filtrovat podle filtru.

Trasy událostí je možné vytvořit pomocí webu Azure Portal, rozhraní API roviny dat EventRoutes nebo příkazu az dt route CLI. Zbývající část této části vás provede procesem vytváření.

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}");
    }
}

Události filtru

Jak je popsáno výše, trasy mají pole filtru. Pokud je falsehodnota filtru ve vaší trase , do koncového bodu se neposílají žádné události.

Po povolení minimálního truefiltru koncových bodů z Azure Digital Twins obdrží různé druhy událostí:

• Telemetrie aktivovaná digitálními dvojčaty pomocí rozhraní API služby Azure Digital Twins
• Oznámení o změně vlastností dvojčete, aktivované při změnách vlastností pro jakékoli dvojče v instanci Služby Azure Digital Twins
• Události životního cyklu, aktivované při vytváření nebo odstranění dvojčat nebo relací

Typy událostí, které se odesílají, můžete omezit definováním konkrétnějšího filtru.

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

Podporované filtry tras

Tady jsou podporované filtry tras.

Následující datové typy jsou podporovány jako hodnoty vrácené odkazy na výše uvedená data:

Při definování filtrů tras se podporují následující operátory:

Při definování filtrů tras se podporují následující funkce:

Když implementujete nebo aktualizujete filtr, může trvat několik minut, než se změna projeví v datovém kanálu.

Monitorování tras událostí

Metriky směrování, jako je počet, latence a míra selhání, se dají zobrazit na webu Azure Portal.

Informace o zobrazení a správě metrik pomocí služby Azure Monitor najdete v tématu Začínáme s průzkumníkem metrik. Úplný seznam metrik směrování dostupných pro Azure Digital Twins najdete v tématu Metriky směrování služby Azure Digital Twins.

Další kroky

Přečtěte si o různých typech zpráv událostí, které můžete přijímat:

• Oznámení událostí