IoT Edge デプロイの監視

適用対象: IoT Edge 1.5

Azure IoT Edge では、IoT Edge デバイスにデプロイされたモジュールに関するリアルタイム情報が提供されます。 IoT Hub サービスは、デバイスから状態を取得し、ユーザーに表示します。 また、自動デプロイや多層デプロイなどの大規模なデプロイでも監視は重要です。

デバイスとモジュールは、接続などのデータが似ているため、デバイス ID またはモジュール ID に基づいて値を取得します。

IoT Hub サービスは、デバイスツインとモジュール ツインによって報告されたデータを収集し、デバイスが持つ可能性のあるさまざまな状態の数を提供します。 IoT Hub サービスは、このデータを 4 つのメトリック グループに編成します。

このデータは、Azure portal で監視することも、Azure CLI を使用することもできます。

Azure portal でデプロイを監視する

展開の詳細を表示し、それを実行しているデバイスを監視するには、次の手順に従います。

1. Azure portal にサインインし、IoT Hub に移動します。

2. [デバイス管理] で [構成と展開] を選択します。

3. デプロイの一覧をレビューします。 デプロイごとに、次の詳細が表示されます。

   列	説明
   id	展開の名前。
   型	デプロイの種類。[デプロイ] または [Layered Deployment]\(多層デプロイ\) のどちらかです。
   [Target Condition] (ターゲット条件)	対象となるデバイスを定義するタグ。
   優先順位	デプロイに割り当てられた優先順位番号。
   システム メトリック	ターゲット条件に一致する IoT Hub 内のデバイス ツインの数を示します。 [適用済み] には、IoT Hub のモジュール ツインにデプロイ コンテンツが適用されているデバイスの数が表示されます。
   デバイス メトリック	IoT Edge クライアント ランタイムから成功またはエラーを報告している IoT Edge デバイスの数。
   カスタム メトリック	デプロイ用に定義したメトリックのデータを報告する IoT Edge デバイスの数。
   作成済	デプロイが作成されたときのタイムスタンプ。 2 つのデプロイの優先順位が同じ場合に、このタイムスタンプを使用して優先するデプロイを決定します。

4. 監視するデプロイを選択します。

5. [ デプロイの詳細 ] ページで、[ ターゲット条件 ] タブに移動します。[ 表示] を選択して、ターゲット条件に一致するデバイスを一覧表示します。 必要に応じて条件または 優先度 を変更し、[ 保存] を選択します。

   

6. [ メトリック ] タブを選択します。[メトリックの選択] ドロップダウンからメトリックを 選択 すると、[ 表示 ] ボタンが表示され、結果を表示できます。 [ メトリックの編集] を選択して、定義したカスタム メトリックの条件を調整します。 変更内容を確定する場合は [保存] を選択します。

   

デプロイを変更するには、「デプロイ の変更」を参照してください。

Azure CLI でデプロイを監視する

az iot edge deployment show コマンドを使用して、1 つのデプロイの詳細を表示します。

az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]

deployment show コマンドでは、次のパラメーターを使用します。

• --deployment-id - IoT ハブ内のデプロイの名前。 必須の パラメーター。
• --hub-name - デプロイが存在する IoT ハブの名前。 ハブは現在のサブスクリプションにある必要があります。 を使用してサブスクリプションに切り替える az account set -s [subscription name]

コマンド ウィンドウでデプロイを確認します。 metrics プロパティには、各ハブによって評価される各メトリックの数が一覧表示されます。

• targetedCount - ターゲット条件に一致する IoT Hub 内のデバイス ツインの数。
• appliedCount - IoT Hub のモジュール ツインにデプロイ コンテンツが適用されているデバイスの数。
• reportedSuccessfulCount - IoT Edge クライアント ランタイムからの成功を報告するデプロイ内の IoT Edge デバイスの数。
• reportedFailedCount - IoT Edge クライアント ランタイムからの失敗を報告するデプロイ内の IoT Edge デバイスの数。

az iot edge deployment show-metric コマンドを使用して、各メトリックのデバイス ID またはオブジェクトの一覧を表示します。

az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]

deployment show-metric コマンドでは、次のパラメーターを使用します。

• --deployment-id - IoT ハブ内のデプロイの名前。
• --metric-id - デバイス ID の一覧を表示するメトリックの名前 ( reportedFailedCountなど)。
• --hub-name - デプロイが存在する IoT ハブの名前。 ハブは現在のサブスクリプションにある必要があります。 az account set -s [subscription name]を使用してサブスクリプションに切り替えます。 デプロイを変更するには、「デプロイの変更」を参照してください。

次のステップ

モジュール ツイン (主に IoT Edge エージェントと IoT Edge Hub ランタイム モジュール) を監視して、IoT Edge デプロイの接続性と正常性を確認する方法について説明します。