このドキュメントでは、Device Update ユーザーが報告した一般的な質問と問題の一覧を示します。 Device Update がパブリック プレビューを通じて進行すると、このトラブルシューティング ガイドは新しい質問と解決策で定期的に更新されます。 このトラブルシューティング ガイドに表示されない問題が発生した場合は、「Microsoft サポートへの問い合わせ」セクションを参照して状況を文書化してください。
更新プログラムのインポート
Q: Device Update インスタンスを IoT Hub インスタンスに接続するときに問題が発生しています。
Device Update リソース ドキュメントに従って、IoT Hub メッセージ ルートが正しく構成されていることを確認してください。
Q: ロール関連のエラー (Azure portal のエラー メッセージまたは 403 API エラー) が発生しています。
アクセス許可が正しく構成されていない可能性があります。 Device Update のアクセス制御 ドキュメントに従って、アクセス許可が正しく構成されていることを確認してください。
Q: Device Update サービスにコンテンツをインポートするときに、500 種類のエラーが発生しています。
500 の範囲のエラー コードは、デバイス更新サービスの問題を示している可能性があります。 5 分待ってから、もう一度やり直してください。 同じエラーが引き続き発生する場合は、「Microsoft サポート に問い合わせる」セクションの手順に従って、Microsoft にサポート リクエストを提出してください。
Q: 同じ互換性プロパティを保持する (更新プログラムを同じデバイスの種類に設定する) が、インポート マニフェストでプロバイダーまたは名前を変更したい。 しかし、私はそうするときに「失敗:制限を超えたために更新プログラムをインポート中にエラーが発生しました」というエラーが表示されます。
同じ互換性プロパティのセットを、複数の更新プロバイダーと名前の組み合わせで使用することはできません。 これにより、Device Update サービスは、特定のデバイスに展開するために使用できる更新プログラムを確実に決定できます。 1 つのデバイスで複数のコンポーネントまたはパーティションを更新する必要がある場合は、プロキシの更新 機能によってその機能が提供されます。
Q: コンテンツをインポートするときにエラー メッセージが表示され、詳細を理解したいと考えています。
インポート関連のエラー メッセージの詳細については、デバイス更新エラー コード ドキュメントを参照してください。
デバイスの障害
Q: デバイスが Device Update for IoT Hub に接続されていることを確認するにはどうすればよいですか?
デバイスが Device Update に接続されていることを確認するには、Azure portal のコンプライアンス ビューの [グループ化されていないデバイス] セクションにデバイスが表示されているかどうかを確認します。
Q: 1 つ以上のデバイスが更新に失敗しています。
デバイスの更新エラーの根本原因は多数考えられます。 デバイスが IoT Hub インスタンスに接続されていること、2) Device Update インスタンスに接続されていること、3) 配信の最適化 (DO) サービスが実行されていることを確認してください。 3 つすべてがお使いのデバイスに該当する場合は、「Microsoft サポートへの問い合わせ 」セクションの の手順に従って、Microsoft にサポート リクエストを提出してください。
更新プログラムの展開
Q: デバイスに更新プログラムを展開しましたが、コンプライアンスの状態に最新の更新プログラムが適用されていないことが示されます。 どうしたらいいでしょう。
デバイスのコンプライアンス状態は、更新に最大 5 分かかることがあります。 しばらく待ってから、もう一度確認してください。
Q: デバイスの展開状態が互換性がないと表示されていますが、どうすればよいですか。
デバイスを IoT Hub に接続した後、ターゲット デバイスの製造元とモデルのプロパティが変更され、デバイスが現在のデプロイの更新コンテンツと互換性がないとみなされます。
ADU Core インターフェイスの を確認して、デバイスが Device Update サービスに報告している製造元とモデルを確認し、展開されている更新コンテンツの インポート マニフェスト で指定した製造元とモデルと一致していることを確認します。 Device Update 構成ファイルを使用して、特定のデバイスのこれらのプロパティを変更できます。
Q: 展開が「アクティブ」ステージにあるのに、更新を受けているデバイスがどれも「進行中」と表示されていないことがわかります。 どうしたらいいでしょう。
デプロイの開始日が将来設定されていないことを確認します。 新しいデプロイを作成すると、明示的に変更しない限り、デプロイの開始日はセーフガードとして次の日に既定で設定されます。 展開開始日に達するまで待つか、または進行中の展開をキャンセルし、目的の開始日で新しい展開を作成することができます。
Q: デバイスをグループ化しようとしていますが、グループの作成時にドロップダウンにタグが表示されません。
Device Update リソースのドキュメントに従って、IoT Hub のメッセージ ルート 正しく構成されていることを確認します。 ルートを構成した後、デバイスにもう一度タグを付ける必要があります。
もう 1 つの根本原因は、デバイスを Device Update for IoT Hub に接続する前にタグを適用した可能性があります。 デバイスが既に Device Update に接続されていることを確認します。 デバイスが Device Update for IoT Hub に接続されていることを確認するには、コンプライアンス ビューの [グループ化されていない] デバイスにデバイスが表示されているかどうかを確認します。 別の値のタグを一時的に追加し、デバイスが接続されたら、目的のタグをもう一度追加します。
Device Provisioning Service (DPS) を使用している場合は、デバイスの作成プロセス中ではなく、プロビジョニング後にデバイスにタグを付けます。 デバイスの作成手順中にデバイスに既にタグを付けた場合は、プロビジョニング後にデバイスに別の値で一時的にタグを付け、目的のタグをもう一度追加する必要があります。
Q: デプロイは正常に完了しましたが、一部のデバイスの更新に失敗しました。
これは、失敗したデバイスのクライアント側エラーが原因である可能性があります。 このトラブルシューティング ガイドの「デバイス障害」セクションを参照してください。
Q: デプロイを開始しようとしたときに UX でエラーが発生しました。
これは、サービス/UX のバグ、または API のアクセス許可の問題が原因である可能性があります。 Microsoft サポート に問い合わせる セクションの手順に従って、Microsoft にサポート リクエストを提出してください。
Q: デプロイを開始しましたが、終了状態に達していません。
これは、サービスパフォーマンスの問題、サービスのバグ、またはクライアントのバグが原因である可能性があります。 10 分後にデプロイを再試行してください。 同じ問題が発生した場合は、デバイス ログをプルし、このトラブルシューティング ガイドの「デバイスエラー」セクションを参照してください。 同じ問題が引き続き発生する場合は、「Microsoft サポート に問い合わせる」セクションの手順に従って、Microsoft にサポート リクエストを提出してください。
Q: デバイス レベルのエージェントから、デバイス上のモジュール ID としてエージェントを追加するように移行しましたが、デバイスに適用されている場合でも、更新は "進行中" と表示されます。
デバイス ツイン経由で通信していた古いエージェントを削除しなかった場合、_Thisが発生している可能性があります。 デバイス更新エージェントをモジュールとしてプロビジョニングする場合 (方法を参照)、デバイスとデバイス更新サービス間のすべての通信がモジュール ツイン経由で行われるので、グループ を作成するときにデバイスのモジュール ツインにタグを付け、モジュール ツイン経由ですべての 通信 必要があります。
デバイスへの更新プログラムのダウンロード
Q: 切断後にデバイスが再接続されたときにダウンロードを再開するにはどうすればよいですか?
24 時間以内に接続が復元されると、ダウンロードは自己再開されます。 24 時間後に、ユーザーがダウンロードを再開する必要があります。
Microsoft 接続キャッシュ (MCC) の使用
Q: IoT Edge デバイスに MCC モジュールをデプロイしようとすると、問題が発生します。
IoT Edge デバイスに Edge モジュールをデプロイする については、 IoT Edge のドキュメントを参照してください。 IoT Edge デバイスで MCC モジュールが正常に実行されているかどうかを確認するには、http://localhost:5100/Summary. に移動します。
Q: IoT デバイスの 1 つが MCC 経由で更新プログラムをダウンロードしようとしていますが、失敗しています。
IoT デバイスが MCC への接続に失敗する原因となる可能性のあるいくつかの問題があります。 問題を診断するには、障害が発生したデバイスから DO クライアントと Nginx のログを収集してください (クライアント ログの収集手順については、「microsoft サポート に問い合わせる」セクションを参照してください)。
使用している URL が許可されていないため、デバイスが MCC モジュールに渡すためにインターネットからコンテンツをプルできない可能性があります。 そのかどうかを判断するには、Azure portal で IoT Edge 環境変数を確認する必要があります。
Microsoft サポートへのお問い合わせ
上記の FAQ を使用して解決できない問題が発生した場合は、Azure portal インターフェイスを使用して Microsoft サポートにサポート リクエストを提出できます。 問題が属しているカテゴリによっては、Microsoft サポートによる問題の調査に役立つ追加データの収集と共有が求められる場合があります。
各データ型を収集する方法については、以下を参照してください。 getDevices 使用して、API のペイロード応答に追加情報があるかどうかを確認できます。
さらに、次の情報は、問題の根本原因を絞り込むのに役立ちます。
- 更新しようとしているデバイスの種類 (Azure Percept、IoT Edge ゲートウェイなど)
- 使用している Device Update クライアントの種類 (イメージベース、パッケージベース、シミュレーター)
- デバイスが実行している OS
- デバイスのアーキテクチャに関する詳細
- デバイスの更新機能をこれまでに正常に使用してデバイスを更新したことがあるかどうか
上記の情報のいずれかが利用可能な場合は、問題の説明に含めてください。
クライアント ログの収集
Raspberry Pi デバイスには、次の 2 つのログ セットがあります。
/adu/logs/var/cache/do-client-lite/logパッケージ化されたクライアントの場合、ログは次の場所にあります。
/var/log/adu/var/cache/do-client-lite/logシミュレーターの場合、ログは次の場所にあります。
/tmp/aduc-logs
エラー コード
更新プログラムのインポート、デバイスの障害、または更新プログラムの展開に関連する問題を報告するときに、エラー コードを指定するように求められる場合があります。
エラー コードは、ADUCoreInterface インターフェイスを調べることで取得できます。 自己診断とトラブルシューティングのためにエラー コードを解析する方法については、Device Update のエラー コード ドキュメントを参照してください。
トレース ID
更新プログラムのインポートまたは展開に関連する問題を報告するときに、トレース ID を指定するように求められる場合があります。
特定のユーザー アクションのトレース ID は、API 応答内、または Azure portal ユーザー インターフェイスの [インポート履歴] セクションにあります。
現時点では、デプロイ アクションのトレース ID には、API 応答を介してのみアクセスできます。
デプロイ ID
更新プログラムの展開に関連する問題を報告するときに、デプロイ ID を指定するように求められる場合があります。
デプロイ ID は、API を呼び出してデプロイを開始するときにユーザーによって作成されます。
現在、Azure portal ユーザー インターフェイスから開始されたデプロイのデプロイ ID は自動的に生成され、ユーザーには表示されません。
IoT Hub インスタンス名
デバイスの障害または更新プログラムのデプロイに関連する問題を報告するときに、IoT Hub インスタンスの名前を指定するように求められる場合があります。
IoT Hub 名は、初回プロビジョニング時にユーザーによって選択されます。
Device Update アカウント名
更新プログラムのインポート、デバイスの障害、または更新プログラムの展開に関連する問題を報告するときに、Device Update アカウントの名前を指定するように求められる場合があります。
Device Update アカウント名は、サービスに初めてサインアップするときにユーザーによって選択されます。 詳細については、Device Update リソース ドキュメントを参照してください。
Device Update インスタンス名
更新プログラムのインポート、デバイスの障害、または更新プログラムの展開に関連する問題を報告するときに、Device Update インスタンスの名前を指定するように求められる場合があります。
Device Update インスタンス名は、初回プロビジョニング時にユーザーによって選択されます。 詳細については、Device Update リソース ドキュメントを参照してください。
デバイス識別子
デバイスの障害に関連する問題を報告するとき、または更新プログラムを展開するときに、デバイス ID を指定するように求められる場合があります。
デバイス ID は、デバイスが最初にプロビジョニングされるときに顧客によって定義されます。 デバイスのデバイス ツインから取得することもできます。
更新 ID
更新プログラムの展開に関連する問題を報告するときに、更新プログラム ID を指定するように求められる場合があります。
更新プログラム ID は、デプロイを開始するときに顧客によって定義されます。
Nginx ログ
Microsoft 接続キャッシュに関連する問題を報告するときに、Nginx ログを提供するように求められる場合があります。
ADU-conf.txt
更新プログラムの展開に関連する問題を報告するときに、Device Update 構成ファイル ("adu-conf.txt") を指定するように求められる場合があります。
構成ファイルは省略可能であり、Device Update 構成 ドキュメントの手順に従ってユーザーによって作成されます。
輸入明細書
更新プログラムのインポートまたは配置に関連する問題を報告するときに、インポート マニフェスト ファイルを指定するように求められる場合があります。
インポート マニフェストは、デバイス更新サービスに更新コンテンツをインポートするときに顧客によって作成されたファイルです。