Azure CLI を使用してデバイスの接続性を監視する
Azure CLI IoT 拡張機能を使用して、次の手順を実行します。
- デバイスが IoT Central に送信しているメッセージを確認します。
- デバイス ツインの変更を確認します。
- デバイス メッセージがクラウドに到達しない問題を診断します。
- デバイスがツインの変更に応答しない問題を診断します。
詳細については、Azure CLI 拡張機能のリファレンスを参照してください。
前提条件
Azure の職場または学校アカウント。IoT Central アプリケーションにユーザーとして追加されます。
Azure CLI の環境を準備する
Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。
CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。
ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、Azure CLI でのサインインに関するページを参照してください。
初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。
az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。
IoT Central 拡張機能をインストールする
インストールするには、コマンド ラインから次のコマンドを実行します。
az extension add --name azure-iot
次を実行して拡張機能のバージョンを確認します。
az --version
azure-iot 拡張機能が 0.14.1 以降であることがわかります。 そうでない場合は、次のコマンドを実行します。
az extension update --name azure-iot
拡張機能を使用する
次のセクションでは、az iot central
を実行するときに使用できる一般的なコマンドとオプションについて説明します。 コマンドおよびオプションの完全なセットを表示するには、--help
を az iot central
またはそのいずれかのサブコマンドに渡します。
サインイン
まず、Azure CLI にサインインします。
az login
IoT Central アプリのアプリケーション ID を取得する
[アプリケーション] > [管理] で、アプリケーション ID をコピーします。 この値は、後の手順で使用します。
メッセージの監視
デバイスから IoT Central アプリに送信されているメッセージを監視します。 出力には、すべてのヘッダーと注釈が含まれます。
az iot central diagnostics monitor-events --app-id <app-id> --properties all
デバイスのプロパティを表示する
特定のデバイスを対象に、現在の読み取りおよび読み取り/書き込みのデバイス プロパティを表示します。
az iot central device twin show --app-id <app-id> --device-id <device-id>
次のステップ
推奨される次の手順は、デバイスからのデータが Azure IoT Central に表示されない理由のトラブルシューティングについて学習することです。