Öğretici: Bölüm 2 - Yönlendiren iletileri görüntüleme

İleti yönlendirme , IoT cihazlarınızdaki telemetri verilerini, yerleşik Olay Hub 'ı ile uyumlu uç noktalara veya blob depolama, Service Bus kuyrukları, Service Bus konuları ve Event Hubs gibi özel uç noktalara göndermeye olanak sağlar. Özel ileti yönlendirmeyi yapılandırmak için, belirli bir koşulla eşleşen yolu özelleştirmek üzere yönlendirme sorguları oluşturursunuz. Ayarlandıktan sonra, gelen veriler IoT Hub'ı tarafından otomatik olarak uç noktalara yönlendirilir. Bir ileti tanımlanmış yönlendirme sorgularının hiçbiriyle eşleşmezse, varsayılan uç noktaya yönlendirilir.

Bu 2 parçalı öğreticide, IoT Hub ile bu özel yönlendirme sorgularını ayarlamayı ve kullanmayı öğreneceksiniz. Bir IoT cihazından gelen iletileri BLOB depolama ve Service Bus kuyruğu dahil olmak üzere birden çok uç noktasından birine yönlendirdiğinizde. Service Bus kuyruğuna iletiler bir mantıksal uygulama tarafından çekilir ve e-posta ile gönderilir. Özel ileti yönlendirmesi tanımlı olmayan iletiler varsayılan uç noktaya gönderilir, ardından Azure Stream Analytics tarafından çekilir ve bir Power BI görselleştirmesinde görüntülenir.

Bu öğreticinin 1. ve 2. kısmını tamamlamak için aşağıdaki görevleri gerçekleştirirsiniz:

Bölüm ı: kaynak oluşturma, ileti yönlendirmeyi ayarlama

Bölüm II: hub 'a ileti gönderme, yönlendirilmiş sonuçları görüntüleme

Önkoşullar

• Bu öğreticinin 1. bölümü için:

  • Bir Azure aboneliğiniz olmalıdır. Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

• Bu öğreticinin 2. bölümü için:

  • Bu öğreticinin 1. kısmını tamamlamış ve kaynakları hala kullanılabilir durumda olmalıdır.
  • Visual Studio 'yuyükler.
  • Varsayılan uç noktanın Stream Analytics 'i çözümlemek için bir Power BI hesabına erişiminiz vardır. (Power BI'ı ücretsiz deneyin.)
  • Bildirim e-postaları göndermek için bir iş veya okul hesabına sahip olmanız gerekir.
  • Güvenlik duvarınızdaki 8883 numaralı bağlantı noktasını açık olduğundan emin olun. Bu öğreticideki örnek, 8883 bağlantı noktası üzerinden iletişim kuran MQTT protokolünü kullanır. Bu bağlantı noktası, bazı kurumsal ve eğitim ağ ortamlarında engellenebilir. Bu sorunu geçici olarak çözmek için daha fazla bilgi ve IoT Hub bkz. bağlanma (MQTT).

Azure Cloud Shell kullanma

Azure, tarayıcınız aracılığıyla kullanabileceğiniz etkileşimli bir kabuk ortamı olan Azure Cloud Shell’i barındırır. Azure hizmetleriyle çalışmak için Cloud Shell ile Bash veya PowerShell kullanabilirsiniz. Bu makaledeki kodu, yerel ortamınıza herhangi bir şey yüklemeye gerek kalmadan çalıştırmak için Cloud Shell’in önceden yüklenmiş komutlarını kullanabilirsiniz.

Azure Cloud Shell’i başlatmak için:

Seçenek	Örnek/Bağlantı
Kod bloğunun sağ üst köşesindeki Deneyin’i seçin. Deneyin seçeneği belirlendiğinde, kod otomatik olarak Cloud Shell’e kopyalanmaz.
Cloud Shell’i tarayıcınızda açmak için https://shell.azure.com bölümüne gidin veya Cloud Shell’i Başlat düğmesini seçin.
Azure portalın sağ üst köşesindeki menü çubuğunda yer alan Cloud Shell düğmesini seçin.

Azure Cloud Shell’de bu makaledeki kodu çalıştırmak için:

1. Cloud Shell’i başlatın.

2. Kodu kopyalamak için kod bloğunda Kopyala düğmesini seçin.

3. Windows ve Linux sisteminde Ctrl+Shift+V tuşlarını kullanarak veya macOS’de Cmd+Shift+V tuşlarını kullanarak kodu Cloud Shell oturumuna yapıştırın.

4. Kodu çalıştırmak için Enter tuşuna basın.

İletileri yönlendirme kuralları

Aşağıda, bu öğreticinin 1. Bölümünde ayarlanmış olan ileti yönlendirme kuralları ve bu ikinci bölümde çalışlarını görüyorsunuz.

Şimdi iletilerin yönlendirecekleri kaynakları oluşturabilir, hub'a ileti göndermek için bir uygulama çalıştıracak ve yönlendirmenin nasıl iş haline geleceklerini görüyorsunuz.

Mantıksal Uygulama oluşturma

Service Bus kuyruğu kritik olarak belirlenmiş iletileri almak için kullanılacaktır. Service Bus kuyruğunu izlemek ve kuyruğa ileti eklendiğinde bir e-posta göndermek için bir Mantıksal uygulama ayarlayın.

1. Uygulamanın Azure portal + Kaynak oluştur'a seçin. Mantıksal uygulamayı arama kutusuna ekleyin ve Enter tarak seçin. Görüntülenen arama sonuçlarında Mantıksal Uygulama'ya ve ardından Oluştur'a seçerek Mantıksal uygulama oluştur bölmesine devam edin. Alanları doldurun.

   Abonelik: Azure aboneliğinizi seçin.

   Kaynak grubu: Kaynak Grubu alanı altında Yeni oluştur'ı seçin. Kaynak grubunun adı olarak ContosoResources belirtin.

   Örnek Ayrıntıları Tür: Örnek türü olarak Tüketim'i seçin.

   Mantıksal Uygulama Adı için mantıksal uygulamanın adını belirtin. Bu öğreticide ContosoLogicApp kullanılır.

   Bölge: En yakın veri merkezi konumunu kullanın. Bu öğreticide Batı ABD kullanılır.

   Log Analytics'i etkinleştir: Bu iki durumlu düğmeyi, log analytics'i etkinleştirmey olarak ayarlayın.

   

   Gözden geçir + Oluştur’u seçin. Uygulamanın dağıtımı birkaç dakika sürebilir. Tamamlandığında, dağıtıma genel bakış veren bir ekran gösterir.

2. Mantıksal Uygulama'ya gidin. Hala dağıtım sayfasındaysanız Kaynağa Git'i seçin. Mantıksal Uygulama'ya varmanın bir diğer yolu da Kaynak grupları'nın , kaynak grubu seçin (bu öğreticide ContosoResources'ın kullanımı) ve ardından kaynak listesinden Mantıksal Uygulama'nın seçimidir.

   Boş Mantıksal Uygulama + olan neredeyse boş kutucuğu görene kadar aşağı kaydırın ve seçin. Ekranda varsayılan sekme "Sizin için" şeklindedir. Bu bölme boşsa, kullanılabilir bağlayıcıları ve tetikleyicileri görmek için Hepsi'ni seçin.

3. Bağlayıcı listesinden Service Bus'yi seçin.

   

4. Bu ekran görüntüsü tetikleyicilerin listesini gösterir. Kuyruğa ileti geldiğinde (otomatik tamamlama) seçeneğinin yer aldığı bir ileti seçin.

   

5. Sonraki ekranda yer alan alanları bağlantı bilgileriyle doldurun.

   Bağlantı Adı: ContosoConnection

   Ad Alanı'Service Bus seçin. Bu öğreticide ContosoSBNamespace kullanılır. Anahtarın adı (RootManageSharedAccessKey) ve haklar (Dinleme, Yönetme, Gönderme) alınır ve yüklenir. RootManageSharedAccessKey öğesini seçin. Oluştur düğmesi mavi (etkin) olarak değişir. Seçin; kuyruk seçim ekranı gösterilir.

6. Ardından kuyruk hakkında bilgi istensin.

   

   Kuyruk Adı: Bu alan, iletinin gönderildiği kuyruğun adıdır. Bu açılan listeye tıklayın ve kurulum adımlarında ayarlanmış kuyruk adını seçin. Bu öğreticide contososbqueue kullanılır.

   Kuyruk Türü: Kuyruk türü. Açılan listeden Ana'ya tıklayın.

   Diğer alanlar için varsayılan değerleri alır. Mantıksal uygulama tasarımcısı yapılandırmasını kaydetmek için Kaydet'i seçin.

7. +Yeni Adım'ı seçin. İşlem seçin bölmesi görüntülenir. Öğesini Office 365 Outlook. Listede E-posta Gönder (V2) öğesini bulun ve seçin. Office 365 oturum açın.

8. Kuyrukta iletiyle ilgili bir e-posta gönderirken kullanılacak alanları doldurun.

   

   Hedef: Uyarının gönderl olduğu e-posta adresini girin.

   Konu: E-postanın konusunu doldurun.

   Gövde: Gövde için bir metin girin. Dinamik içerik ekle'ye tıklayın; dahil etmek için e-postadan seçebilirsiniz alanları gösterir. Herhangi bir seçenek görmüyorsanız daha fazla seçenek görmek için Daha Fazla'ya tıklayın. E-postadan gövdenin hata iletisinde görüntülenebilir için İçerik'i seçin.

9. Kaydet’a tıklayarak değişikliklerinizi kaydedin. Mantıksal uygulama tasarımcısını kapatın.

Azure Stream Analytics'i ayarlama

Verileri Power BI görselleştirmesinde görmek için, önce bir Stream Analytics işi ayarlayarak verileri alın. Yalnızca düzeyi****normal olan iletilerin varsayılan uç noktaya gönderildiğini ve Power BI görselleştirmesi için Stream Analytics işi tarafından alınacağını unutmayın.

Stream Analytics işi oluşturma

1. Stream Analytics işini arama kutusuna Azure portal ve Enter tarak seçin. Oluştur'a seçerek Stream Analytics ekranına ve ardından yeniden oluştur'a tıklayın.

2. İş için aşağıdaki bilgileri girin.

   İş adı: İşin adı. Adın genel olarak benzersiz olması gerekir. Bu öğreticide contosoJob kullanılır.

   Abonelik: Öğretici için kullanmakta olduğu Azure aboneliği.

   Kaynak grubu: IoT hub'ınız tarafından kullanılan kaynak grubunun aynısını kullanın. Bu öğreticide ContosoResources kullanılır.

   Konum: Kurulum betiğinde kullanılan konumun aynısını kullanın. Bu öğreticide Batı ABD kullanılır.

   

3. İş oluşturmak için Oluştur'a seçin. Dağıtımı birkaç dakika sürebilir.

   işe dönmek için Kaynağa git'i seçin. Kaynak grupları'ı da seçebilirsiniz. Bu öğreticide ContosoResources kullanılır. Sonra kaynak grubunu seçin ve ardından kaynak listesinden Stream Analytics işi seçin.

Stream Analytics işine giriş ekleme

1. Iş topolojisi altında girişler' i seçin.

2. Girişler bölmesinde akış girişi Ekle ' yi seçin ve IoT Hub ' ı seçin. Görüntülenen ekranda aşağıdaki alanları doldurun:

   Giriş diğer adı: Bu öğreticide contosoinputs kullanılır.

   Aboneliklerinizden IoT Hub Seç' i seçin ve ardından açılır listeden aboneliğinizi seçin.

   IoT Hub: IoT Hub 'ı seçin. Bu öğreticide ContosoTestHub kullanılır.

   Tüketici grubu: Bu öğreticinin 1. bölümünde ayarlanan tüketici grubunu seçin. Bu öğreticide contosoconsumers kullanılır.

   Paylaşılan erişim ilkesi adı: hizmeti seçin. Paylaşılan Erişim İlkesi Anahtarı'nı portal sizin için doldurur.

   Uç nokta: Mesajlaşma'yı seçin. (İşlem İzleme'yi seçerseniz, gönderdiğiniz veriler yerine IoT hub'ı hakkındaki telemetri verilerini alırsınız.)

   Kalan alanlar için varsayılan değerleri kabul edin.

   

3. Kaydet’i seçin.

Stream Analytics işine çıkış ekleme

1. Iş topolojisi altında, çıktılar' i seçin.

2. Çıktılar bölmesinde Ekle' yi ve ardından Power BI' yi seçin. Görüntülenen ekranda aşağıdaki alanları doldurun:

   Çıkış diğer adı: Çıkışın benzersiz diğer adı. Bu öğreticide contosooutputs kullanılır.

   Aboneliklerinizden Grup çalışma alanını Seç' i seçin. Grup çalışma alanında çalışma alanım' ı belirtin.

   Kimlik doğrulama modu: kullanıcı belirtecini seçin.

   Veri kümesi adı: Power BI'da kullanılacak veri kümesinin adı. Bu öğreticide contosodataset kullanılır.

   Tablo adı: Power BI'da kullanılacak tablonun adı. Bu öğreticide contosotable kullanılır.

3. yetkilendir' i seçin ve Power BI hesabınızda oturum açın. (Oturum açma birden fazla denemeye başlayabilir).

   

4. Kaydet’i seçin.

Stream Analytics işinin sorgusunu yapılandırma

1. Iş topolojisi altında sorgu' yı seçin.

2. [YourInputAlias] değerini işin giriş diğer adıyla değiştirin. Bu öğreticide contosoinputs kullanılır.

3. [YourOutputAlias] değerini işin çıkış diğer adıyla değiştirin. Bu öğreticide contosooutputs kullanılır.

   

4. Kaydet’i seçin.

5. Sorgu bölmesini kapatın. Kaynak grubundaki kaynakların görünümüne geri dönersiniz. Stream Analytics işi seçin. Bu öğreticide contosoJob olarak adlandırılmıştır.

Stream Analytics işini çalıştırma

Stream Analytics işinde > Şimdi > Başlat Başlat' ı seçin. İş düzgün bir şekilde başlatıldıktan sonra, Durduruldu olan iş durumu Çalışıyor olarak değiştirilir.

Power BI raporunu ayarlamak için, verilerin olması gerekir, bu nedenle cihazı oluşturduktan sonra Power BI ayarlayacaksınız ve bazı verileri oluşturmak için cihaz benzetimi uygulamasını çalıştıracağız.

Sanal cihaz uygulamasını Çalıştır

Bu öğreticinin 1. bölümünde, IoT cihazı kullanarak benzetim yapılacak bir cihaz ayarlarsınız. Henüz indirmediyseniz, bir IoT Hub 'ına cihazdan buluta iletiler gönderen cihazın benzetimini yapan .NET konsol uygulamasını indirin, buradan indirebilirsiniz.

Bu uygulama, farklı ileti yönlendirme yöntemlerinin her biri için iletiler gönderir. Ayrıca, indirme sırasında, tüm Azure Resource Manager şablon ve parametre dosyalarının yanı sıra Azure CLı ve PowerShell betikleri içeren bir klasör de vardır.

Bu öğreticinin 1. bölümünde yer almayan dosyaları depodan indirmediyseniz, şimdi IoT cihaz benzetiminegiderek indirin. Bu bağlantının seçilmesi, içindeki çeşitli uygulamalarla bir depoyu indirir; Aradığınız çözüm IoT-Hub/öğreticiler/yönlendirme/IoT_SimulatedDevice. sln ' dir.

kodu Visual Studio açmak için çözüm dosyasına (IoT_SimulatedDevice. sln) çift tıklayın, ardından Program. cs dosyasını açın. {your hub name} değerini IoT hub'ı konak adıyla değiştirin. IoT hub'ı konak adı {iot-hub-adı}.azure-devices.net biçimindedid. bu öğreticide, hub konak adı olarak ContosoTestHub.azure-devices.net kullanılır. Ardından, {your device key} değerini daha önce simülasyon cihazını ayarlarken kaydettiğiniz cihaz anahtarıyla değiştirin.

     static string s_myDeviceId = "Contoso-Test-Device";
     static string s_iotHubUri = "ContosoTestHub.azure-devices.net";
     // This is the primary key for the device. This is in the portal. 
     // Find your IoT hub in the portal > IoT devices > select your device > copy the key. 
     static string s_deviceKey = "{your device key}";

Çalıştırma ve test etme

Konsol uygulamasını çalıştırın. Birkaç dakika bekleyin. Uygulamanın konsol ekranında iletilerin gönderildiğini görebilirsiniz.

Uygulama, IoT hub'ına her saniye yeni bir cihazdan buluta iletisi gönderir. İleti, cihaz kimliği, sıcaklık, nem düzeyi ve ileti düzeyi (varsayılan normal değeriyle) bilgileriyle bir JSON seri hale getirilmiş nesnesi içerir. Buna rastgele olarak critical veya storage düzeyi atanır; bu, iletinin depolama hesabına veya Service Bus kuyruğuna (Mantıksal Uygulamanızı e-posta göndermesi için tetikler) yönlendirilmesine neden olur. Varsayılan ( normal ) readsler BIR bı raporunda görüntülenebilir.

Her şey düzgün ayarlandıysa, bu noktada aşağıdaki sonuçları görüyor olmalısınız:

1. Kritik iletilerle ilgili e-postalar almaya başlarsınız.

   

   Bu sonuç aşağıdaki deyimlerin doğru olduğu anlamına gelir.

   • Service Bus kuyruğunda yönlendirme düzgün çalışıyor.
   • İletiyi Service Bus kuyruğundan alan Mantıksal Uygulama düzgün çalışıyor.
   • Mantıksal Uygulama'nın Outlook bağlayıcısı düzgün çalışıyor.

2. Azure Portal, kaynak grupları ' nı seçin ve kaynak grubunuzu seçin. Bu öğreticide ContosoResources kullanılır.

   Depolama hesabını seçin, kapsayıcılar' ı seçin ve sonra sonuçlarınızı depolayan kapsayıcıyı seçin. Bu öğreticide contosoresults kullanılır. Bir klasör görüyor olmalısınız ve bir veya birden çok dosya görünceye kadar dizinlerde ayrıntıya gidebilirsiniz. Bu dosyalardan birini açın; depolama hesabına yönlendirilen girdileri içerir.

   

Bu sonuç, aşağıdaki deyimin doğru olduğu anlamına gelir.

• Depolama hesabına yapılan yönlendirme düzgün çalışıyor.

uygulamanın çalışmaya devam ettiğinden, varsayılan uç noktadan gelen iletileri görmek için Power BI görselleştirmesini ayarlayın.

Power BI görselleştirmelerini ayarlama

1. Power BI hesabınızda oturum açın.

2. Çalışma Alanım’ı seçin. Oluşturulan en az bir veri kümesini gösterir. Orada bir şey yoksa, daha fazla veri akışı için sanal cihaz uygulamasını başka bir 5-10 dakika boyunca çalıştırın. Çalışma alanı görüntülendikten sonra ContosoDataset adlı bir veri kümesi olur. Veri kümesi adının sağında yer alan üç dikey noktaya sağ tıklayın. Açılan listede rapor oluştur' u seçin.

   

3. Sağ taraftaki görselleştirmeler bölümüne BAKıN ve bı rapor sayfasında bir çizgi grafik seçmek için çizgi grafik ' i seçin. Alanı yatay olarak dolduracak şekilde grafiği sürükleyin. Şimdi sağ taraftaki alanlar bölümünde contosotable ' ı açın. Eventenqueuedutctime öğesini seçin. Bunu X eksenine koymanız gerekir. Sıcaklık ' ı seçin ve sıcaklık için değerler alanına sürükleyin. Bu, grafiğe sıcaklık ekler. Aşağıdaki grafik gibi görünen bir işlem olmalıdır:

   

4. Grafik alanının alt yarısında tıklayın. Çizgi grafiğini yeniden seçin. Birincisi bir grafik oluşturur.

5. Tabloda Eventqueuedtime' ı seçin, eksen alanına koyar. Nem değerini değerler alanına sürükleyin. Artık her iki grafiği de görürsünüz.

   

   Azure Stream Analytics IoT Hub varsayılan uç noktasından iletiler gönderdiniz. daha sonra, verileri göstermek için bir Power BI raporu eklediniz, sıcaklığın ve nem gösterilmesi için iki grafik ekleyebilirsiniz.

6. Raporu kaydetmek için dosya > kaydet ' i seçin, istendiğinde rapor için bir ad girersiniz. Raporunuzu çalışma alanınıza kaydedin.

Her iki grafikte de verileri görebileceksiniz. Bu sonuç aşağıdaki deyimlerin doğru olduğu anlamına gelir:

• Varsayılan uç noktaya yapılan yönlendirme düzgün çalışıyor.
• Azure Stream Analytics işi doğru akış yapıyor.
• Power BI Görselleştirmesi doğru ayarlanmış.

Power BI penceresinin en üstündeki yenile düğmesini seçerek en son verileri görmek için grafikleri yenileyebilirsiniz.

Kaynakları temizleme

Bu öğreticinin her iki bölümünde da oluşturduğunuz tüm Azure kaynaklarını kaldırmak istiyorsanız, kaynak grubunu silin. Bu eylem grubun içerdiği tüm kaynakları siler. Bu durumda IoT hub'ını, Service Bus ad alanıyla kuyruğunu, Mantıksal Uygulamayı, depolama hesabını ve kaynak grubunun kendisini kaldırır. ayrıca, Power BI kaynaklarını kaldırabilir ve öğretici sırasında gönderilen e-postaları temizleyebilirsiniz.

Power BI görselleştirmesinde kaynakları temizleme

Power BI hesabınızda oturum açın. Çalışma alanınıza gidin. Bu öğreticide My Workspace kullanılır. Power BI görselleştirmesini kaldırmak için veri kümeleri ' ne gidin ve veri kümesini silmek için çöp kutusu simgesini seçin. Bu öğreticide contosodataset kullanılır. Veri kümesini kaldırdığınızda, rapor da kaldırılır.

Azure CLı kullanarak kaynakları Temizleme

Kaynak grubunu kaldırmak için az group delete komutunu kullanın. $resourceGroup Bu öğreticinin başlangıcında Contosoresources olarak yeniden ayarlandı.

az group delete --name $resourceGroup

Kaynakları temizlemek için PowerShell 'i kullanma

Kaynak grubunu kaldırmak için Remove-AzResourceGroup komutunu kullanın. $resourceGroup Bu öğreticinin başlangıcında Contosoresources olarak yeniden ayarlandı.

Remove-AzResourceGroup -Name $resourceGroup

Sınama e-postalarını temizle

Ayrıca, gelen kutunuzda, cihaz uygulaması çalışırken mantıksal uygulama aracılığıyla oluşturulan e-posta miktarını da silmek isteyebilirsiniz.

Sonraki adımlar

Bu iki bölümden oluşan öğreticide, aşağıdaki görevleri gerçekleştirerek farklı hedeflere IoT Hub iletileri yönlendirmek üzere ileti yönlendirmeyi nasıl kullanacağınızı öğrendiniz.

Bölüm ı: kaynak oluşturma, ileti yönlendirmeyi ayarlama

Bölüm II: hub 'a ileti gönderme, yönlendirilmiş sonuçları görüntüleme

IoT cihazı durumunun nasıl yönetileceğini öğrenmek için sonraki öğreticiye geçin.