Öğretici: MQTT iletilerini Azure Event Hubs'a yönlendirmek için ad alanı konularını kullanma (Azure portalı)

Bu öğreticide, MQTT istemcilerindeki verileri Azure Event Hubs'a yönlendirmek için ad alanı konusunu kullanmayı öğreneceksiniz. Üst düzey adımlar şunlardır:

Önkoşullar

  • Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir Azure hesabı oluşturun.
  • Event Grid'i kullanmaya yeni başladıysanız, bu öğreticiye başlamadan önce Event Grid'e genel bakış'ı okuyun.
  • Event Grid kaynak sağlayıcısını Event Grid kaynak sağlayıcısını kaydetme başlığı altındaki adımlara göre kaydedin.
  • Güvenlik duvarınızda 8883 numaralı bağlantı noktasının açık olduğundan emin olun. Bu öğreticideki örnek, 8883 numaralı bağlantı noktası üzerinden iletişim kuran MQTT protokolunu kullanır. Bu bağlantı noktası bazı kurumsal ve eğitim ağı ortamlarında engellenebilir.

Azure portalında bir ad alanı oluşturma

Azure Event Grid'deki ad alanı, bir veya daha fazla konu, istemci, istemci grubu, konu alanı ve izin bağlaması için mantıksal bir kapsayıcıdır. Aynı Azure bölgesinde birden çok kaynağınız olmasını sağlayan benzersiz bir ad alanı sağlar. Azure Event Grid ad alanıyla artık ilgili kaynakları birlikte gruplandırabilir ve Bunları Azure aboneliğinizde tek bir birim olarak yönetebilirsiniz.

Azure Event Grid ad alanı oluşturmak, görüntülemek ve yönetmek için lütfen sonraki bölümleri izleyin.

Ad alanı oluşturmak için:

  1. Azure portalda oturum açın.

  2. Arama kutusuna Event Grid Ad Alanları yazın ve sonuçlardan Event Grid Ad Alanları'nı seçin.

    Arama sonuçlarında Event Grid Ad Alanlarını gösteren ekran görüntüsü.

  3. Event Grid Ad Alanları sayfasında araç çubuğunda + Oluştur'u seçin.

    Araç çubuğunda Oluştur düğmesinin seçili olduğu Event Grid Ad Alanları sayfasını gösteren ekran görüntüsü.

  4. Temel Bilgiler sayfasında şu adımları izleyin.

    1. Ad alanını oluşturmak istediğiniz Azure aboneliğini seçin.

    2. Mevcut bir kaynak grubunu seçin veya bir kaynak grubu oluşturun.

    3. Ad alanı için bir ad girin.

    4. Ad alanını oluşturmak istediğiniz bölgeyi veya konumu seçin.

    5. Sayfanın alt kısmındaki Gözden geçir ve oluştur'u seçin.

      Ad alanı oluştur sayfasının Temel bilgiler sekmesini gösteren ekran görüntüsü.

  5. Gözden Geçir ve oluştur sekmesinde ayarlarınızı gözden geçirin ve Oluştur'u seçin.

  6. Dağıtım başarılı sayfasında Kaynağa git'i seçerek ad alanınıza gidin.

Ad alanı konusu oluşturma

  1. Event Grid Ad Alanı sayfasında değilseniz, konuyu oluşturmak için kullanmak istediğiniz ad alanını görüntülemek için ad alanlarını oluşturma, görüntüleme ve yönetme adımlarını izleyin.

  2. Event Grid Ad Alanı sayfasında, soldaki menünün Olay bölümünde Konular seçeneğini belirleyin.

  3. Konular sayfasında, komut çubuğunda + Konu düğmesini seçin.

    Event Grid ad alanı konu oluşturma işlemini gösteren ekran görüntüsü.

  4. Konu Oluştur sayfasında, oluşturmak istediğiniz konunun adını yazın ve Oluştur'u seçin.

    Event Grid ad alanı konu oluşturmayla ilgili temel bilgileri gösteren ekran görüntüsü.

Event Grid ad alanı için yönetilen kimliği etkinleştirme

  1. Event Grid Ad Alanı sayfasında, soldaki menüden Ayarlar altında Kimlik'i seçin.

  2. Sistem tarafından atanan yönetilen kimliği etkinleştirmek için anahtarı açın.

  3. Ayarı kaydetmek için araç çubuğunda Kaydet'i seçin.

    Event Grid ad alanı için sistem tarafından atanan kimlik sayfasının ekran görüntüsü.

  4. Onay iletisinde Evet'i seçin.

  5. Sistem tarafından atanan yönetilen kimliğin nesne kimliğini gördüğünüzden emin olun ve rol atama bağlantısını görün.

    Ad alanına kimlik atama işleminin tamamlandığını gösteren ekran görüntüsü.

    Yönetilen kimliğin ad alanı için etkinleştirildiğini onaylamak için portaldaki bildirimleri denetleyin.

Event Grid ad alanı için MQTT aracısını etkinleştirme

  1. Event Grid Ad Alanı sayfasında, soldaki menüden Ayarlar altında Yapılandırma'yı seçin.

  2. MQTT aracısını etkinleştir'in yanındaki onay kutusunu seçin.

  3. Sayfanın alt kısmındaki Uygula'yı seçin.

    MQTT'yi etkinleştirmek için Event Grid ad alanı yapılandırma sayfasını gösteren ekran görüntüsü.

    Ad alanı için MQTT aracısının etkinleştirildiğini onaylamak için portaldaki bildirimleri denetleyin.

Web tarayıcısının ayrı bir sekmesinde veya ayrı bir pencerede Azure portalını kullanarak olay hub'ı içeren bir Event Hubs ad alanı oluşturun.

Event Hubs ad alanı oluşturma

Event Hubs ad alanı, içinde bir veya daha fazla olay hub'ı oluşturduğunuz benzersiz bir kapsam kapsayıcısı sağlar. Portalı kullanarak kaynak grubunuzda bir ad alanı oluşturmak için aşağıdaki eylemleri gerçekleştirin:

  1. Azure portalında soldaki menüden Tüm hizmetler'i seçin ve Analiz kategorisinde Event Hubs'ınyanındaki yıldız (*) öğesini seçin. Event Hubs'ın sol gezinti menüsünde sık kullanılanlara eklendiğini onaylayın.

    Tüm hizmetler sayfasında Event Hubs seçimini gösteren ekran görüntüsü.

  2. Sol gezinti menüsünde sık kullanılanlar'ın altında Event Hubs'ı seçin ve araç çubuğunda Oluştur'u seçin.

    Olay hub'ları sayfasındaki Oluştur düğmesinin seçimini gösteren ekran görüntüsü.

  3. Ad alanı oluştur sayfasında aşağıdaki adımları izleyin:

    1. Ad alanını oluşturmak istediğiniz aboneliği seçin.

    2. Önceki adımda oluşturduğunuz kaynak grubunu seçin.

    3. Ad alanı için bir ad girin. Adın kullanılabilirliği sistem tarafından hemen denetlenir.

    4. Ad alanı için bir konum seçin.

    5. Fiyatlandırma katmanı için Temel'i seçin. Apache Kafka uygulamalarından ad alanını kullanmayı planlıyorsanız Standart katmanını kullanın. Temel katman Apache Kafka iş yüklerini desteklemez. Katmanlar arasındaki farklar hakkında bilgi edinmek için bkz . Kotalar ve sınırlar, Event Hubs Premium ve Event Hubs Ayrılmış makaleleri.

    6. Aktarım hızı birimleri (standart katman için) veya işlem birimleri (premium katman için) ayarlarını olduğu gibi bırakın. Aktarım hızı birimleri veya işleme birimleri hakkında bilgi edinmek için: Event Hubs ölçeklenebilirliği.

    7. Sayfanın alt kısmındaki Gözden Geçir + Oluştur'u seçin.

      Azure portalında Ad Alanı Oluştur sayfasının ekran görüntüsü.

    8. Gözden Geçir + Oluştur sayfasında ayarları gözden geçirin ve Oluştur'u seçin. Dağıtımın tamamlanmasını bekleyin.

  4. Dağıtım sayfasında Kaynağa git'i seçerek ad alanınızın sayfasına gidin.

    Kaynağın bağlantısını içeren Dağıtım tamamlandı sayfasının ekran görüntüsü.

  5. Event Hubs Ad Alanı sayfasını aşağıdaki örneğe benzer şekilde gördüğünüzden emin olun:

    Azure portalında Event Hubs ad alanınızın giriş sayfasının ekran görüntüsü.

Olay hub’ı oluşturma

Ad alanında bir olay hub'ı oluşturmak için aşağıdaki eylemleri gerçekleştirin:

  1. Genel Bakış sayfasında, komut çubuğunda + Olay hub'ı seçin.

    Komut çubuğundaki Olay hub'ı ekle düğmesinin seçiminin ekran görüntüsü.

  2. Olay hub'ınız için bir ad yazın, ardından Gözden geçir ve oluştur'u seçin.

    Olay hub'ı oluştur sayfasının ekran görüntüsü.

  3. Gözden Geçir + oluştur sayfasında Oluştur'u seçin.

  4. Uyarılarda olay hub'ı oluşturma durumunu de kontrol edebilirsiniz. Olay hub'ı oluşturulduktan sonra olay hub'ları listesinde görürsünüz.

    Olay hub'larının listesini gösteren ekran görüntüsü.

Event Grid ad alanına olay hub'ına olay gönderme erişimi verme

  1. Event Hubs Ad Alanı sayfasında, soldaki menüden Erişim denetimi (IAM) öğesini seçin.

  2. Erişim denetimi sayfasında, komut çubuğunda + Ekle'yi ve ardından Rol ataması ekle'yi seçin.

    Event Hubs ad alanının Erişim denetim sayfasını gösteren ekran görüntüsü.

  3. Rol ataması ekle sayfasında, rol listesinden Azure Event Hubs Veri Göndereni'ni seçin ve ardından sayfanın alt kısmındaki İleri'yi seçin.

    Azure Event Hubs Veri Göndereni'nin seçili olduğu Rol ataması ekle sayfasını gösteren ekran görüntüsü.

  4. Üyeler sayfasında şu adımları izleyin:

    1. Erişim ata alanı için Yönetilen kimlik'i seçin.

    2. + Üye seç'i seçin.

      Yönetilen kimliğin seçili olduğu Rol ataması ekle sayfasını gösteren ekran görüntüsü.

  5. Yönetilen kimlikleri seçin sayfasında şu adımları izleyin:

    1. Azure aboneliğinizi seçin.

    2. Yönetilen kimlik için Event Grid Ad Alanı'yı seçin.

    3. Event Grid ad alanıyla aynı ada sahip yönetilen kimliği seçin.

    4. Sayfanın alt kısmındaki Seç'i seçin.

      Event Grid ad alanının yönetilen kimliğinin seçili olduğu Yönetilen kimlikleri seç sayfasını gösteren ekran görüntüsü.

  6. Rol ataması ekle sayfasında, sayfanın alt kısmındaki Gözden geçir ve ata'yı seçin.

  7. Gözden geçir ve ata sayfasında Gözden geçir ve ata'yı seçin.

Event Hubs ile uç nokta olarak olay aboneliği oluşturma

  1. Event Grid ad alanının açık olduğu Web tarayıcısı pencerenizin sekmesine geçin.

  2. Event Grid Ad Alanı sayfasında soldaki menüden Konular'ı seçin.

  3. Konular sayfasında, daha önce oluşturduğunuz ad alanı konusunu seçin.

    Ad alanı konusunun seçili olduğu Konular sayfasını gösteren ekran görüntüsü.

  4. Event Grid Ad Alanı Konusu sayfasında, üstteki komut çubuğunda + Abonelik'i seçin.

    Abonelikler sayfasını gösteren ekran görüntüsü.

  5. Abonelik Oluştur sayfasında şu adımları izleyin:

    1. Olay aboneliği için bir ad girin.

    2. Teslim modu için Gönder'i seçin.

    3. Uç nokta türünün Olay hub'ı olarak ayarlandığını onaylayın.

    4. Uç nokta yapılandır'ı seçin.

      Abonelik Oluştur sayfasını gösteren ekran görüntüsü.

    5. Olay Hub'ı Seçin'de şu adımları izleyin:

      1. Olay hub'ını içeren Azure aboneliğini seçin.

      2. Olay hub'ına sahip kaynak grubunu seçin.

      3. Event Hubs ad alanını seçin.

      4. Event Hubs ad alanında olay hub'ını seçin.

      5. Ardından Seçimi onayla'yı seçin.

        Olay hub'ını seçin sayfasını gösteren ekran görüntüsü.

    6. Abonelik Oluştur sayfasına dönüp Yönetilen kimlik türü için Sistem Atanan'ı seçin.

    7. Sayfanın alt kısmındaki Oluştur'u seçin.

      Oluştur düğmesinin seçili olduğu Abonelik Oluştur sayfasını gösteren ekran görüntüsü.

Event Grid ad alanında yönlendirmeyi yapılandırma

  1. Event Grid Ad Alanı Konusunun Temel Parçalar bölümünden ad alanını seçerek veya üstteki içerik haritası menüsünde ad alanı adını seçerek Event Grid Ad Alanı sayfasına geri dönün.

  2. Event Grid Ad Alanı sayfasında, MQTT aracısı bölümündeki sol menüden Yönlendirme'yi seçin.

  3. Yönlendirme sayfasında Yönlendirmeyi etkinleştir'i seçin.

  4. Konu türü için Ad alanı konusu'nü seçin.

  5. Konu başlığı için, oluşturduğunuz ve tüm MQTT iletilerinin yönlendirileceği Event Grid ad alanı konusunu seçin.

  6. Uygula’yı seçin.

    Ad alanı konusunun seçili olduğu Yönlendirme sayfasını gösteren ekran görüntüsü.

    Yönlendirme bilgileriyle birlikte ad alanının etkinleştirildiğini onaylamak için bildirimleri denetleyin.

İstemciler, konu alanı ve izin bağlamaları oluşturma

Hızlı başlangıçtaki adımları izleyin: MQTT konusunda yayımlama ve abone olma:

  1. İstemci oluşturma. İsterseniz ikinci istemciyi oluşturabilirsiniz, ancak isteğe bağlıdır.

  2. Konu alanı oluşturun.

  3. Yayımcı ve abone izin bağlamaları oluşturun.

  4. Birkaç ileti göndermek için MQTTX kullanın.

  5. Olay hub'ınızın bu iletileri Event Hubs ad alanınızın Genel Bakış sayfasında aldığını doğrulayın.

    Gelen ileti sayısıyla olay hub'ının Genel Bakış sayfasını gösteren ekran görüntüsü.

Stream Analytics sorgusu kullanarak Event Hubs'da yönlendirilmiş MQTT iletilerini görüntüleme

Azure portalında olay aboneliğinizde Event Hubs örneğine (olay hub'ı) gidin. Stream Analytics'i kullanarak olay hub'ınızdaki verileri işleyin. Daha fazla bilgi için bkz . Stream Analytics kullanarak Azure Event Hubs'dan veri işleme - Azure Event Hubs | Microsoft Learn. Sorguda MQTT iletilerini görebilirsiniz.

Stream Analytics sorgu aracını kullanarak Event Hubs'daki MQTT iletileri verilerini gösteren ekran görüntüsü.

Sonraki adımlar

Kod örnekleri için bu GitHub deposuna gidin.