Azure dijital TWINS 'te uç noktaları ve yolları yönetme (portal)

Azure dijital TWINS 'de, olay bildirimlerini aşağı akış hizmetlerine veya bağlı işlem kaynaklarına yönlendirebilirsiniz. Bunu yapmak için öncelikle olayları alabilecek uç noktaları ayarlamanız gerekir. Ardından Azure Digital Twins tarafından oluşturulan olayların hangi uç noktalara dağıtılacağını belirten olay rotaları oluşturabilirsiniz.

Bu makalede, Azure Portalkullanarak uç noktalar ve rotalar oluşturma işlemi adım adım açıklanmaktadır.

Alternatif olarak, uç noktaları ve yolları olay rotaları API 'leri, SDK'Lar veya Azure dijital TWINS CLIile de yönetebilirsiniz. Bu makalenin Portal yerine bu mekanizmaların kullanıldığı bir sürümü için bkz. nasıl yapılır: uç noktaları ve yolları yönetme (API 'ler ve CLI).

Önkoşullar

Bu ayrıntıları, örneğinizi ayarladıktan sonra Azure Portal bulabilirsiniz. Portalda oturum açın ve Portal arama çubuğunda örneğinizin adını arayın.

Azure portal arama çubuğunun ekran görüntüsü.

Bu ayrıntıları örneğiniz için genel bakışta görmek üzere sonuçlardan örneğinizi seçin:

Azure portal bir Azure dijital TWINS örneği için genel bakış sayfasının ekran görüntüsü. Ad ve kaynak grubu vurgulanır.

Azure dijital TWINS için uç nokta oluşturma

Bunlar, örneğiniz için oluşturabileceğiniz desteklenen uç nokta türleridir:

Farklı uç nokta türleri hakkında daha fazla bilgi için bkz. Azure mesajlaşma hizmetleri arasında seçim yapın.

Bu bölümde Azure Portalbu uç noktalardan birinin nasıl oluşturulacağı açıklanmaktadır.

Önkoşul: uç nokta kaynakları oluşturma

Bir uç noktayı Azure dijital TWINS 'e bağlamak için, uç nokta için kullanmakta olduğunuz olay Kılavuzu konusu, Olay Hub 'ı veya Service Bus konusunun zaten mevcut olması gerekir.

Uç noktanızı oluşturmadan önce hangi kaynakların ayarlanması gerektiğini görmek için aşağıdaki grafiği kullanın.

Uç nokta türü Gerekli kaynaklar (oluşturma yönergelerine bağlı)
Event Grid uç noktası olay Kılavuzu konusu
Event Hubs uç noktası Olay   hub 'ları   ad alanı

Olay Hub 'ı

Seçim anahtar tabanlı kimlik doğrulaması için Yetkilendirme kuralı
Service Bus uç noktası Service Bus ad alanı

Service Bus konusu

Seçim anahtar tabanlı kimlik doğrulaması için Yetkilendirme kuralı

Uç noktayı oluşturma

Uç nokta kaynaklarını oluşturduktan sonra bunları bir Azure dijital TWINS uç noktası için kullanabilirsiniz. Yeni bir uç nokta oluşturmak için, Azure Portal örneğinizin sayfasına gidin (örneğin adını Portal arama çubuğuna girerek örneği bulabilirsiniz).

  1. Örnek menüsünde uç noktalar' ı seçin. Ardından, izleyen uç noktalar sayfasından + uç nokta oluştur' u seçin. Bu işlem, aşağıdaki adımlarda yer alan alanları dolduracakları bir uç nokta oluştur sayfasını açar.

    Azure portal Event Grid türünde bir uç nokta oluşturma ekran görüntüsü.

  2. Uç noktanız için bir ad girin ve uç nokta türünü seçin.

  3. Aboneliğiniz ve yukarıdaaçıklanan uç nokta kaynakları dahil olmak üzere uç nokta türü için gereken diğer ayrıntıları doldurun.

    1. Yalnızca Olay Hub 'ı ve Service Bus uç noktaları için, bir kimlik doğrulama türü seçmeniz gerekir. Azure dijital TWINS örneğiniz için yönetilen bir kimlikle uç noktayı kullanacaksanız, önceden oluşturulmuş yetkilendirme kuralıyla anahtar tabanlı kimlik doğrulaması veya kimlik tabanlı kimlik doğrulaması kullanabilirsiniz.
  4. Kaydet' i seçerek uç noktanızı oluşturmayı tamamlayın.

Önemli

Uç noktanız için kimlik tabanlı kimlik doğrulamasını başarılı bir şekilde kullanabilmek için, nasıl yapılır: yönlendirme olayları için yönetilen kimliği etkinleştirme (Önizleme)bölümündeki adımları izleyerek örneğiniz için bir yönetilen kimlik oluşturmanız gerekir.

Uç noktanızı oluşturduktan sonra, üstteki Azure portal çubuğundaki bildirim simgesini denetleyerek uç noktanın başarıyla oluşturulduğunu doğrulayabilirsiniz:

Azure portal bir uç noktanın oluşturulmasını doğrulama bildiriminin ekran görüntüsü.

Uç nokta oluşturma işlemi başarısız olursa, hata iletisini gözlemleyin ve birkaç dakika sonra yeniden deneyin.

Ayrıca, Azure dijital TWINS örneğiniz için uç noktalar sayfasında, geri oluşturulan uç noktayı görüntüleyebilirsiniz.

Artık olay Kılavuzu, Olay Hub 'ı veya Service Bus konusu, uç nokta için seçtiğiniz ad altında Azure dijital TWINS 'in içindeki bir uç nokta olarak sunulmaktadır. Genellikle bu adı, Bu makalede daha sonraoluşturacağınız bir olay yolunun hedefi olarak kullanacaksınız.

Etkin olmayan bir uç nokta oluşturma

Bir uç nokta belirli bir süre içinde bir olayı teslim edimezse veya olayı belirli bir sayıda sunmaya çalıştıktan sonra, teslim edilmemiş olayı bir depolama hesabına gönderebilir. Bu işlem, atılacak olarak bilinir.

Etkin olmayan bir uç nokta oluşturmak için, Azure portal yerine uç noktanızı oluşturmak için CLI komutlarını veya Denetim düzlemi API 'lerini kullanmanız gerekir.

Bu araçların nasıl yapılacağı hakkında yönergeler için, bu makalenin API 'leri ve CLI sürümüne bakın.

Olay yolu oluşturma

Azure dijital TWINS 'den bir uç noktaya gerçek veri göndermek için bir olay yolu tanımlamanız gerekir. Bu yollar, geliştiricilerin sistem genelinde ve aşağı akış hizmetlerinde olay akışını üzerinde bağlantı almasına imkan tanır. Kavramlar bölümünde olay yolları hakkında daha fazla bilgi edinin : Azure dijital TWINS olaylarını yönlendirme.

Önkoşul: bir yol oluşturmak için geçiş yapabilmeniz için önce Bu makalenin önceki kısımlarında açıklandığı gibi uç noktalar oluşturmanız gerekir. Uç noktalarınız kurulum tamamlandıktan sonra bir olay rotası oluşturmaya devam edebilirsiniz.

Not

Son noktalarınızı dağıttıysanız, yeni bir olay yolu için kullanmayı denemeden önce bunların dağıtımını tamamladığınızı doğrulayın. Uç noktalar hazırlanmadığından yolu ayarlayamıyoruz, birkaç dakika bekleyip yeniden deneyin.

Azure portal oluşturma adımları

Bir olay yolu tanımı şu öğeleri içerir:

  • Kullanmak istediğiniz yol adı
  • Kullanmak istediğiniz uç noktanın adı
  • Uç noktaya gönderilen olayları tanımlayan filtre
    • Bir olayın gönderilmemesi için yolu devre dışı bırakmak için bir filtre değeri kullanın false
    • Belirli bir filtreleme özelliği olmayan bir yolu etkinleştirmek için, bir filtre değeri kullanın true
    • Diğer filtre türleri hakkında daha fazla bilgi için aşağıdaki Olayları Filtrele bölümüne bakın.

Tek bir yol, birden fazla bildirim ve olay türünün seçili olmasını sağlayabilir.

Bir olay yolu oluşturmak için Azure Portal Azure dijital TWINS örneğinizin ayrıntılar sayfasına gidin (örneğin adını Portal arama çubuğuna girerek örneği bulabilirsiniz).

Örnek menüsünden olay yolları' nı seçin. Ardından, aşağıdaki olay yolları sayfasından + bir olay yolu oluştur' u seçin.

Açılan bir olay yolu oluştur sayfasında en az ' ı seçin:

  • Ad alanına yönlendirmenize ilişkin bir ad
  • Yolu oluşturmak için kullanmak istediğiniz uç nokta

Yolun etkinleştirilmesi için, en azından bir olay yönlendirme filtresi de eklemeniz gerekir true . (Varsayılan değerinin bırakılması false yolu oluşturur, ancak buna hiçbir olay gönderilmez.) Bunu yapmak için, Gelişmiş düzenleyicinin anahtarını etkinleştirmek üzere değiştirin ve true filtre kutusuna yazın.

Azure portal örneğiniz için bir olay yolu oluşturma ekran görüntüsü.

İşiniz bittiğinde, olay yönlendirinizi oluşturmak için Kaydet düğmesini seçin.

Olayları filtreleme

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

En az filtresini etkinleştirdikten sonra true uç noktalar Azure dijital TWINS 'den çeşitli olaylar alır:

  • Azure Digital TWINS hizmet API 'SI kullanılarak dijital TWINS tarafından tetiklenen telemetri
  • İkizi özellik değişikliği bildirimleri, Azure dijital TWINS örneğindeki herhangi bir ikizi için özellik değişikliklerinde harekete geçirilir
  • Yaşam döngüsü olayları, TWINS veya ilişkiler oluşturulduğunda veya silindiğinde tetiklenir

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

Bir olay yolu oluştururken bir olay filtresi eklemek için, olay yolu oluşturma sayfasının "olay yol filtresi ekle" bölümünü kullanın.

Bazı temel ortak filtre seçeneklerinden birini seçebilir veya kendi özel filtrelerinizi yazmak için gelişmiş filtre seçeneklerini kullanabilirsiniz.

Not

Filtreler büyük/küçük harfe duyarlıdır ve yük durumuyla eşleşmesi gerekir.

Telemetri filtreleri için bu, büyük küçük harf 'in cihaz tarafından gönderilen telemetrideki büyük/küçük harf ile eşleşmesi gerektiği anlamına gelir.

Temel filtreleri kullanma

Temel filtreleri kullanmak için, olay türleri seçeneğini genişletin ve uç noktanıza göndermek istediğiniz olaylara karşılık gelen onay kutularını seçin.

Azure portal temel bir filtreye sahip bir olay yolu oluşturma ekran görüntüsü, olayların onay kutularını vurgular.

Bu, filtre metin kutusunu seçtiğiniz filtrenin metniyle otomatik olarak doldurur:

Azure portal temel bir filtreye sahip bir olay yolu oluşturma ekran görüntüsü, olayları seçtikten sonra otomatik doldurulmuş filtre metnini vurgular.

Gelişmiş filtreleri kullanma

Alternatif olarak, kendi özel filtrelerinizi yazmak için Gelişmiş Filtre seçeneğini de kullanabilirsiniz.

Gelişmiş filtre seçenekleriyle bir olay yolu oluşturmak için, Gelişmiş düzenleyicinin anahtarını etkinleştirmek üzere değiştirin. Ardından Filtre kutusuna kendi olay filtrelerinizi yazabilirsiniz:

Uygulamanın içinde gelişmiş filtre ile olay rotası oluşturma Azure portal.

Desteklenen yol filtreleri aşağıdaki gibidir. Filtre metni şeması sütunundaki ayrıntı, filtre kutusuna girilebilir metindir.

Filtre adı Description Metin şemasını filtreleme Desteklenen değerler
Doğru / Yanlış Filtrelemeye gerek bırakmadan yol oluşturmaya veya hiçbir olay gönderilmeden yolu devre dışı bırakmaya izin verir <true/false> true = yol hiçbir filtreleme ile etkin
false = yol devre dışı bırakıldı
Tür Dijital ikiz örneğinizin içinden geçen olay türü type = '<event-type>' Olası olay türü değerleri şu şekildedir:
Microsoft.DigitalTwins.Twin.Create
Microsoft.DigitalTwins.Twin.Delete
Microsoft.DigitalTwins.Twin.Update
Microsoft.DigitalTwins.Relationship.Create
Microsoft.DigitalTwins.Relationship.Update
Microsoft.DigitalTwins.Relationship.Delete
microsoft.iot.telemetry
Kaynak Örnek Azure Digital Twins adı source = '<host-name>' Olası konak adı değerleri şu şekildedir:
Bildirimler için:<your-Digital-Twins-instance>.api.<your-region>.digitaltwins.azure.net
Telemetri için:<your-Digital-Twins-instance>.api.<your-region>.digitaltwins.azure.net/<twin-ID>
Konu Yukarıdaki olay kaynağı bağlamında olayın açıklaması subject = '<subject>' Olası konu değerleri şu şekildedir:
Bildirimler için: Konu şudur: <twin-ID>
veya birden çok parça veya kimlik tarafından benzersiz olarak tanımlanan konular için bir URI biçimi:
<twin-ID>/relationships/<relationship-ID>
Telemetri için: Konu, gibi bileşen yoludur (telemetri bir ikiz bileşeninden comp1.comp2 yayılıyorsa). Telemetri bir bileşenden yayımlanmazsa, konu alanı boş olur.
Veri şeması DTDL model kimliği dataschema = '<model-dtmi-ID>' Telemetri için: veri şeması, ikizi veya Telemetriyi gösteren BILEŞENIN model kimliğidir. Örneğin, dtmi:example:com:floor4;2
Bildirimler için (oluşturma/silme): veri şemasına, konumundaki bildirim gövdesinden erişilebilir $body.$metadata.$model .
Bildirimler (güncelleştirme) için: şu adreste bulunan bildirim gövdesinden veri şemasına erişilebilir: $body.modelId
İçerik türü Veri değerinin içerik türü datacontenttype = '<content-type>' İçerik türü application/json
Spec sürümü Kullandığınız olay şemasının sürümü specversion = '<version>' Sürüm olmalıdır 1.0 . Bu, CloudEvents şema sürüm 1,0 ' i gösterir
Bildirim gövdesi Bildirim alanındaki herhangi bir özelliğe başvur data $body.<property> Bkz. kavramlar: bildirim örnekleri için olay bildirimleri . Alanındaki herhangi bir özelliğe, data kullanılarak başvurulabilir $body

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

Veri türü Örnek
Dize STARTS_WITH($body.$metadata.$model, 'dtmi:example:com:floor')
CONTAINS(subject, '<twin-ID>')
Tamsayı $body.errorCode > 200
Çift $body.temperature <= 5.5
Bool $body.poweredOn = true
Null $body.prop != null

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

Family (Aile) İşleçler Örnek
Mantıksal VE, VEYA, () (type != 'microsoft.iot.telemetry' OR datacontenttype = 'application/json') OR (specversion != '1.0')
Karşılaştırma <, <=, >, >=, =,! = $body.temperature <= 5.5

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

İşlev Açıklama Örnek
STARTS_WITH(x,y) Değer dizesiyle x başlıyorsa true değerini y döndürür. STARTS_WITH($body.$metadata.$model, 'dtmi:example:com:floor')
ENDS_WITH(x,y) Değerin dizesiyle x sona erdiğinde true değerini y döndürür. ENDS_WITH($body.$metadata.$model, 'floor;1')
CONTAINS(x,y) değeri dizesini x içeriyorsa true değerini y döndürür. CONTAINS(subject, '<twin-ID>')

Bir filtreyi uygulayan veya güncelleştiren bir değişikliğin veri işlem hattına uygulanması birkaç dakika sürebilir.

Olay yollarını izle

Sayı, gecikme ve hata oranı gibi yönlendirme ölçümleri Azure Portalgörüntülenebilir.

Portal giriş sayfasında, ayrıntılarını almak için Azure dijital TWINS örneğinizi arayın. Ölçüm sayfasını açmak için sol taraftaki Azure dijital TWINS örneğinin gezinti menüsünden ölçümler seçeneğini belirleyin.

Azure dijital TWINS için ölçümler sayfasını gösteren ekran görüntüsü.

Buradan, örneğiniz için ölçümleri görüntüleyebilir ve özel görünümler oluşturabilirsiniz.

Azure dijital TWINS ölçümlerini görüntüleme hakkında daha fazla bilgi için bkz. nasıl yapılır: Azure izleyici ile ölçümleri görüntüleme.

Sonraki adımlar

Alyabilirsiniz farklı olay iletileri türleri hakkında bilgi okuyun: