Skapa händelserutter och filter i Azure Digital Twins

Den här artikeln guidar dig genom processen att skapa händelserutter med hjälp av Azure portal, Azure CLI az dt route-kommandon, Event Routes data plane API:er, och .NET (C#) SDK.

Routing händelseanmälningar från Azure Digital Twins till nedströms tjänster eller anslutna beräkningsresurser är en process i två steg: skapa slutpunkter, sedan skapa händelserutter för att skicka data till dessa slutpunkter. Den här artikeln täcker det andra steget, att skapa rutter för att kontrollera vilka händelser som levereras till vilka Azure Digital Twin slutpunkter. För att fortsätta med denna artikel bör du redan ha endpoints skapade.

Förutsättningar

• Du behöver ett Azure-konto som kan konfigureras kostnadsfritt

• Du behöver en Azure Digital Twins-instans i din Azure-prenumeration. Om du inte redan har en instans kan du skapa en med hjälp av stegen i Ställ in en instans och autentisering. Ha följande värden från installationen tillgängliga för att använda senare i denna artikel.

  • Instansnamn
  • Resursgrupp

  Du kan hitta dessa detaljer i Azure-portalen efter att du har konfigurerat din instans.

  

• Skapa en slutpunkt genom att använda instruktionerna i Skapa slutpunkter. I den här artikeln skapar du en väg för att skicka data till slutpunkten.

Utför sedan följande instruktioner om du tänker använda Azure CLI när du följer den här guiden.

Förbered din miljö för Azure CLI

• Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Kom igång med Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt, installera Azure CLI. Om du kör Windows eller macOS, överväg att köra Azure CLI i en Docker-container. För mer information, se Hur man kör Azure CLI i en Docker-container.

  • Om du använder en lokal installation, logga in på Azure CLI med hjälp av kommandot az login. För att slutföra autentiseringsprocessen, följ stegen som visas i din terminal. Andra inloggningsalternativ finns i Autentisera till Azure med Azure CLI.

  • När du uppmanas, installera Azure CLI-tillägget vid första användning. Mer information om tillägg finns i Använda och hantera tillägg med Azure CLI.

  • Kör az version för att hitta versionen och de beroende bibliotek som är installerade. För att uppgradera till den senaste versionen, kör az upgrade.

Skapa en eventrutt

Efter att ha skapat en slutpunkt måste du definiera en händelserutt för att faktiskt skicka data till slutpunkten. Dessa rutter låter utvecklare koppla ihop händelseflödet genom hela systemet och till underordnade tjänster. En enda rutt kan tillåta att flera notifieringar och händelsetyper väljs. Mer information om händelsevägar finns i Dirigera Azure Digital Twins-händelser.

En ruttdefinition kan innehålla dessa element:

• Det rutt-namnet du vill använda
• Namnet på den slutpunkt du vill använda
• En filter som definierar vilka händelser som skickas till slutpunkten
  • För att inaktivera rutten så att inga händelser skickas, använd ett filtervärde av false
  • För att aktivera en rutt som inte har någon specifik filtrering, använd ett filtervärde av true
  • Mer information om andra typer av filter finns i avsnittet Filterhändelser

Om det inte finns något rutt namn, skickas inga meddelanden utanför Azure Digital Twins. Om det finns ett ruttnamn och filtret är true, routas alla meddelanden till slutpunkten. Om det finns ett vägnamn och ett annat filter läggs till filtreras meddelanden baserat på filtret.

Händelsevägar kan skapas med Azure-portalen, API:er för händelsevägar för dataplanet eller cli-kommandon för az dt route. Resten av denna sektion går igenom skapelseprocessen.

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

Filtrera händelser

Som tidigare beskrivits har vägar ett filterfält. Om filtervärdet på din väg är falseskickas inga händelser till slutpunkten.

När du har aktiverat ett minimalt filter för truefår slutpunkter olika typer av händelser från Azure Digital Twins:

• Telemetri genererat av digitala tvillingar med hjälp av Azure Digital Twins tjänste-API
• Meddelanden om ändring av tvillingegenskaper, som triggas vid ändringar av egenskaper för någon tvilling i Azure Digital Twins-instansen
• Händelser i livscykeln, utlösta när tvillingar eller relationer skapas eller raderas

Du kan begränsa typen av händelser som skickas genom att definiera ett mer specifikt filter.

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

Stödda ruttfilter

Här är de stödda rutfilter.

Följande datatyper stöds som värden som returneras av referenser till tidigare data:

Följande operatorer stöds när du definierar filter för rutter:

Följande funktioner stöds när du definierar ruttfilter:

När du implementerar eller uppdaterar ett filter kan det ta några minuter innan ändringen återspeglas i datapipelinen.

Övervaka händelserutter

Rutteringsmetrik såsom antal, fördröjning och felprocent kan ses i Azure-portalen.

Information om hur du visar och hanterar mått med Azure Monitor finns i Analysera mått med Azure Monitor Metrics Explorer. En fullständig lista över routningsmått som är tillgängliga för Azure Digital Twins finns i Routningsmått.

Nästa steg

Läs om de olika typerna av händelsemeddelanden du kan ta emot.

• Händelseaviseringar