デフォルトでは、IoT Platform コンソールのデバイスログモジュールで、過去 7 日間に生成されたログを表示できます。 また、モジュールから Log Service のログストアにログをエクスポートして永続的に保存することもできます。 ローカルログダンプ機能を有効にすると、IoT Platform コンソールでログのクエリと分析、およびアラートの設定を行うことができます。
前提条件
Android 用 SDK または C 用 SDK を使用してデバイスを開発します。 ログはデバイスによって送信されます。 パスワードのリセット方法の詳細については、「デバイスログレポート」をご参照ください。
デバイスのローカルログレポートが有効になっています。 スイッチをオンにするには、IoT Platform にログインし、次の手順を実行する必要があります。1. を選択します。 2. デバイスリストで必要なデバイスを見つけ、[表示] をクリックします。 3. [デバイスの詳細] ページで、[デバイスのローカルログレポート] をオンにします。
- Log Service がアクティブ化されています。 詳細については、「リソース管理の概要」をご参照ください。
使用上の注意
ログダンプ機能は、Alibaba Cloud アカウントでのみ使用できます。 RAM ユーザーはこの機能を使用できません。
ログダンプ機能が有効になっている場合、ログは Alibaba Cloud Log Service に送信され、保存されます。 Log Service の料金に基づいて、ログストアにログを保存するための料金が発生します。 詳細については、「概要」をご参照ください。
ローカルログダンプ機能を有効にする
複数のプロダクトのログを長期間保存する場合は、プロダクトごとにログダンプ機能を有効にする必要があります。
- IoT Platform コンソール にログインします。
[概要] ページで、[すべての環境] をクリックします。 [すべての環境] タブで、管理するインスタンスを見つけ、インスタンス ID またはインスタンス名をクリックします。
- 左側のナビゲーションウィンドウで、 を選択します。
- プロダクトを選択し、[ローカルログダンプ] タブをクリックします。
- [有効化] をクリックします。
- 画面の指示に従って、ローカルログダンプ機能を有効にします。説明 Log Service がアクティブ化されていない場合は、[有効化] をクリックして Log Service のアクティブ化ページに移動できます。
- 表示されるダイアログボックスで、[作成][ロール] セクションと [ログ保存場所] セクションの横にある をクリックします。説明 作成済み[ロール] セクションと [ログ保存場所] セクションの横に と表示されている場合は、この手順をスキップします。
- [OK] をクリックします。
プロダクトのローカルログダンプ機能を有効にすると、IoT Platform はログのエクスポートに使用するログ保存場所とサービスロールを自動的に作成します。- ログ保存場所：
- プロジェクト:
iot-log-${uid}-${regionId}。${uid}変数を Alibaba Cloud アカウント ID に、${regionId}変数を IoT Platform が存在するリージョンの ID に置き換えます。 - ログストア: [iot-logs-device-local]。
IoT Platform に接続されているプロダクトに属するすべてのデバイスは、同じログ保存場所を共有します。 ProductKey パラメータを使用して、異なるプロダクトのログを区別できます。 詳細については、「ローカルデバイスログ」をご参照ください。
- プロジェクト:
- サービスロール: このロールを使用して、ログをエクスポートするための権限を取得できます。 詳細については、「AliyunServiceRoleForIoTLogExport サービスロール」をご参照ください。
- 表示されるダイアログボックスで、[作成][ロール] セクションと [ログ保存場所] セクションの横にある をクリックします。
- ログの保存期間を指定します。IoT Platform からエクスポートされたログは、保存期間が終了すると削除されます。 保存期間は 1 ～ 3,000 日に設定できます。 デフォルトのログ保存期間は 7 日です。 また、[永続ストレージ] スイッチをオンにして、ログを永続的に保存することもできます。
[ローカルログダンプ] タブで、[ログ保存時間を設定] をクリックします。 表示されるメッセージで、[OK] をクリックします。 [ログストア属性] ページで、[変更] をクリックし、[データ保存期間] パラメータを設定して、[保存] をクリックします。
ログクエリおよび分析機能を使用する
ローカルログダンプ機能を有効にすると、[ローカルログダンプ] タブで次の操作を実行できます。
| 操作 | 説明 |
| ログのクエリと分析 | [未加工ログ] タブでは、SQL 文を使用して指定期間内のログをクエリし、統計分析を実行できます。 SQL 構文の詳細については、「検索構文」および「ログ分析の概要」をご参照ください。 |
| チャートを表示する | [グラフ] タブでは、生成されたチャートを表示できます。 |
| ログを集計する | [logreduce] タブでは、類似のログを集計して、ビジネスのより包括的なビューを取得できます。 |
| クイック分析を実行する | ログをクエリした後、クエリ結果を分析し、結果のフィールドの分布を表示できます。 |
| アラートルールを設定する | アラート条件が満たされると、IoT Platform はショートメッセージ、電話、メール、または DingTalk 通知によってアラートを送信します。 |
ローカルログダンプ機能を無効にする
ストレージ容量を節約するために、必要に応じて特定のプロダクトのローカルログダンプ機能をいつでも無効にすることができます。
- IoT Platform コンソール にログインします。 [概要] ページで、管理するインスタンスを見つけ、インスタンスをクリックします。
- 左側のナビゲーションウィンドウで、 を選択します。
- プロダクトを選択し、[ローカルログダンプ] タブをクリックします。
- [ダンプの停止] をクリックします。 表示されるメッセージで、[OK] をクリックします。ローカルログダンプ機能が無効になると、新しく生成されたローカルデバイスログはログストアにエクスポートされなくなります。 Log Service に既にエクスポートされているログはすぐに削除されません。 指定されたログ保存期間が終了すると削除されます。