Azure Digital Twins'de olay yolları ve filtreleri oluşturma

Bu makalede Azure portalını, Azure CLI az dt route komutlarını, Event Routes veri düzlemi API'lerini ve .NET (C#) SDK'sını kullanarak olay yolları oluşturma işleminde size yol gösterilir.

Azure Digital Twins'den aşağı akış hizmetlerine veya bağlı işlem kaynaklarına olay bildirimlerini yönlendirmek iki adımlı bir işlemdir: uç noktalar oluşturma ve ardından bu uç noktalara veri göndermek için olay yolları oluşturma. Bu makale, hangi olayların hangi Azure Digital Twin uç noktalarına teslim edilir denetlemek için yolların ayarlandığı ikinci adımı kapsar. Bu makaleye devam etmek için uç noktaların önceden oluşturulmuş olması gerekir.

Önkoşullar

• Ücretsiz olarak ayarlanabilen bir Azure hesabına ihtiyacınız olacak

• Azure aboneliğinizde bir Azure Digital Twins örneğine ihtiyacınız olacaktır. Henüz bir örneğiniz yoksa Örneği ayarlama ve kimlik doğrulaması adımlarını kullanarak bir örnek oluşturabilirsiniz. Bu makalenin devamında kullanmak için kurulumdan elde edilen aşağıdaki değerlerin kullanışlı olmasını sağlar:

  • Örnek adı
  • Kaynak grubu

  Örneğinizi ayarladıktan sonra bu ayrıntıları Azure portalında bulabilirsiniz.

  

• Uç nokta oluşturma başlığındaki yönergeleri kullanarak bir uç nokta oluşturun. Bu makalede, bu uç noktaya veri göndermek için bir yol oluşturacaksınız.

Ardından, bu kılavuzu izlerken Azure CLI kullanmayı planlıyorsanız aşağıdaki yönergeleri izleyin.

Ortamınızı Azure CLI’ye hazırlama

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  

• CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

  • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

  • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

  • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Olay yolu oluşturma

Uç nokta oluşturduktan sonra , uç noktaya veri göndermek için bir olay yolu tanımlamanız gerekir. Bu yollar geliştiricilerin olay akışını sistem genelinde ve aşağı akış hizmetlerine aktarmasına olanak tanır. Tek bir yol, birden çok bildirimin ve olay türünün seçilmesine izin verebilir. Uç noktalar ve olay yolları'ndaki olay yolları hakkında daha fazla bilgi edinin.

Yol tanımı şu öğeleri içerebilir:

• Kullanmak istediğiniz yol adı
• Kullanmak istediğiniz uç noktanın adı
• Uç noktaya hangi olayların gönderileceğini tanımlayan filtre
  • Hiçbir olayın gönderilmemesi için yolu devre dışı bırakmak için false
  • Belirli bir filtrelemesi olmayan bir yolu etkinleştirmek için true
  • Diğer filtre türleriyle ilgili ayrıntılar için aşağıdaki Olayları filtreleme bölümüne bakın

Yol adı yoksa, Azure Digital Twins dışında hiçbir ileti yönlendirilmemiş olur. Bir yol adı varsa ve filtre ise true, tüm iletiler uç noktaya yönlendirilir. Yol adı varsa ve farklı bir filtre eklenirse, iletiler filtreye göre filtrelenir.

Olay yolları Azure portalı, EventRoutes veri düzlemi API'leri veya az dt route CLI komutları ile oluşturulabilir. Bu bölümün geri kalanı oluşturma işleminde yol gösterir.

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

Olayları filtreleme

Yukarıda açıklandığı gibi, yolların bir filtre alanı vardır. Rotanızdaki filtre değeri ise falseuç noktanıza hiçbir olay gönderilmez.

en düşük filtreyi trueetkinleştirdikten sonra uç noktalar Azure Digital Twins'den farklı türde olaylar alır:

• Azure Digital Twins hizmet API'sini kullanarak dijital ikizler tarafından tetiklenen telemetri
• İkiz özellik değişikliği bildirimleri, Azure Digital Twins örneğindeki herhangi bir ikiz için özellik değişiklikleri tetiklenir
• İkizler veya ilişkiler oluşturulduğunda veya silindiğinde tetiklenen yaşam döngüsü olayları

Daha özel bir filtre tanımlayarak gönderilen olay türlerini kısıtlayabilirsiniz.

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

Desteklenen yol filtreleri

Desteklenen yol filtreleri aşağıdadır.

Aşağıdaki veri türleri, yukarıdaki verilere başvurular tarafından döndürülen değerler olarak desteklenir:

Yol filtreleri tanımlanırken aşağıdaki işleçler desteklenir:

Yol filtreleri tanımlanırken aşağıdaki işlevler desteklenir:

Bir filtre uyguladığınızda veya güncelleştirdiğinizde, değişikliğin veri işlem hattına yansıtılması birkaç dakika sürebilir.

Olay yollarını izleme

Sayı, gecikme süresi ve hata oranı gibi yönlendirme ölçümleri Azure portalında görüntülenebilir.

Azure İzleyici ile ölçümleri görüntüleme ve yönetme hakkında bilgi için bkz . Ölçüm gezginini kullanmaya başlama. Azure Digital Twins için kullanılabilen yönlendirme ölçümlerinin tam listesi için bkz . Azure Digital Twins yönlendirme ölçümleri.

Sonraki adımlar

Alabileceğiniz farklı olay iletisi türleri hakkında bilgi edinin:

• Olay bildirimleri