Azure IoT Central のトラブルシューティング

[アーティクル]
02/07/2024

この記事には、IoT Central アプリケーションでのデバイス接続の問題とデータエクスポートの構成に関する問題のトラブルシューティングガイダンスが含まれています。

デバイス接続の問題

このセクションは、データが IoT Central に到達しているかどうかを確認するのに役立ちます。

az cli ツールと azure-iot 拡張機能をまだインストールしていない場合はインストールします。

az cli のインストール方法については、「Azure CLI のインストール」を参照してください。

azure-iot 拡張機能をインストールするには、次のコマンドを実行します。

az extension add --name azure-iot

Note

拡張コマンドを初めて実行するときに、uamqp ライブラリをインストールするように求められる場合があります。

azure-iot 拡張機能をインストールしたら、デバイスを起動して、送信しているメッセージが、IoT Central に送信されているかどうかを確認します。

次のコマンドを使用して、IoT Central アプリケーションを含むサブスクリプションにサインインします。

az login
az account set --subscription <your-subscription-id>

デバイスから送信されているテレメトリを監視するには、次のコマンドを使用します。

az iot central diagnostics monitor-events --app-id <iot-central-app-id> --device-id <device-name>

デバイスが IoT Central に正常に接続されている場合、次の例のような出力が表示されます。

Monitoring telemetry.
Filtering on device: device-001
{
    "event": {
        "origin": "device-001",
        "module": "",
        "interface": "",
        "component": "",
        "payload": {
            "temp": 65.57910343679293,
            "humid": 36.16224660107426
        }
    }
}

デバイスと IoT Central の間で交換されているプロパティの更新を監視するには、次のプレビューコマンドを使用します。

az iot central diagnostics monitor-properties --app-id <iot-central-app-id> --device-id <device-name>

デバイスからプロパティの更新が正常に送信されている場合、次の例のような出力が表示されます。

Changes in reported properties:
version : 32
{'state': 'true', 'name': {'value': {'value': 'Contoso'}, 'status': 'completed', 'desiredVersion': 7, 'ad': 'completed', 'av': 7, 'ac
': 200}, 'brightness': {'value': {'value': 2}, 'status': 'completed', 'desiredVersion': 7, 'ad': 'completed', 'av': 7, 'ac': 200}, 'p
rocessorArchitecture': 'ARM', 'swVersion': '1.0.0'}

ターミナルにデータが表示される場合、データは IoT Central アプリケーションまで到達しています。

数分経ってもデータが表示されない場合、出力がスタックしている可能性があるので、キーボードの Enter キーまたは return キーを押します。

それでもターミナルにデータが表示されない場合は、デバイスでネットワーク接続の問題が発生しているか、データが IoT Central に正しく送信されていない可能性があります。

デバイスのプロビジョニング状態を確認する

データが CLI モニターに表示されていない場合は、次のコマンドを実行して、デバイスのプロビジョニング状態を確認します。

az iot central device registration-info --app-id <iot-central-app-id> --device-id <device-name>

次の出力は、接続がブロックされているデバイスの例を示しています。

{
  "@device_id": "v22upeoqx6",
  "device_registration_info": {
    "device_status": "blocked",
    "display_name": "Environmental Sensor - v22upeoqx6",
    "id": "v22upeoqx6",
    "instance_of": "urn:krhsi_k0u:modelDefinition:w53jukkazs",
    "simulated": false
  },
  "dps_state": {
    "error": "Device is blocked from connecting to IoT Central application. Unblock the device in IoT Central and retry. Learn more:
https://aka.ms/iotcentral-docs-dps-SAS",
    "status": null
  }
}

デバイスのプロビジョニング状態	説明	考えられる軽減策
プロビジョニング済み	すぐに認識できる問題はありません。	該当なし
Registered	デバイスがまだ IoT Central に接続されていません。	デバイスログを調べて、接続の問題の有無を確認します。
ブロック	デバイスは、IoT Central への接続をブロックされています。	デバイスは、IoT Central アプリケーションへの接続をブロックされています。 IoT Central でデバイスのブロックを解除して、再試行します。詳しくは、「デバイスの状態の値」をご覧ください。
未承認	デバイスが承認されていません。	デバイスは、IoT Central アプリケーションへの接続を承認されていません。 IoT Central でデバイスを承認し、再試行します。詳しくは、「デバイスの状態の値」をご覧ください
未割り当て	デバイスがデバイステンプレートに割り当てられていません。	IoT Central でデータの解析方法を認識できるように、デバイスをデバイステンプレートに割り当てます。

詳しくは、UI でのデバイスの状態値と REST API でのデバイスの状態値に関する記述を参照してください。

エラーコード

データが monitor-eventsに表示されない原因をまだ突き止められない場合は、次の手順として、デバイスによって報告されるエラーコードを調べます。

デバイスでデバッグセッションを開始するか、デバイスからログを収集します。デバイスによって報告されるエラーコードがあるかどうかを確認します。

次の表は、一般的なエラーコードと考えられる軽減措置を示しています。

認証フローに関連する問題が発生している場合:

エラーコード	説明	考えられる軽減策
400	要求の本文が無効です。たとえば、解析できないか、オブジェクトを検証できない場合です。	確実に構成証明フローの過程で正しい要求本文を送信するか、デバイス SDK を使用します。
401	認証トークンを検証できません。たとえば、有効期限切れの場合や、要求の URI に適用されない場合などです。また、このエラーコードは、TPM 構成証明フローの過程でデバイスに返されます。	確実に正しい資格情報がデバイスに含まれるようにします。
404	デバイスプロビジョニングサービスのインスタンス、または登録などのリソースが存在しません。	カスタマーサポートにチケットを提出してください。
412	要求の `ETag` が、RFC7232 に従って、既存のリソースの `ETag` と一致しません。	カスタマーサポートにチケットを提出してください。
429	サービスで操作が調整されています。サービスの具体的な制限については、「IoT Hub Device Provisioning Service の制限」を参照してください。	メッセージの頻度を削減し、より多くのデバイス間で責任を分割します。
500	内部エラーが発生しました。	カスタマーサポートにチケットを提出して、さらにサポートを受けられるかどうかを確認します。

詳細な承認エラーコード

Error	サブエラーコード	メモ
401 権限がありません	401002	デバイスが無効または期限切れの資格情報を使用しています。このエラーは DPS によって報告されます。
401 権限がありません	400209	デバイスがオペレーターによる承認を待っているか、オペレーターによってブロックされました。
401 IoTHubUnauthorized		デバイスが期限切れのセキュリティトークンを使用しています。このエラーは IoT Hub によって報告されています。
401 IoTHubUnauthorized	DEVICE_DISABLED	この IoT ハブではデバイスが無効になり、別の IoT ハブに移動されました。デバイスを再プロビジョニングします。
401 IoTHubUnauthorized	DEVICE_BLOCKED	オペレーターによってこのデバイスがブロックされました。

ファイルのアップロードに関するエラーコード

デバイスによってファイルがクラウドにアップロードされようとしたときに、表示される可能性のある一般的なエラーコードのリストを以下に示します。デバイスでファイルをアップロードする前に、アプリケーションで、デバイスファイルのアップロードを構成する必要があります。

エラーコード	説明	考えられる軽減策
403006	同時に実行可能なファイルアップロード操作の数が上限を超えています。各デバイスクライアントは、同時ファイルアップロード数が 10 個に制限されています。	ファイルアップロード操作が完了したことがデバイスから IoT Central に即座に通知されるようにします。それでもうまくいかない場合は、要求タイムアウトを下げてみてください。

モデル化されていないデータの問題

デバイスから IoT Central にデータが送信されていることを確認したら、次のステップとして、確実に有効な形式でデバイスからデータが送信されるようにします。

問題が含まれるカテゴリを見つけるには、シナリオに最も適した Azure CLI コマンドを実行します。

テレメトリを検証するには、次のプレビューコマンドを使用します。

az iot central diagnostics validate-messages --app-id <iot-central-app-id> --device-id <device-name>

プロパティの更新を検証するには、次のプレビューコマンドを使用します。

az iot central diagnostics validate-properties --app-id <iot-central-app-id> --device-id <device-name>

validate コマンドを初めて実行するときに、uamqp ライブラリをインストールするように求められる場合があります。

デバイスデータが IoT Central に表示されない原因には、一般的に次の 3 種類の問題があります。

デバイステンプレートとデバイスデータの不一致。
データが無効な JSON。
IoT Edge のバージョンが古いと、コンポーネントのテレメトリがモデル化されていないデータとして表示され正しくありません。

デバイステンプレートとデバイスデータの不一致

デバイスは、送信するペイロード内のテレメトリフィールド名に、デバイステンプレートで使用されているのと同じ名前と文字種 (大文字/小文字) を使用する必要があります。次の出力は、デバイスが Temperature と呼ばれるテレメトリ値 (temperature であるべき時に) を送信している場合の警告メッセージの例を示しています。

Validating telemetry.
Filtering on device: sample-device-01.
Exiting after 300 second(s), or 10 message(s) have been parsed (whichever happens first).
[WARNING] [DeviceId: sample-device-01] [TemplateId: urn:modelDefinition:ofhmazgddj:vmjwwjuvdzg] Device is sending data that has not been defined in the device template. Following capabilities have NOT been defined in the device template '['Temperature']'. Following capabilities have been defined in the device template (grouped by components) '{'thermostat1': ['temperature', 'targetTemperature', 'maxTempSinceLastReboot', 'getMaxMinReport'], 'thermostat2': ['temperature', 'targetTemperature', 'maxTempSinceLastReboot', 'getMaxMinReport'], 'deviceInformation': ['manufacturer', 'model', 'swVersion', 'osName', 'processorArchitecture', 'processorManufacturer', 'totalStorage', 'totalMemory']}'.

デバイスは、送信するペイロード内のどのプロパティ名にも、デバイステンプレートで使用されているのと同じ名前と文字種 (大文字/小文字) を使用する必要があります。次の出力は、プロパティ osVersion がデバイステンプレートで定義されていない場合の警告メッセージの例を示しています。

Command group 'iot central diagnostics' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
[WARNING]  [DeviceId: sample-device-01] [TemplateId: urn:modelDefinition:ofhmazgddj:vmjwwjuvdzg] Device is sending data that has not been defined in the device template. Following capabilities have NOT been defined in the device template '['osVersion']'. Following capabilities have been defined in the device template (grouped by components) '{'thermostat1': ['temperature', 'targetTemperature', 'maxTempSinceLastReboot', 'getMaxMinReport', 'rundiagnostics'], 'thermostat2': ['temperature', 'targetTemperature', 'maxTempSinceLastReboot', 'getMaxMinReport', 'rundiagnostics'], 'deviceInformation': ['manufacturer', 'model', 'swVersion', 'osName', 'processorArchitecture', 'processorManufacturer', 'totalStorage', 'totalMemory']}'.

デバイスは、どのテレメトリまたはプロパティ値にも、デバイステンプレートで定義されているデータ型を使用する必要があります。たとえば、デバイステンプレートで定義されている型がブール値であるのに、デバイスが文字列を送信する場合、スキーマの不一致が表示されます。次の出力は、double 型として定義されているプロパティでデバイスが文字列値を使用する場合のエラーメッセージの例を示しています。

Command group 'iot central diagnostics' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Validating telemetry.
Filtering on device: sample-device-01.
Exiting after 300 second(s), or 10 message(s) have been parsed (whichever happens first).
[ERROR] [DeviceId: sample-device-01] [TemplateId: urn:modelDefinition:ofhmazgddj:vmjwwjuvdzg]  Datatype of telemetry field 'temperature' does not match the datatype double. Data sent by the device : curr_temp. For more information, see: https://aka.ms/iotcentral-payloads

複数のインターフェイスで同じテレメトリ名が定義されているのに、デバイスが IoT プラグアンドプレイに準拠していない場合にも、検証コマンドはエラーを報告します。

GUI を使用する場合は、IoT Central の 生データ ビューを使用して、モデル化されていないものがないかどうかを確認します。

問題が検出された場合、デバイスのファームウェアを更新するか、以前にモデル化されていないデータをモデル化する新しいデバイステンプレートを作成することが必要になる場合があります。

データを正しくモデル化する新しいテンプレートの作成を選択した場合は、デバイスを古いテンプレートから新しいテンプレートに移行します。詳細については、「Azure IoT Central アプリケーションでデバイスを管理する」を参照してください。

無効な JSON

エラーが報告されないのに、値が表示されない場合は、デバイスが送信するペイロード内の JSON の形式に誤りがある可能性があります。詳細については、「テレメトリ、プロパティ、およびコマンドのペイロード」を参照してください。

デバイスから形式に誤りがある JSON が送信されている場合、検証コマンドまたは UI の生データ表示を利用して検出を行うことができません。

IoT Edge のバージョン

IoT Edge モジュールでホストされているコンポーネントのテレメトリを正しく表示するには、IoT Edgeバージョン1.2.4以降を使用します。以前のバージョンを使用している場合、IoT Edge モジュール内のコンポーネントのテレメトリは _unmodeleddata として表示されます。

データエクスポートのマネージド ID に関する問題

エクスポート先への接続を承認するために、マネージド ID を使用しています。データがエクスポート先に到着していません。

エクスポート先を構成または有効にする前に、次の手順を完了していることを確認してください。

IoT Central アプリケーションのマネージド ID を有効にします。マネージド ID が有効になっていることを確認するには、Azure portal でアプリケーションの [ID] ページに移動するか、次の CLI コマンドを使用します。
```
az iot central app identity show --name {your app name} --resource-group {your resource group name}
```

マネージド ID のアクセス許可を構成する。割り当てられたアクセス許可を表示するには、Azure portal にあるアプリの [ID] ページで、[Azure ロールの割り当て] を選択するか、az role assignment list CLI コマンドを使用します。必要なアクセス許可は次のとおりです。

宛先	アクセス許可
Azure Blob Storage	ストレージ BLOB データ共同作成者
Azure Service Bus	Azure Service Bus データ送信者
Azure Event Hubs	Azure Event Hubs データ送信者
Azure Data Explorer	管理者

IoT Central アプリケーションで宛先を作成する前にアクセス許可が正しく設定されていない場合は、宛先を削除してから、もう一度追加してみてください。

任意の仮想ネットワーク、プライベートエンドポイント、およびファイアウォールポリシーを構成する。

Note

マネージド ID を使用してエクスポート先への接続を承認している場合、IoT Central はシミュレートされたデバイスからデータをエクスポートしません。

詳細については、データのエクスポートに関する記事を参照してください。

データエクスポート先の接続に関する問題

エクスポート定義ページには、エクスポート先への接続で失敗したものに関する情報が表示されます。

Screenshot that shows an example export error.

データエクスポートのデータ欠落の問題

データエクスポートは、データエクスポートを有効にした後にアプリケーションに到着したデータのみをエクスポートします。データのエクスポートが一時的にオフになっている間に見逃された履歴データまたはデータをエクスポートする必要がある場合は、IoT Central REST API を使用してデバイステレメトリのクエリを実行できます。クエリを使用して欠落しているデータを取得し、エクスポート先にデータを追加します。詳細については、「IoT Central REST API を使用してデバイスに対しクエリを実行する方法」を参照してください。

次のステップ

さらにサポートが必要な場合は、Microsoft Q&A と Stack Overflow フォーラムで Azure エキスパートにお問い合わせください。または、Azure サポートチケットを送信することもできます。

詳細については、「Azure IoT のサポートとヘルプのオプション」を参照してください。

Azure IoT Central のトラブルシューティング

デバイス接続の問題

デバイスのプロビジョニング状態を確認する

エラー コード

詳細な承認エラー コード

ファイルのアップロードに関するエラー コード

モデル化されていないデータの問題

デバイス テンプレートとデバイス データの不一致