Monitorowanie łączności urządzeń przy użyciu interfejsu wiersza polecenia platformy Azure
Użyj rozszerzenia IoT interfejsu wiersza polecenia platformy Azure, aby:
- Zobacz komunikaty wysyłane przez urządzenia do usługi IoT Central.
- Obserwuj zmiany w bliźniaczej reprezentacji urządzenia.
- Diagnozowanie problemów polegających na tym, że komunikaty urządzeń nie docierają do chmury.
- Diagnozowanie problemów polegających na tym, że urządzenia nie reagują na zmiany bliźniaczych reprezentacji.
Wymagania wstępne
Konto służbowe na platformie Azure dodane jako użytkownik w aplikacji usługi IoT Central.
Przygotowywanie środowiska dla interfejsu wiersza polecenia platformy Azure
Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.
Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.
Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.
Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.
Instalowanie rozszerzenia usługi IoT Central
Uruchom następujące polecenie z poziomu wiersza polecenia, aby zainstalować:
az extension add --name azure-iot
Sprawdź wersję rozszerzenia, uruchamiając polecenie:
az --version
Powinno zostać wyświetlone rozszerzenie azure-iot o wartości 0.14.1 lub nowszej. Jeśli tak nie jest, uruchom polecenie:
az extension update --name azure-iot
Korzystanie z rozszerzenia
W poniższych sekcjach opisano typowe polecenia i opcje, których można użyć podczas uruchamiania polecenia az iot central
. Aby wyświetlić pełny zestaw poleceń i opcji, przekaż --help
polecenie az iot central
lub dowolne z jego poleceń podrzędnych.
Zaloguj się
Zacznij od zalogowania się do interfejsu wiersza polecenia platformy Azure:
az login
Pobieranie identyfikatora aplikacji aplikacji usługi IoT Central
W obszarze Zarządzanie aplikacjami >skopiuj identyfikator aplikacji. Ta wartość jest używana w kolejnych krokach.
Monitorowanie komunikatów
Monitoruj komunikaty wysyłane do aplikacji usługi IoT Central z urządzeń. Dane wyjściowe zawierają wszystkie nagłówki i adnotacje.
az iot central diagnostics monitor-events --app-id <app-id> --properties all
Wyświetlanie właściwości urządzenia
Wyświetl bieżące właściwości urządzenia odczytu i odczytu/zapisu dla danego urządzenia.
az iot central device twin show --app-id <app-id> --device-id <device-id>
Następne kroki
Sugerowanym następnym krokiem jest poznanie , dlaczego dane z urządzeń nie są wyświetlane w usłudze Azure IoT Central.