Azure portal から IoT Edge デバイスのトラブルシューティングを行う

適用対象: IoT Edge 1.5

IoT Edge を使用すると、Azure portal でモジュールの監視とトラブルシューティングを行うことができます。 トラブルシューティング ページでは、IoT Edge エージェントのダイレクト メソッドがラップされ、デプロイされたモジュールからログを取得してリモートで再起動できます。 この記事では、Azure portal でデバイス ログとモジュール ログにアクセスしてフィルター処理する方法について説明します。

トラブルシューティング ページにアクセスする

ポータルのトラブルシューティング ページには、IoT Edge デバイスの詳細ページまたは IoT Edge モジュールの詳細ページからアクセスできます。

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

2. 左側のウィンドウで、[デバイス管理] の下にある [デバイス] を選択します。

3. デバイスの一覧から、監視する IoT Edge デバイスを選択します。

4. デバイスの詳細ページで、メニューから [トラブルシューティング ] を選択します。

   

   または、検査するモジュールのランタイム状態を選択します。

   

5. デバイスの詳細ページで、モジュールの名前を選択してモジュールの詳細ページを開きます。 次に、メニューから [トラブルシューティング ] を選択します。

   

ポータルでモジュール ログを表示する

デバイスの [トラブルシューティング] ページでは、IoT Edge デバイス上で実行中の任意のモジュールのログを表示およびダウンロードできます。

このページのログ行の最大数は 1,500 であり、これより長いログは切り捨てられます。 ログが大きすぎる場合、モジュール ログの取得の試行は失敗します。 その場合は、時間範囲フィルターを変更してデータを少なくするか、ダイレクト メソッドを使用して IoT Edge デプロイからログを取得 し、より大きなログ ファイルを収集します。

ドロップダウン メニューを使用して、検査するモジュールを選択します。

既定では、このページには過去 15 分間のログが表示されます。 [ 時間範囲 ] フィルターを選択して、別のログを表示します。 スライダーを使用して過去 60 分以内の時間枠を選択するか、[ Enter time] \(時刻の入力\) を選択して特定の日時ウィンドウを選択します。

ログを取得し、トラブルシューティングするモジュールの時間フィルターを設定したら、 検索 フィルターを使用してログから特定の行を取得します。 警告、エラー、または特定の用語または語句をフィルタリングします。

検索機能では、複雑な検索用のプレーンテキスト検索と .NET 正規表現がサポートされています。

モジュール ログはテキスト ファイルとしてダウンロードできます。 ダウンロードするログ ファイルには、ログに適用したアクティブなフィルターが反映されます。

モジュールを再起動する

[ トラブルシューティング ] ページでは、モジュールを再起動できます。 このオプションを選択すると、選択したモジュールを再起動するコマンドが IoT Edge エージェントに送信されます。 モジュールを再起動しても、再起動前からログを取得する機能には影響しません。

次のステップ

IoT Edge デバイスのトラブルシューティングに関するその他のヒント、または一般的な問題と解決策について説明します。

その他の質問がある場合は、 サポートリクエスト を作成してください。