Öğretici: Event Grid ve Logic Apps kullanarak Azure IoT Hub olayları hakkında e-posta bildirimleri gönderme

Azure Event Grid, aşağı akış iş uygulamalarınızda eylemler tetikleyerek IoT Hub'daki olaylara karşılık vermenize olanak tanır.

Bu makalede IoT Hub ve Event Grid kullanan bir örnek yapılandırma gösterilmektedir. Son olarak, bir cihaz IoT Hub 'ınıza her bağlanıp bağlantısı kesildiğinde bir bildirim e-postası gönderecek şekilde ayarlanmış bir Azure mantıksal uygulamanız vardır. Event Grid, bağlantının kesilmesi için zamanında bildirim almak üzere kullanılabilir. Ölçümler ve Tanılamalar birkaç sürebilir (yani, 20 veya daha fazla), günlüklerde/uyarılarda göstermek için dakikalar içinde bir sayı koymak istemezsiniz. Bu, kritik altyapı için kabul edilemez olabilir.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

• Office 365 Outlook veya Outlook.com gibi Azure Logic Apps tarafından desteklenen herhangi bir e-posta sağlayıcısından bir e-posta hesabı. Bu e-posta hesabı olay bildirimlerini göndermek için kullanılır.

• Azure Cloud Shell'Da Bash ortamını kullanın.

  

• Dilerseniz CLI başvuru komutlarını çalıştırmak için Azure CLI’yi yükleyebilirsiniz.

  • 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. Ek oturum açma seçenekleri için bkz. Azure CLI ile oturum açma.

  • İstendiğinde, ilk kullanımda Azure CLI uzantıları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.

IoT hub oluşturma

Portalda Azure Cloud Shell terminali kullanarak hızlı bir şekilde yeni bir IoT Hub oluşturabilirsiniz.

1. Azure portalında oturum açın.

2. Sayfanın sağ üst köşesinde Cloud Shell düğmesini seçin.

   

3. Yeni bir kaynak grubu oluşturmak için şu komutu çalıştırın:

   az group create --name {your resource group name} --location westus
   

4. IoT Hub 'ı oluşturmak için aşağıdaki komutu çalıştırın:

   az iot hub create --name {your iot hub name} --resource-group {your resource group name} --sku S1 
   

5. Cloud Shell terminalini en aza indirin. Öğreticinin ilerleyen kısımlarında daha sonra Shell 'e geri döneceksiniz.

Mantıksal uygulama oluşturma

Ardından, bir Logic App oluşturun ve IoT Hub 'ından istekleri işleyen bir HTTP Event Grid tetikleyicisi ekleyin.

Mantıksal uygulama kaynağı oluşturma

1. Azure Portal, kaynak oluştur' u seçin, sonra arama kutusuna "Logic App" yazın ve geri dön ' ü seçin. Sonuçlardan Logic App ' i seçin.

   

2. Sonraki ekranda Oluştur' u seçin.

3. Mantıksal uygulamanıza aboneliğiniz içinde benzersiz olan bir ad verin, ardından IoT Hub'ınızla aynı aboneliği, kaynak grubunu ve konumu seçin.

   

4. Gözden geçir ve oluştur’u seçin.

5. Ayarlarınızı doğrulayın ve ardından Oluştur' u seçin.

6. Kaynak oluşturulduktan sonra Kaynağa Git' i seçin.

7. Logic Apps tasarımcısında, şablonları görmek için sayfayı aşağı kaydırın. Mantıksal uygulamanızı sıfırdan oluşturabilmeniz için boş mantıksal uygulama ' yı seçin.

Tetikleyici seçme

Tetikleyici, mantıksal uygulamanızı başlatan belirli bir olaydır. Bu öğreticide, iş akışını başlatan tetikleyici HTTP üzerinden bir istek alır.

1. Bağlayıcılar ve tetikleyiciler arama çubuğunda HTTP yazın.

2. Sonuçlarda ilerleyin ve Istek ' ı seçin. tetikleyici olarak BIR http isteği alındığında .

   

3. Şema oluşturmak için örnek yük kullanma öğesini seçin.

   

4. Cihaza bağlı olay şeması JSON 'sini metin kutusuna yapıştırın, sonra bitti' yi seçin:

     [{  
      "id": "f6bbf8f4-d365-520d-a878-17bf7238abd8",
      "topic": "/SUBSCRIPTIONS/<subscription ID>/RESOURCEGROUPS/<resource group name>/PROVIDERS/MICROSOFT.DEVICES/IOTHUBS/<hub name>",
      "subject": "devices/LogicAppTestDevice",
      "eventType": "Microsoft.Devices.DeviceConnected",
      "eventTime": "2018-06-02T19:17:44.4383997Z",
      "data": {
          "deviceConnectionStateEventInfo": {
            "sequenceNumber":
              "000000000000000001D4132452F67CE200000002000000000000000000000001"
          },
        "hubName": "egtesthub1",
        "deviceId": "LogicAppTestDevice",
        "moduleId" : "DeviceModuleID"
      }, 
      "dataVersion": "1",
      "metadataVersion": "1"
    }]
   

   Bu olay bir cihaz IoT Hub 'ına bağlandığında yayınlar.

Eylem oluşturma

Eylemler, tetikleyici mantıksal uygulama iş yükünü başlattıktan sonra gerçekleşen adımlardır. Bu öğreticide, e-posta sağlayıcınızdan bir e-posta bildirimi gönderme eylemi kullanılır.

1. Yeni adım'ı seçin. Bu işlem, bir eylemi seçmek için bir pencere açar.

2. Outlook için arama yapın.

3. E-posta sağlayıcınıza uygun bağlayıcıyı bulun ve seçin. Bu öğretici Outlook.com kullanır. Diğer e-posta sağlayıcılarının adımları da bunlara benzer.

   

4. E-posta gönder (v2) eylemini seçin.

5. Oturum aç ' ı seçin ve e-posta hesabınızda oturum açın. Uygulamanın bilgilerinize erişmesine izin vermek için Evet ' i seçin.

6. E-posta şablonunuzu oluşturun.

   • Kime: Bildirim e-postalarını alacak e-posta adresini girin. Bu öğreticide, test için erişebileceğiniz bir e-posta hesabı kullanın.

   • Konu: Konunun metnini girin. Konu metin kutusuna tıkladığınızda, içerilecek dinamik içerik ' i seçebilirsiniz. Örneğin, bu öğretici kullanır IoT Hub alert: {eventType} . Dinamik içeriği göremiyorsanız, dinamik Içerik Ekle köprüsünü seçin--Bu, açıp kapatır.

   • Gövde: E-postanız için metni yazın. Olay verilerine göre dinamik içerik eklemek için seçici aracından JSON özelliklerini seçin. Dinamik içeriği göremiyorsanız gövde metin kutusu altında dinamik içerik Ekle köprüsünü seçin. İstediğiniz alanları göstermezse, önceki eylemden alanları dahil etmek için dinamik içerik ekranında daha fazla ' ya tıklayın.

   E-posta şablonunuz, aşağıdaki örneğe benzer görünebilir:

   

7. Logic Apps Tasarımcısı’nda Kaydet’i seçin.

HTTP URL'sini kopyalama

Logic Apps Tasarımcısı'ndan çıkmadan önce, mantıksal uygulamalarınızın tetikleyici için dinlediği URL'yi kopyalayın. Bu URL'yi, Event Grid'i yapılandırmak için kullanırsınız.

1. Bir HTTP isteği alındığında tetikleyici yapılandırma kutusunu tıklayarak genişletin.

2. Yanındaki kopyala düğmesini seçerek HTTP POST URL değerini kopyalayın.

   

3. Sonraki bölümde başvurabilmek için bu URL'yi saklayın.

IoT Hub olayları için aboneliği yapılandırma

Bu bölümde, IoT Hub'ınızı gerçekleşen olayları yayımlamak için yapılandıracaksınız.

1. Azure portalında IoT Hub'ınıza gidin. Bunu, kaynak grupları' nı seçerek ve ardından Bu öğreticinin kaynak grubunu seçip kaynak listesinden IoT Hub 'ınızı seçerek yapabilirsiniz.

2. Olaylar'ı seçin.

   

3. Olay aboneliği’ni seçin.

   

4. Olay aboneliğini aşağıdaki değerlerle oluşturun:

   1. OLAY ABONELİK AYRINTILARI bölümünde:

      1. Olay aboneliği için bir ad sağlayın.
      2. Olay şeması Için Event Grid şeması ' nı seçin.

   2. KONU AYRINTILARI bölümünde:

      1. Konu türü'nün IoT Hub olarak ayarlandığını doğrulayın.
      2. IoT hub adının Kaynak alanındaki değer olarak ayarlandığını doğrulayın.
      3. Sizin için oluşturulacak Sistem konusu için bir ad girin. Sistem konuları hakkında bilgi edinmek için bkz. sistem konularına genel bakış.

   3. OLAY TÜRLERİ bölümünde:

      1. Olay Türlerine Filtrele açılan menüsünü seçin.

      2. Oluşturulan Cihaz ve cihaz bağlantısı kesildi onay kutularını seçili bırakarak yalnızca cihaz bağlı ve cihaz bağlantısı kesilen cihazların seçimini kaldırın.

         

   4. UÇ NOKTA AYRINTILARI bölümünde:

      1. Uç nokta türünü Web kancası olarak seçin.
      2. Bir uç nokta seçin'i seçin ve mantıksal uygulamanızdan kopyaladığınız URL’yi yapıştırıp seçimi onaylayın.

      

      İşiniz bittiğinde, bölme aşağıdaki örnekteki gibi görünmelidir:

      

5. Oluştur’u seçin.

Telemetriyi bağlayan yeni bir cihazın benzetimini yapın

Azure CLı kullanarak bir cihaz bağlantısını hızla taklit ederek mantıksal uygulamanızı test edin.

1. Terminalinizi yeniden açmak için Cloud Shell düğmesini seçin.

2. Sanal cihaz kimliği oluşturmak için aşağıdaki komutu çalıştırın:

   az iot hub device-identity create --device-id simDevice --hub-name {YourIoTHubName}
   

3. IoT Hub ve Telemetriyi göndermek için cihazınızın bağlanmasına benzetim yapmak üzere aşağıdaki komutu çalıştırın:

   az iot device simulate -d simDevice -n {YourIoTHubName}
   

4. Sanal cihaz IoT Hub bağlandığında, size bir "DeviceConnected" olayı bildiren bir e-posta gönderilir.

5. Simülasyon tamamlandığında, size "DeviceConnected bağlantısı kesilen" bir olay bildiren bir e-posta gönderilir.

   

Kaynakları temizleme

Bu öğreticide Azure aboneliğinize ücret uygulanmasına neden olan kaynaklar kullanılmıştır. Öğreticiyi denemeyi ve sonuçlarınızı test etmeyi tamamladığınızda, saklamak istemediğiniz kaynakları devre dışı bırakın veya silin.

Bu öğreticide oluşturulan tüm kaynakları silmek için kaynak grubunu silin.

1. Kaynak grupları' nı seçin ve ardından Bu öğretici için oluşturduğunuz kaynak grubunu seçin.

2. Kaynak grubu bölmesinde kaynak grubunu sil' i seçin. Kaynak grubu adını girmeniz istenir ve ardından onu silebilirsiniz. İçinde bulunan tüm kaynaklar da kaldırılır.

Sonraki adımlar

• Event Grid kullanıp olayları tetikleyerek IoT Hub'ı olaylarına tepki verme hakkında daha fazla bilgi edinin.
• Cihazla bağlantılı ve bağlantısız olayları nasıl sıralayacağınızı öğrenin
• Event Grid ile başka neler yapabileceğinizi öğrenin.

Desteklenen mantıksal uygulama bağlayıcılarının tüm listesi için bkz.