次の方法で共有


FAQ とトラブルシューティング

コレクター モジュールが組み込みのエンドポイントからメトリックを収集できない

モジュールが同じ Docker ネットワーク上にインストールされているかどうかを確認

メトリックコレクター モジュールは、ユーザー定義のネットワークについて Docker の埋め込み DNS リゾルバーに依存します。 DNS リゾルバーは、モジュール名を含むメトリック エンドポイントの IP アドレスを提供します。 これはたとえば、http://edgeHub:9600/metrics のようになります。

モジュールが同じネットワーク名前空間で実行されていない場合、このメカニズムは機能しません。 たとえば、一部のシナリオでは、モジュールをホスト ネットワークで実行する必要があります。 メトリックコレクター モジュールが別のネットワーク上にある場合、このようなシナリオでは収集に失敗します。

httpSettings__enabled 環境変数が false に設定されていないことを確認

IoT Edge システム モジュールによって公開される組み込みのメトリック エンドポイントでは、http プロトコルが使用されます。 これらは、http が Edge Hub または Edge Agent モジュールの環境変数設定を通じて明示的に無効になっている場合には、モジュール ネットワーク内でも使用できません。

http プロキシ サーバーを使用する場合には NO_PROXY 環境変数を設定

詳細については、「プロキシに関する考慮事項」をご覧ください。

Moby エンジンの更新

Linux ホスト上で、最新バージョンのコンテナー エンジンを使用していることを確認します。 インストール手順に従って、最新バージョンに更新することをお勧めします。

メトリックと共にログを収集するにはどうすればよいですか?

組み込みのログ プル機能を使用できます。 組み込みのログ取得機能を使用するサンプル ソリューションは、https://aka.ms/iot-elms で確認できます。

Azure portal のメトリック ページにデバイスのメトリックが表示されないのはなぜですか?

Azure Monitor のネイティブ メトリック テクノロジでは、Prometheus データ形式がまだ直接サポートされていません。 次の理由から、現時点ではログベースのメトリックの方が IoT Edge メトリックに適しています。

  • 標準の InsightsMetrics テーブルを使用した Prometheus メトリック形式のネイティブ サポート。
  • 視覚化とアラートを実現するための、KQL による高度なデータ処理。

Azure portal の [メトリック] ではなく、[ログ] ページにメトリックが表示される理由は、メトリック データベースとして Log Analytics を使用しているためです。

多層デプロイでメトリックコレクターを構成するにはどうすればよいですか?

メトリック コレクターには、サービス検出機能は含まれていません。 ベースまたは "下位" のデプロイ層にモジュールを含めることをお勧めします。 モジュールの構成内で、モジュールがデプロイされる可能性のあるすべてのメトリック エンドポイントを含めます。 モジュールが最終的なデプロイに表示されないが、そのエンドポイントがコレクションの一覧に表示される場合には、コレクターは収集を試み、失敗し、先に進みます。

カスタム メトリックを使用して監視ソリューションを拡張するにはどうすればよいですか?

カスタム メトリックに関する記事を参照してください。

特定のメトリックが属しているデバイスを認識するにはどうすればよいですか?

メトリック ラベルでデバイス情報をエンコードします。 詳細については、「名前付け規則」を参照してください。

複数の IoT ハブからのデバイスにまたがるアラート ルールを作成するにはどうすればよいですか?

アラート ルールを作成するときに、そのスコープをリソース グループまたはサブスクリプションに変更できます。 すると、アラート ルールは、そのスコープ内のすべての IoT ハブに適用されます。

アラートが必要な時に発生しない

アラート ルールを作成するときに、プレビュー グラフを確認してアラート ロジックがトリガーされるのを確認します。

問題が見つからなかった場合は、Log Analytics サービスのテクニカル サポート インシデントを作成します。

デバイスが監視ブックに表示されない

ブックでは、デバイス メトリックが ResourceId を使用して正しい IoT ハブまたは IoT Central アプリケーションにリンクされていることが必要とされます。 メトリックコレクターが、正しい ResourceId構成されていることを確認します。

メトリックコレクター モジュール ログを使用し、選択した時間範囲内にデバイスがメトリックを送信したことを確認します。

メトリックが表示される前に、数分のインジェスト遅延が発生する場合があることに注意してください。

バグが見つかったか、ブックに表示されているメトリックに関する質問がある

タイトルに '[monitor-workbook]' を含め、Azure IoT Edge GitHub リポジトリで issue を開きます。

ブックのテンプレートは、GitHub で一般公開されています。 改善または修正に関する pull request をお待ちしています。

パブリック テンプレートにブックが表示されない

Log Analytics ワークスペースではなく、ポータルの IoT ハブまたは IoT Central アプリケーション ページで [ブック] ページを表示していることを確認します。

ブックがまだ表示されない場合は、実稼働前の Azure portal 環境を使用してみてください (https://portal.azure.com)。 ブックの更新が運用環境に表示されるまで時間がかかることがありますが、その場合でも実稼働前の環境で利用できます。