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 を実行するときに使用できる一般的なコマンドとオプションについて説明します。 コマンドおよびオプションの完全なセットを表示するには、--helpaz 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 に表示されない理由のトラブルシューティングについて学習することです。