すべてのプロダクト
Search

このプロダクト

    IoT Platform:IoT Platformログのダンプ

    ドキュメントセンター

    IoT Platform:IoT Platformログのダンプ

    最終更新日:Apr 17, 2025

    デフォルトでは、IoT PlatformコンソールのDevice Logモジュールで過去7日間に生成されたログを表示できます。 モジュールからLog ServiceのLogstoreにログをエクスポートして、永続的に保存することもできます。 IoT Platformログダンプ機能を有効にすると、IoT Platformコンソールでログのクエリと分析、ログレポートの表示とサブスクライブ、アラートの設定ができます。

    前提条件

    Log Service が有効化されていること。 詳細については、「リソース管理の概要」をご参照ください。

    使用上の注意

    ログダンプ機能は、Alibaba Cloudアカウントでのみ使用できます。 RAMユーザーはこの機能を使用できません。

    ログダンプ機能が有効になると、ログはAlibaba Cloud log Serviceに送信され、保存されます。 Log Serviceの料金に基づいて、Logstoreにログを保存する場合に課金されます。 詳細については、「概要」をご参照ください。

    IoT Platformログダンプ機能の有効化

    複数の製品のログを長期間保存する場合は、各製品のログダンプ機能を有効にする必要があります。

    1. IoT Platformコンソールにログインします。

    2. [概要] ページで、[すべての環境] をクリックします。 [すべての環境] タブで、管理するインスタンスを見つけ、インスタンスIDまたはインスタンス名をクリックします。

    3. 左側のナビゲーションウィンドウで、[メンテナンス] > [デバイスログ] を選択します。
    4. プロダクトを選択し、[IoT Platformログダンプ] タブをクリックします。
    5. [有効化] をクリックします。
    6. 画面上の指示に従って、IoT Platformログダンプ機能を有効にします。
      説明 Log Serviceが有効化されていない場合は、[有効化] をクリックしてLog Serviceの有効化ページに移動します。
      1. 表示されるダイアログボックスで、[ロール] および [ログストレージの場所] セクションの横にある [作成] をクリックします。
        説明 [ロール] セクションと [ログストレージの場所] セクションの横に [作成済み] が表示されている場合は、この手順をスキップします。
      2. [OK] をクリックします。
      プロダクトのIoT Platformログダンプ機能を有効にすると、IoT Platformはログの保存場所と、ログのエクスポートに使用されるサービスにリンクされたロールを自動的に作成します。
      • サービスにリンクされたロール: このロールを使用して、ログをエクスポートする権限を取得できます。 詳細については、「AliyunServiceRoleForIoTLogExportサービスのリンクロール」をご参照ください。
      • ログの保存場所:
        • プロジェクト: iot-log-${uid}-${regionId} ${uid} 変数をAlibaba CloudアカウントIDに置き換え、${regionId} 変数をIoT Platformが存在するリージョンのIDに置き換えます。
        • Logstore: iot-logs

        IoT Platformに接続されているすべての製品は、ログの保存場所を共有します。 ProductKeyに基づいて、製品のログを識別できます。 詳細については、「IoT Platformログ」をご参照ください。

    7. ログの保存期間を指定します。
      IoT Platformからエクスポートされたログは、保存期間が終了すると削除されます。 保持期間は1〜3,000日に設定できます。 デフォルトのログ保存期間は7日です。 Permanent Storageスイッチをオンにして、ログを永続的に保持することもできます。

      [IoT Platformログダンプ] タブで、[ログ保存時間の設定] をクリックします。 表示されたメッセージボックスで [OK] をクリックします。 Logstore属性ページで、[変更] をクリックし、[データ保持期間] パラメーターを設定し、[保存] をクリックします。

    ログクエリと分析機能の使用

    IoT Platformログダンプ機能を有効にすると、[IoT Platformログダンプ] タブで次の操作を実行できます。

    • 生ログ:
      API 操作説明
      データのクエリと分析[Rawログ] タブでは、SQL文を使用して、指定した期間内のログを照会し、統計分析を実行できます。 SQL構文の詳細については、「検索構文」および「ログ分析の概要」をご参照ください。
      チャートの表示[グラフ] タブでは、生成されたグラフを表示できます。
      集計ログ[LogReduce] タブでは、同様のログを集約し、ビジネスのより包括的なビューを取得できます。
      クイック分析の実行ログをクエリした後、クエリ結果を分析し、結果のフィールドの分布を表示できます。
      アラートルールの設定アラート条件が満たされると、IoT Platformはテキストメッセージ、電話、電子メール、またはDingTalk通知でアラートを送信します。
    • ログレポート:
      API 操作説明
      レポートの表示指定した時間範囲のログレポートを表示できます。 ログレポートには、デバイスのステータスと例外が反映されます。 ログレポートの詳細については、さまざまなログレポートについて説明している次の表をご参照ください。

      デフォルトでは、ログレポートには、その時間で開始および終了する最後の1時間のデータが表示されます。 データは、折れ線グラフで1分間隔で収集されます。

      • 時間範囲を指定するには、[ログレポート] タブの右上隅にある [時間範囲] をクリックするか、グラフの右上隅にある [More icon> [時間範囲の選択] を選択します。
      • 折れ線グラフの解像度を変更するには、[生ログ] タブに移動し、指定された間隔で収集されたデータをクエリするSQL文を作成します。 SQL構文の詳細については、「日付と時刻の関数」をご参照ください。

        たとえば、次のステートメントを使用して時間間隔を1時間に設定できます。bizCode:device | SELECT date_format(date_trunc('hour' ,__ time__), '% m-% d % H:% i') AS time, count (1) AS count , operation GROUP BY Time, operation ORDER BY Time limit 1440

      Subscribe to reportsIoT Platformは定期的にレポートを画像に変換し、電子メールまたはDingTalkチャットボットを使用して指定された連絡先に画像を送信します。
      表1. ログレポート
      レポートチャートタイプ説明
      数回デバイスオンライン&オフライン折れ線グラフ折れ線グラフは、デバイスがIoT Platformに接続された回数と、指定された期間内にデバイスがIoT Platformから切断された回数を示しています。
      デバイスのアップリンクとダウンリンクのメッセージ折れ線グラフ折れ線グラフは、指定された期間内のアップストリームメッセージの数とダウンストリームメッセージの数を示しています。
      Uplink&Downlinkメッセージによる上位20台のデバイスListこのリストには、最も上流または下流のメッセージを送受信する上位20台のデバイスと、各デバイスのメッセージ数が表示されます。
      データ解析スクリプトのエラー分散円グラフ円グラフは、指定された期間におけるデータ解析エラーの分布を示しています。

      エラーコードでログを照会し、ログ内のデータ解析エラーの詳細を表示できます。 これにより、データ解析スクリプトを効果的に改善できます。

      データ解析スクリプトエラーによる上位10台のデバイスListこのリストには、最も多くのデータ解析エラーが発生した上位10台のデバイスと、指定された期間内に各デバイスで発生したエラーの数が表示されます。

      デバイス名でログを照会し、ログ内のデータ解析エラーの詳細を表示できます。 これにより、データ解析スクリプトを効果的に改善できます。

      TSL検証のエラー分散円グラフ円グラフは、指定された期間におけるThing Specification Language (TSL) 検証エラーの分布を示しています。

      エラーコードによるログの照会、ログ内のTSL検証エラーの詳細の表示、およびエラーのトラブルシューティングを行うことができます。

      TSL検証エラーによるトップ10デバイスListこのリストには、TSL検証エラーが最も多く発生した上位10台のデバイスと、指定された期間内に各デバイスで発生したエラーの数が表示されます。

      デバイス名でログを照会し、ログ内のTSL検証エラーの詳細を表示し、エラーのトラブルシューティングを行うことができます。

      サーバー側のサブスクリプションメッセージの転送折れ線グラフ折れ線グラフは、指定された期間内にAdvanced Message Queuing Protocol (AMQP) またはMessage Service (MNS) サーバー側サブスクリプションによって転送されたメッセージの総数を示しています。
      過去20回のデバイス異常メッセージ円グラフ円グラフは、過去20回のデバイスエラーメッセージを示しています。

      デバイス名とエラーコードでログを照会し、ログ内のデバイスエラーメッセージの詳細を表示し、エラーのトラブルシューティングを行うことができます。

      クラウドサービスメッセージ転送折れ線グラフ折れ線グラフは、指定された期間内にデータ転送機能によって転送されたメッセージの総数を示しています。
      過去20回のデータ転送エラーListこのリストには、指定された期間内のルールエンジンの最後の20のデータ転送エラーが表示されます。

      デバイス名とエラーコードでログを照会し、ルールエンジンのデータ転送エラーの詳細をログに表示し、エラーのトラブルシューティングを行うことができます。

      Cloud API呼び出しのエラー分散円グラフ円グラフは、指定された期間におけるAPI呼び出しのエラーの分布を示しています。

      API操作名でログを照会し、ログの詳細とエラーコードに基づいてエラーをトラブルシューティングできます。

    IoT Platformログダンプ機能を無効にする

    ストレージ容量を節約するために、必要に応じていつでも特定の製品のIoT Platformログダンプ機能を無効にできます。

    1. IoT Platformコンソールにログインします。 [概要] ページで、管理するインスタンスを見つけ、インスタンスをクリックします。
    2. 左側のナビゲーションウィンドウで、[メンテナンス] > [デバイスログ] を選択します。
    3. プロダクトを選択し、[IoT Platformログダンプ] タブをクリックします。
    4. [停止ダンプ] をクリックします。 表示されたメッセージボックスで、[OK] をクリックします。
      IoT Platformログダンプ機能を無効にすると、新しく生成されたIoT PlatformログはLogstoreにエクスポートされなくなります。 すでにLog Serviceにエクスポートされているログはすぐには削除されません。 指定したログの保存期間が終了すると削除されます。