Hızlı Başlangıç: Bir cihazdan IoT hub'a telemetri gönderme ve Azure CLI ile izleme

IoT Hub, IoT cihazlarınızdan buluta depolama veya işleme amacıyla yüksek hacimlerde telemetri almanızı sağlayan bir Azure hizmetidir. Bu hızlı başlangıçta Azure CLI kullanarak bir IoT Hub ve simülasyon cihazı oluşturacak, cihaz telemetrisini hub'a gönderecek ve buluttan cihaza ileti göndereceksiniz. Cihaz ölçümlerini görselleştirmek için Azure portal de kullanabilirsiniz. Bu, bir uygulamayla etkileşim kurmak için CLI kullanan geliştiriciler için temel IoT Hub iş akışıdır.

Önkoşullar

• Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir abonelik oluşturun.
• Azure CLI. Tarayıcınızda çalışan etkileşimli bir CLI kabuğu olan Azure Cloud Shell kullanarak bu hızlı başlangıçtaki tüm komutları çalıştırabilirsiniz. Cloud Shell kullanıyorsanız herhangi bir şey yüklemenize gerek yok. CLI'yi yerel olarak kullanmayı tercih ederseniz bu hızlı başlangıç için Azure CLI 2.0.76 veya sonraki bir sürümü gerekir. Sürümü bulmak için az --version komutunu çalıştırın. Yüklemek veya yükseltmek için bkz. Azure CLI’yı yükleme.

Azure portalında oturum açın

https://portal.azure.com adresinden Azure portalında oturum açın.

CLI'sini yerel olarak veya yerel Cloud Shell bakılmaksızın, tarayıcınızda portalı açık tutabilirsiniz. Bu hızlı başlangıçta daha sonra kullanacağız.

Uygulamayı Cloud Shell

Bu bölümde, uygulamanın bir örneğini Azure Cloud Shell. CLI'i yerel olarak kullanıyorsanız İki CLI oturumu hazırlama bölümüne atlayabilirsiniz.

Uygulamayı başlatmak Cloud Shell:

1. Sağ Cloud Shell menü çubuğundaki Azure portal.

   

   Not

   İlk kez kullanıyorsanız Cloud Shell depolama alanı oluşturmanızı Cloud Shell. Depolama hesabı oluşturmak ve Dosyalar paylaşımını Microsoft Azure seçin.

2. Ortam seçin açılan listesinde tercih ettiğiniz CLI ortamını seçin. Bu hızlı başlangıç Bash ortamını kullanır. Aşağıdaki CLI komutlarının hepsi PowerShell ortamında da çalışır.

   

İki CLI oturumu hazırlama

Bu bölümde iki Azure CLI oturumu hazırlayacaksiniz. Cloud Shell kullanıyorsanız iki oturumu ayrı tarayıcı sekmelerinde çalıştırabilirsiniz. Yerel BIR CLI istemcisi kullanıyorsanız iki ayrı CLI örneği çalıştıracaksanız. İlk oturumu simülasyon cihazı olarak, ikinci oturumu ise iletileri izleyecek ve gönderebilirsiniz. Bir komutu çalıştırmak için Kopyala'ya seçerek bu hızlı başlangıçtaki kod bloğunu kopyalayın, kabuk oturuma yapıştırın ve çalıştırın.

Azure CLI, Azure hesabınızla oturum açmanızı gerektirir. Azure CLI kabuk oturumunuzla IoT hub'ınız arasındaki tüm iletişimlerin kimliği doğrulanır ve şifrelenir. Sonuç olarak, bu hızlı başlangıçta bağlantı dizesi gibi gerçek bir cihazla kullanabileceğiniz ek kimlik doğrulamasına gerek olmaz.

• Azure CLI için IoT Uzantısı'Microsoft Azure CLI kabuğuna eklemek için az extension add komutunu çalıştırın. IOT Uzantısı, IoT Hub, IoT Edge ve IoT Cihaz Sağlama Hizmeti (DPS) komutlarını Azure CLI'ye ekler.

  az extension add --name azure-iot
  

  Azure IOT uzantısını yükledikten sonra herhangi bir oturumda yeniden yüklemeniz Cloud Shell.

  Not

  Bu makalede, adlı Azure IoT uzantısının en yeni sürümü kullanılmıştır azure-iot . Eski sürüm çağrılır azure-cli-iot-ext . Aynı anda yalnızca bir sürümü yüklü olmalıdır. az extension listŞu anda yüklü olan uzantıları doğrulamak için komutunu kullanabilirsiniz.

  az extension remove --name azure-cli-iot-extUzantının eski sürümünü kaldırmak için kullanın.

  az extension add --name azure-iotUzantının yeni sürümünü eklemek için kullanın.

  Yüklediğiniz uzantıları görmek için kullanın az extension list .

• İkinci bir CLI oturumu açın. Oturum açma Cloud Shell Aç'ı seçin. CLI'ı yerel olarak kullanıyorsanız ikinci bir örnek açın.

  

IoT Hub'ı oluşturma

Bu bölümde, azure CLI kullanarak bir kaynak grubu ve bir kaynak grubu IoT Hub. Azure kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. Bir IoT Hub, IoT uygulamanız ve cihazlar arasında çift yönlü iletişim için merkezi bir ileti hub'ı olarak çalışır.

1. Kaynak grubu oluşturmak için az group create komutunu çalıştırın. Aşağıdaki komut eastus konumda MyResourceGroup adlı bir kaynak grubu oluşturur.

   az group create --name MyResourceGroup --location eastus
   

2. IoT hub'ı oluşturmak için az iot hub create komutunu çalıştırın. IoT hub'ı oluşturmak birkaç dakika sürebilir.

   YourIotHubName. Aşağıdaki yer tutucusunu IoT hub'nız için seçtiğiniz adla değiştirin. IoT hub'ı adının Azure'da genel olarak benzersiz olması gerekir. Bu yer tutucu, bu hızlı başlangıç metninin geri kalanında IoT hub'nizin adını temsil etmek için kullanılır.

   az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
   

Cihaz oluşturma ve izleme

Bu bölümde, ilk CLI oturumunda bir simülasyon cihazı oluşturabilirsiniz. Simülasyon cihazı, cihaz telemetrisini IoT hub'ınıza gönderir. İkinci CLI oturumunda olayları ve telemetrileri izleyecek ve simülasyon cihazına buluttan cihaza ileti göndereceksiniz.

Sanal cihaz oluşturmak ve başlatmak için:

1. İlk CLI oturumunda az iot hub device-identity create komutunu çalıştırın. Bu, sanal cihaz kimliğini oluşturur.

   YourIotHubName. Aşağıdaki yer tutucusunu IoT hub'nız için seçtiğiniz adla değiştirin.

   simDevice. Bu hızlı başlangıçların geri kalanında bu adı doğrudan simülasyon cihazı için kullanabilirsiniz. İsteğe bağlı olarak farklı bir ad kullanın.

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

2. İlk CLI oturumunda az iot device simulate komutunu çalıştırın. Bu, simülasyon cihazı başlatır. Cihaz, IoT hub'ınıza telemetri gönderir ve bu hub'dan iletiler alır.

   YourIotHubName. Aşağıdaki yer tutucusunu IoT hub'nız için seçtiğiniz adla değiştirin.

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

Bir cihazı izlemek için:

1. İkinci CLI oturumunda az iot hub monitor-events komutunu çalıştırın. Bu, simülasyon cihazı izlemeye başlar. Çıktı, simülasyon cihazın IoT hub'ını gönderdiği telemetri verileri gösterir.

   YourIotHubName. Aşağıdaki yer tutucusunu IoT hub'nız için seçtiğiniz adla değiştirin.

   az iot hub monitor-events --output table --hub-name {YourIoTHubName}
   

   

2. İkinci CLI oturumunda sanal cihazı izledikten sonra, izlemeyi durdurmak için Ctrl+C tuşlarına basın.

İleti göndermek için CLI kullanma

Bu bölümde ikinci CLI oturumunu kullanarak simülasyon cihazına ileti göndereceksiniz.

1. İlk CLI oturumunda, simülasyon cihazın çalıştırıldıklarını onaylayın. Cihaz durdurulduktan sonra başlatmak için aşağıdaki komutu çalıştırın:

   YourIotHubName. Aşağıdaki yer tutucusunu IoT hub'nız için seçtiğiniz adla değiştirin.

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

2. İkinci CLI oturumunda az iot device c2d-message send komutunu çalıştırın. Bu, IoT hub'ınıza sanal cihaza buluttan cihaza bir ileti gönderir. İleti bir dize ve iki anahtar-değer çifti içerir.

   YourIotHubName. Aşağıdaki yer tutucusunu IoT hub'nız için seçtiğiniz adla değiştirin.

   az iot device c2d-message send -d simDevice --data "Hello World" --props "key0=value0;key1=value1" -n {YourIoTHubName}
   

   İsteğe bağlı olarak, buluttan cihaza iletileri göndermek için Azure portal. Bunu yapmak için, uygulamanıza ilişkin genel bakış sayfasına IoT Hub IoT Cihazları'ı seçin, sanal cihazı seçin ve Cihaza İleti gönder'i seçin.

3. İlk CLI oturumunda, sanal cihazın iletiyi aldıklarını onaylayın.

   

4. İletiyi görüntüledikten sonra ikinci CLI oturumunu kapatın. İlk CLI oturumunu açık tut. Sonraki bir adımda kaynakları temizlemek için bunu kullanacağız.

Portalda mesajlaşma ölçümlerini görüntüleme

Bu Azure portal, cihazlarınızı ve cihazlarınızı tüm yönleriyle IoT Hub sağlar. Cihazlardan telemetri IoT Hub tipik bir uygulama olarak, cihazları izlemek veya cihaz telemetrisinde ölçümleri görüntülemek istiyor olabilir.

Mesajlaşma ölçümlerini görselleştirmek için Azure portal:

1. Portalda sol gezinti menüsünde Tüm Kaynaklar'ı seçin. Bu, oluşturduğunuz IoT hub'ı dahil olmak üzere aboneliğinizin tüm kaynaklarını listeler.

2. Oluşturduğunuz IoT hub'ı bağlantısını seçin. Portalda hub'ın genel bakış sayfası görüntülenir.

3. Rapor bölmenizin sol bölmesinde Ölçümler'i IoT Hub.

   

4. Kapsam alanına IoT hub'nizin adını girin.

5. Ölçüm Ad Alanı'nde Iot Hub Standart Ölçümleri'ne seçin.

6. Ölçüm'de kullanılan toplam ileti sayısı'ı seçin.

7. Fare işaretçinizi, cihazınızın iletileri gönderdiği zaman çizelgesinin üzerine gelin. Zaman çizelgesinin sol alt köşesinde, zaman içinde bir noktadaki toplam ileti sayısı görüntülenir.

   

8. İsteğe bağlı olarak, simülasyon cihazınıza diğer ölçümleri görüntülemek için Ölçüm açılan listesinden de görüntüleniyor. Örneğin, C2d ileti teslimleri tamamlandı veya Toplam cihaz (önizleme).

Kaynakları temizleme

Bu hızlı başlangıçta oluşturulan Azure kaynaklarına artık ihtiyacınız yoksa, bunları silmek için Azure CLI'sini kullanabilirsiniz.

Önerilen bir sonraki makaleye devam edersanız, önceden oluşturduğunuz kaynakları saklayarak yeniden kullanabilirsiniz.

Bir kaynak grubunu adıyla silmek için:

1. az group delete komutunu çalıştırın. Bu işlem kaynak grubunu, IoT Hub ve oluşturduğunuz cihaz kaydını kaldırır.

   az group delete --name MyResourceGroup
   

2. Kaynak grubunun silindikten sonra az group list komutunu çalıştırın.

   az group list
   

Sonraki adımlar

Bu hızlı başlangıçta IoT hub'ı oluşturmak, sanal cihaz oluşturmak, telemetri göndermek, telemetri izlemek, buluttan cihaza ileti göndermek ve kaynakları temizlemek için Azure CLI'sini kullandınız. Uygulamanın Azure portal ölçümlerini görselleştirmek için kullandınız.

Cihaz geliştiricisiyseniz, önerilen sonraki adım C için Azure IoT Cihaz SDK'sı kullanan telemetri hızlı başlangıçını görmektir. İsteğe bağlı olarak, tercih ettiğiniz dilde veya SDK'da kullanılabilir Azure IoT Hub telemetri hızlı başlangıç makalelerinden birini görmektir.

Bir arka uç uygulamasından simülasyon cihazınızı denetlemeyi öğrenmek için sonraki hızlı başlangıçla devam edin.