Azure Sphere デバイスのリモート トラブルシューティングのベスト プラクティス
重要
これは Azure Sphere (レガシ) のドキュメントです。 Azure Sphere (レガシ) は 2027 年 9 月 27 日に 再提供されておりユーザーは現時点で Azure Sphere (統合) に移行する必要があります。 TOC の上にある Version セレクターを使用して、Azure Sphere (統合) のドキュメントを表示します。
デバイスをリモートで管理する際に、デバイスが正常に動作しなくなる問題が発生することがあります。 この記事には、状況のトリアージと問題の特定に役立つ質問とフローチャートの一覧が含まれています。 このガイドを参照すると、デバイスのダウンタイムを短縮し、デバイスを適切な動作に戻すための自己トラブルシューティングをすばやく行うことができます。
Note
手順を実行する必要がある接続インフラストラクチャに対処する暫定的なチェックリストを次に示します。
- Azure Sphere の OS ネットワーク要件に関する手順に従って、Azure Sphere デバイスに必要なエンドポイントを許可するようにネットワーク インフラストラクチャが構成されていることを確認します
- エンドポイントが適切に構成されていることを確認するには、 ソリューションの設計に関する考慮事項で診断チェックを実行します。
- デバイスが Azure Sphere Security Services (AS3) に接続しているかどうかを確認するには、コマンド azsphere device listを実行します。
lastUpdateRequestUTC
フィールドを確認します。これは、デバイスが Azure Sphere Security Services からの更新を最後に要求した時刻を示します。 - カスタム NTP を実行している場合は、NTP サーバーが稼働していて、その時刻が 24 時間のグローバル時刻であり、正しい timezone に設定されていることを確認します。
- アプリケーションの Wi-Fi 構成設定を確認します。
- IoT Hub を確認します。
- IoT Hub 上の Azure Sphere Security Service 証明書が最新であることを確認します。
- IoT Hub サーバーが動作していることを確認します。
- デバイスがハードウェア ソリューションの仕様に従って十分な電力を受け取っていることを確認します。
- Microsoft の NCSI サービスが稼働していて接続されていることを確認します。 (http://www.msftconnecttest.com/connecttest.txt) のリンクを参照してください。
デバイスの正常性の他の側面を確認する前に、次の予備的な質問を検討してください。
影響を受けたデバイスの数 これが唯一のデバイスですか、それとも他のデバイスがありますか?
- 影響を受けるデバイスの数が少ない場合は、そのデバイス ID を取得し、CLI で azsphere tenant download-error-report を実行し、レポートを分析します。 レポート 解釈する方法については エラー データの収集と解釈に関する説明を参照してください。
- 複数のデバイスがある場合は、次のセクションに進みます。
デバイスの正常性をトリアージする
状況のトリアージに役立つ考慮事項を次に示します。
次のフローチャートをトレースして、デバイスの接続を確認します。
まず、ファイアウォールの設定を確認します。 ファイアウォール設定を管理する場合は、ネットワーク設定が Sphere の要件に準拠していることを確認します。 詳細については、「 ネットワークの問題を解決する」を参照してください。 コンプライアンスを確保するには、 Azure Sphere OS のネットワーク要件 のガイダンスに従ってください。 ファイアウォール設定を管理しない場合は、ファイアウォール管理者に連絡して詳細なガイダンスを確認してください。
次に、北方向の接続を確認します。 Wi-Fi を使用してインターネットに接続する場合、デバイスは混雑しているエリアにありますか? その場合は、設定でターゲット スキャンが使用されていることを確認します。 ターゲット スキャンの詳細については、「 WifiConfig_SetTargetedScanEnabled関数」を参照してください。 デバイスが混雑しているエリアにない場合は、Microsoft サポートに連絡して詳細を確認してください。 EAP-TLS を使用していますか? "はい" の場合は、ライフサイクル証明書管理のプロバイダーに問い合わせて、 EAP-TLS 証明書の更新を参照してください。 EAP-TLS を使用しない場合は、SSID またはパスワードが変更されていないことを確認します。
携帯電話を使用してインターネットに接続する場合は、デバイスがネットワークに表示されているかどうかをシステム インテグレーターまたは携帯電話サービス プロバイダーに問い合わせてください。
問題の範囲は何ですか? 次のフローチャートをトレースします。
何個のデバイスで問題が発生していますか? 影響を受けるデバイスが少数の場合は、まず接続フローチャートを確認します。 次に、デバイスの物理環境を確認します。デバイスが取り外されているか、デバイスのハードウェアに何らかの変更が加えられていますか? デバイスが接続されていて、デバイスのハードウェアで変更が行われなかった場合は、2 ~ 3 個のデバイス ID を取得し、コマンド azsphere tenant download-error-report を実行してテナント エラー ログを確認します。 [説明] フィールドを確認します。 説明に次のいずれかが含まれている場合は、お客様のアプリケーション ログで詳細なガイダンスを確認してください。
- AppCrash
- AppUpdate
- AppExit
ただし、説明に次のいずれかが含まれている場合は、Microsoft サポートに連絡してください。
- SystemAppCrash
- カーネル パニック
- Kernel Oops
すべてのデバイスが影響を受けている場合は、次の手順に従います。
- デバイスは最近 OS の更新プログラムを取得しましたか? ある場合は、Microsoft サポートにお問い合わせください。 OS 更新プログラムを実行していない場合は、接続フローチャートを参照してください。 デバイス グループが含まれているソフトウェア チャネル フィードによっては、OS 更新通知を受信している可能性があります。 OS フィードの詳細については、「 Azure Sphere OS フィードを参照してください。
- デバイスは最近アプリケーションの更新プログラムを取得しましたか? 存在する場合は、アプリケーションの以前のバージョンに再デプロイまたはロールバックします。 まだ接続していない場合は、Microsoft サポートにお問い合わせください。 Over-the-air 更新プログラムの詳細については、「 について」を参照してください。
デバイスへの物理的なアクセスを取得できる場合
デバイスに物理的にアクセスできる場合は、次のローカル トラブルシューティング手順を実行できます。
- 特定の場所での接続の問題を除外できますか? たとえば、建物に接続に問題がありますか?
- 接続フローチャートのイーサネット セクションを確認します。 イーサネットを使用してインターネットに接続する場合は、スイッチ ポートを確認します。 スイッチ ポートが点灯している場合は、デバイスの電源を切り替えます。 点灯していない場合は、ファイアウォールの設定を確認します。
- デバイスが取り外されているか、デバイスのハードウェアに何らかの変更が加えられていますか? たとえば、センサーがオーバーサートされているか、USB コネクタが壊れていますか。
- コマンド azsphere get-support-data を実行します。