Szybki start: wysyłanie danych telemetrycznych z urządzenia do centrum IoT i monitorowanie ich za pomocą interfejsu wiersza polecenia platformy Azure

Usługa IoT Hub to usługa platformy Azure przeznaczona do zbierania dużych ilości danych telemetrycznych z urządzeń IoT na potrzeby przechowywania lub przetwarzania w chmurze. W tym bezkodowym przewodniku szybkiego startu użyjesz wiersza polecenia interfejsu platformy Azure do utworzenia centrum IoT i symulowanego urządzenia. Wysyłasz dane telemetryczne urządzenia do węzła, a także wysyłasz komunikaty, wywołujesz metody i aktualizujesz właściwości urządzenia. Ponadto użyjesz witryny Azure Portal do wizualizacji metryk urządzeń. Ten artykuł zawiera podstawowy przepływ pracy dla deweloperów korzystających z interfejsu wiersza polecenia do interakcji z aplikacją usługi IoT Hub.

Wymagania wstępne

• Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz je bezpłatnie .
• Interfejs wiersza polecenia platformy Azure. Wszystkie polecenia można uruchomić w tym przewodniku 'Szybki Start' przy użyciu usługi Azure Cloud Shell, interaktywnej powłoki CLI działającej w przeglądarce lub w aplikacji, takiej jak Windows Terminal. Jeśli używasz usługi Cloud Shell, nie musisz instalować żadnych elementów. Jeśli wolisz używać Azure CLI na lokalnym komputerze, ten Szybki start wymaga wersji 2.36 lub nowszej. Uruchom polecenie az --version, aby dowiedzieć się, jaka wersja jest używana. Aby zainstalować lub uaktualnić, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.

Zaloguj się do witryny Azure Portal.

Zaloguj się w witrynie Azure Portal.

Niezależnie od tego, czy uruchamiasz interfejs wiersza polecenia lokalnie, czy w usłudze Cloud Shell, pozostaw portal otwarty w przeglądarce. Użyjesz go w dalszej części tego przewodnika Szybki start.

Uruchamianie usługi Cloud Shell

W tej sekcji uruchomisz wystąpienie usługi Azure Cloud Shell. Jeśli używasz interfejsu wiersza polecenia lokalnie, przejdź do sekcji Przygotuj dwie sesje CLI.

Aby uruchomić usługę Cloud Shell:

1. Wybierz przycisk Cloud Shell na pasku menu w prawym górnym rogu w witrynie Azure Portal.

   

   Uwaga

   Jeśli po raz pierwszy użyto usługi Cloud Shell, zostanie wyświetlony monit o utworzenie magazynu, który jest wymagany do korzystania z usługi Cloud Shell. Wybierz subskrypcję, aby utworzyć konto przechowywania i udostępnianie plików w Microsoft Azure.

2. Wybierz preferowane środowisko interfejsu wiersza polecenia na liście rozwijanej Wybierz środowisko . W tym szybkim starcie używane jest środowisko Bash. Możesz również użyć środowiska programu PowerShell .

   Uwaga

   Niektóre polecenia wymagają innej składni lub formatowania w środowiskach Bash i PowerShell. Aby uzyskać więcej informacji, zobacz Porady dotyczące pomyślnego korzystania z interfejsu wiersza polecenia platformy Azure.

   

Przygotuj dwie sesje CLI

Następnie musisz przygotować dwie sesje Azure CLI. Jeśli używasz usługi Cloud Shell, uruchamiasz te sesje na oddzielnych kartach usługi Cloud Shell. W przypadku korzystania z lokalnego klienta interfejsu wiersza polecenia należy uruchomić oddzielne instancje CLI. Użyj oddzielnych sesji CLI dla następujących zadań:

• Pierwsza sesja symuluje urządzenie IoT komunikujące się z centrum IoT.
• Druga sesja monitoruje urządzenie w pierwszej sesji lub wysyła komunikaty, polecenia i aktualizacje właściwości.

Aby uruchomić polecenie, wybierz opcję Kopiuj, aby skopiować blok kodu z tego poradnika Quickstart, wklej go do swojej sesji powłoki i wykonaj.

Azure CLI wymaga zalogowania się na konto Azure. Cała komunikacja między twoją sesją Azure CLI a centrum IoT jest uwierzytelniana i szyfrowana. W związku z tym ten przewodnik Szybki start nie wymaga dodatkowego uwierzytelniania, którego będziesz używać z rzeczywistym urządzeniem, takim jak parametry połączenia.

• W pierwszej sesji wiersza poleceń uruchom polecenie az extension add. Polecenie dodaje rozszerzenie Microsoft Azure IoT dla interfejsu wiersza polecenia platformy Azure do powłoki interfejsu wiersza polecenia. Rozszerzenie IOT dodaje polecenia specyficzne dla usługi IoT Hub, IoT Edge i IoT Device Provisioning Service (DPS) do interfejsu wiersza polecenia platformy Azure.

  az extension add --name azure-iot
  

  Po zainstalowaniu rozszerzenia Azure IOT nie trzeba jej ponownie instalować w żadnej sesji usługi Cloud Shell.

  Uwaga

  W tym artykule jest używana najnowsza wersja rozszerzenia Usługi Azure IoT o nazwie azure-iot. Starsza wersja nosi nazwę azure-cli-iot-ext. Jednocześnie powinna być zainstalowana tylko jedna wersja. Możesz użyć polecenia az extension list , aby zweryfikować aktualnie zainstalowane rozszerzenia.

  Użyj az extension remove --name azure-cli-iot-ext polecenia , aby usunąć starszą wersję rozszerzenia.

  Użyj az extension add --name azure-iot polecenia , aby dodać nową wersję rozszerzenia.

  Aby sprawdzić, jakie rozszerzenia są obecnie zainstalowane, użyj polecenia az extension list.

• Otwórz drugą sesję CLI. Jeśli używasz usługi Cloud Shell w przeglądarce, użyj przycisku Otwórz nową sesję. Jeśli używasz interfejsu wiersza polecenia lokalnie, otwórz drugie wystąpienie interfejsu wiersza polecenia.

  

Tworzenie centrum IoT

W tej sekcji użyjesz interfejsu wiersza polecenia platformy Azure do utworzenia grupy zasobów i centrum IoT Hub. Grupa zasobów platformy Azure to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi. Centrum IoT działa jako centralne centrum komunikatów na potrzeby dwukierunkowej komunikacji między aplikacją IoT a urządzeniami.

1. W pierwszej sesji CLI wykonaj polecenie az group create, aby utworzyć grupę zasobów. Następujące polecenie tworzy grupę zasobów o nazwie MyResourceGroup w lokalizacji eastus .

   az group create --name MyResourceGroup --location eastus
   

2. W pierwszej sesji interfejsu wiersza polecenia uruchom polecenie Az PowerShell module iot hub create, aby utworzyć hub IoT. Utworzenie centrum IoT Hub trwa kilka minut.

   TwojaIotHubNazwa. Zastąp ten symbol zastępczy i otaczające nawiasy klamrowe w poniższym poleceniu, używając nazwy, którą wybrałeś dla swojego IoT hubu. Nazwa centrum IoT musi być globalnie unikatowa na platformie Azure. Użyj nazwy centrum IoT w pozostałej części tego przewodnika szybkiego startu w miejscach zawierających symbol zastępczy.

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

Tworzenie i monitorowanie urządzenia

W tej sekcji utworzysz symulowane urządzenie w pierwszej sesji interfejsu wiersza polecenia. Symulowane urządzenie wysyła dane telemetryczne urządzenia do centrum IoT. Podczas drugiej sesji CLI monitorujesz zdarzenia i dane telemetryczne.

Aby utworzyć i uruchomić symulowane urządzenie:

1. W pierwszej sesji wiersza polecenia uruchom polecenie az iot hub device-identity create. To polecenie tworzy tożsamość symulowanego urządzenia.

   TwojaIotHubNazwa. Zastąp ten symbol zastępczy w poniższym kodzie nazwą wybraną dla IoT Hub.

   simDevice. Możesz użyć tej nazwy bezpośrednio dla symulowanego urządzenia w pozostałej części tego szybkiego przewodnika. Opcjonalnie użyj innej nazwy.

   az iot hub device-identity create -d simDevice -n {YourIoTHubName} 
   

2. W pierwszej sesji interfejsu wiersza polecenia uruchom polecenie az iot device simulate. To polecenie uruchamia symulowane urządzenie. Urządzenie wysyła dane telemetryczne do centrum IoT i odbiera z niego komunikaty.

   TwojaIotHubNazwa. Zastąp ten symbol zastępczy w poniższym kodzie nazwą wybraną dla IoT Hub.

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

Aby monitorować urządzenie:

1. W drugiej sesji interfejsu wiersza polecenia uruchom polecenie az iot hub monitor-events. To polecenie stale monitoruje symulowane urządzenie. Dane wyjściowe pokazują dane telemetryczne, takie jak zdarzenia i zmiany stanu właściwości wysyłane przez symulowane urządzenie do centrum IoT.

   TwojaIotHubNazwa. Zastąp ten symbol zastępczy w poniższym kodzie nazwą wybraną dla IoT Hub.

   az iot hub monitor-events --output table -p all -n {YourIoTHubName}
   

   

2. Po monitorowaniu symulowanego urządzenia w drugiej sesji interfejsu wiersza polecenia naciśnij Ctrl+C, aby zatrzymać monitorowanie. Pozostaw otwartą drugą sesję interfejsu wiersza polecenia (CLI), aby użyć jej w kolejnych krokach.

Użyj interfejsu wiersza polecenia, aby wysłać komunikat

W tej sekcji wyślesz komunikat do urządzenia symulowanego.

1. W pierwszej sesji interfejsu wiersza polecenia upewnij się, że symulowane urządzenie jest nadal uruchomione. Jeśli urządzenie zostanie zatrzymane, uruchom następujące polecenie, aby go uruchomić ponownie:

   TwojaIotHubNazwa. Zastąp ten symbol zastępczy w poniższym kodzie nazwą wybraną dla IoT Hub.

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

2. W drugiej sesji wiersza polecenia uruchom polecenie az iot device c2d-message send. To polecenie wysyła komunikat cloud-to-device z IoT Hub do symulowanego urządzenia. Komunikat zawiera ciąg i dwie pary klucz-wartość.

   TwojaIotHubNazwa. Zastąp ten symbol zastępczy w poniższym kodzie nazwą wybraną dla IoT Hub.

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

   Opcjonalnie możesz wysyłać komunikaty z chmury do urządzenia przy użyciu witryny Azure Portal. Aby wysyłać komunikaty za pośrednictwem witryny Azure Portal, przejdź do strony przeglądu usługi IoT Hub, wybierz pozycję Urządzenia IoT, wybierz symulowane urządzenie i wybierz pozycję Komunikat do urządzenia.

3. W pierwszej sesji CLI upewnij się, że symulowane urządzenie odebrało komunikat.

   

Użyj CLI do wywołania metody urządzenia

W tej sekcji wywołasz metodę bezpośrednią na urządzeniu symulowanym.

1. Jak poprzednio, upewnij się, że symulowane urządzenie w pierwszej sesji interfejsu wiersza polecenia jest uruchomione. Jeśli nie, uruchom go ponownie.

2. W drugiej sesji CLI uruchom polecenie az iot hub invoke-device-method. W tym przykładzie nie istnieje żadna wcześniejsza metoda dla urządzenia. Polecenie wywołuje przykładową nazwę metody na urządzeniu symulowanym i zwraca ładunek.

   TwojaIotHubNazwa. Zastąp ten symbol zastępczy w poniższym kodzie nazwą wybraną dla IoT Hub.

   az iot hub invoke-device-method --mn MySampleMethod -d simDevice -n {YourIoTHubName}
   

3. W pierwszej sesji CLI potwierdź, że dane wyjściowe zawierają wywołanie metody.

   

Aktualizowanie właściwości urządzenia za pomocą interfejsu wiersza polecenia

W tej sekcji zaktualizujesz stan symulowanego urządzenia, ustawiając wartości właściwości.

1. Jak poprzednio, upewnij się, że symulowane urządzenie w pierwszej sesji interfejsu wiersza polecenia jest uruchomione. Jeśli nie, uruchom go ponownie.

2. W drugiej sesji CLI uruchom polecenie az iot hub device-twin update. To polecenie aktualizuje właściwości do żądanego stanu na bliźniaku urządzenia IoT, odpowiadającego Twojemu symulowanemu urządzeniu. W tym przypadku polecenie ustawia przykładowe właściwości warunku temperatury.

   Ważne

   Jeśli używasz programu PowerShell w wierszu poleceń, użyj wersji polecenia PowerShell w poniższym kodzie. Program PowerShell wymaga zamaskowania znaków w danych JSON.

   TwojaIotHubNazwa. Zastąp ten symbol zastępczy w poniższym kodzie nazwą wybraną dla IoT Hub.

   az iot hub device-twin update -d simDevice --desired '{"conditions":{"temperature":{"warning":98, "critical":107}}}' -n {YourIoTHubName}
   

   az iot hub device-twin update -d simDevice --desired '{\"conditions\":{\"temperature\":{\"warning\":98, \"critical\":107}}}' -n {YourIoTHubName}
   

3. W pierwszej sesji interfejsu wiersza polecenia upewnij się, że symulowane urządzenie wyprowadza aktualizację właściwości.

   

4. W drugiej sesji interfejsu wiersza polecenia uruchom polecenie az iot hub device-twin show. To polecenie zgłasza zmiany we właściwościach urządzenia.

   TwojaIotHubNazwa. Zastąp ten symbol zastępczy w poniższym kodzie nazwą wybraną dla IoT Hub.

   az iot hub device-twin show -d simDevice --query properties.reported -n {YourIoTHubName}
   

   

Wyświetlanie metryk komunikatów w portalu

Witryna Azure Portal umożliwia zarządzanie wszystkimi aspektami centrum IoT i urządzeń. W typowej aplikacji usługi IoT Hub, która uzyskuje dane telemetryczne z urządzeń, można monitorować urządzenia lub wyświetlać metryki telemetrii urządzeń.

Aby wizualizować metryki komunikatów na platformie Azure Portal:

1. W menu nawigacji po lewej stronie w portalu wybierz pozycję Wszystkie zasoby. Ta karta zawiera listę wszystkich zasobów w ramach subskrypcji, w tym utworzonego centrum IoT.

2. Wybierz link w utworzonym przez Ciebie IoT Hub. Portal wyświetla stronę przeglądu hubu.

3. Wybierz pozycję Metryki w lewym okienku usługi IoT Hub.

   

4. W polu Zakres wprowadź nazwę centrum IoT Hub.

5. W polu Przestrzeń nazw metryk wybierz pozycję Metryki standardowe usługi IoT Hub.

6. W polu Metryka wybierz pozycję Łączna liczba użytych komunikatów.

7. Umieść wskaźnik myszy na obszarze osi czasu, w którym urządzenie wysyłało komunikaty. Łączna liczba komunikatów w punkcie w czasie jest wyświetlana w lewym dolnym rogu osi czasu.

   

8. Opcjonalnie użyj listy rozwijanej Metryka , aby wyświetlić inne metryki na urządzeniu symulowanym. Na przykład dostarczanie komunikatów C2d zakończone lub Łączna liczba urządzeń (wersja zapoznawcza).

Czyszczenie zasobów

Jeśli nie potrzebujesz już zasobów platformy Azure utworzonych w tym szybkim starcie, możesz je usunąć za pomocą Azure CLI.

Jeśli będziesz kontynuować korzystanie z następnego zalecanego artykułu, możesz zachować już utworzone zasoby i użyć ich ponownie.

Ważne

Usunięcie grupy zasobów jest nieodwracalne. Grupa zasobów oraz wszystkie zawarte w niej zasoby zostaną trwale usunięte. Uważaj, aby nie usunąć przypadkowo niewłaściwych zasobów lub grupy zasobów.

Aby usunąć grupę zasobów na podstawie nazwy:

1. Uruchom komendę az group delete. To polecenie usuwa grupę zasobów, centrum IoT i utworzoną rejestrację urządzenia.

   az group delete --name MyResourceGroup
   

2. Uruchom polecenie az group list, aby potwierdzić usunięcie grupy zasobów.

   az group list
   

Następne kroki

W tym przewodniku szybkiego startu użyto interfejsu wiersza polecenia platformy Azure do utworzenia centrum IoT, utworzenia symulowanego urządzenia, wysyłania i monitorowania telemetrii, wykonywania metody, określania żądanych właściwości i usuwania zasobów. Użyłeś portalu Azure do wizualizacji metryk wiadomości na swoim urządzeniu.

Jeśli jesteś deweloperem urządzeń, sugerowanym następnym krokiem jest zapoznanie się z przewodnikiem "Szybki start dla telemetrii", który korzysta z Azure IoT Device SDK dla języka C. Opcjonalnie możesz zapoznać się z jednym z dostępnych artykułów "Szybki start dotyczący telemetrii" usługi Azure IoT Hub w preferowanym języku lub zestawie SDK.

Aby dowiedzieć się, jak kontrolować urządzenie symulowane z poziomu aplikacji zaplecza, przejdź do następnego przewodnika Szybki start.

Szybki start: kontrolowanie urządzenia podłączonego do centrum IoT