ゲートウェイやサブデバイスなどのデバイスは、ログをクラウドにレポートできます。IoT Platform コンソールの Simple Log Service ページでオンプレミスデバイスログをクエリして、問題をトラブルシューティングします。
前提条件
- デバイスは Android SDK または C SDK を使用して開発され、ログをレポートするように設定されています。詳細については、「デバイスログのレポート」をご参照ください。
- デバイスに SDK を使用して実装されたログレポートスイッチがある場合は、 に移動します。対象のデバイスを見つけて [表示] をクリックします。[デバイス詳細] ページで、[オンプレミスデバイスログのレポート] スイッチをオンにします。デバイスにログレポートスイッチがない場合、この手順は不要です。
オンプレミスデバイスログのクエリ
- IoT Platform コンソールにログインします。
[概要] ページで、管理するインスタンスを見つけ、インスタンス ID またはインスタンス名をクリックします。
- 左側のナビゲーションウィンドウで、 をクリックします。
- プロダクトを選択し、[オンプレミスデバイスログ] タブをクリックします。
- 検索条件を入力し、検索アイコンをクリックします。
次の表に、利用可能な検索条件を示します。
検索条件 説明 DeviceName デバイス名を入力して、デバイスに関連するログを検索します。 TraceId トレース ID を入力して、リンクされたモジュール間のログを検索します。 モジュール名のキーワード モジュール名を入力して、そのモジュールが生成したログを検索します。 コンテンツのキーワード ログコンテンツからキーワードを入力します。サポートされているキーワードには、API リクエストのリクエストパラメーター、エラー理由、メッセージ ID (MessageID)、クライアント ID (clientId)、操作 (Operation) が含まれます。 時間範囲 ログがレポートされた時間範囲を選択します。
ログフィールド
各ログエントリには、次のフィールドが含まれています。
| パラメーター | 説明 |
| レポート時間 | デバイスがログをレポートした時間。 |
| 収集時間 | デバイスがログを収集した時間。 |
| TraceId | トレース ID。これを使用して、リンクされたモジュール間のログを検索できます。 |
| DeviceName | デバイス名。 |
| ログレベル | デフォルトでは、すべてのレベルのログが表示されます。レベルでログをフィルターできます。ログレベルは、OTHER を除き、重要度の降順で表示されます：
|
| モジュール名 | ログを生成したモジュールの名前。
|
| コンテンツ | 詳細なログコンテンツ。 |
デバイスログの分析
各ログエントリには、Code パラメーターで指定された結果の状態コードが含まれています。この状態コードに基づいてログを分析できます。
エラーコードには、デバイス側 SDK によって生成されるもの (Android SDK エラーコードおよびC SDK エラーコード) またはカスタム状態コードがあります。