CloudWatch Logs を有効にする - のマネージド統合 AWS IoT Device Management
前提条件Setup Hub SDK ログ設定

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CloudWatch Logs を有効にする

Hub SDK は包括的なログ記録機能を提供します。デフォルトでは、Hub SDK はローカルファイルシステムにログを書き込みます。ただし、クラウド API を使用して CloudWatch Logs へのログストリーミングを設定できます。CloudWatch Logs は以下を提供します。

  • デバイスのパフォーマンスのモニタリング: プロアクティブなデバイス管理のために詳細なランタイムログをキャプチャします。デバイスフリート全体で高度なログ分析とモニタリングを有効にする

  • 問題のトラブルシューティング: 迅速な診断分析のための詳細なログエントリを生成します。システムとアプリケーションレベルのイベントを記録して、詳細な調査を行います。

  • 柔軟で一元化されたログ記録: デバイスに直接アクセスしないリモートログ管理。複数のデバイスからのログを単一の検索可能なリポジトリに集約します。

前提条件

注記

ログ記録設定を作成するには、PutRuntimeLogConfiguration API を参照してください。

警告

ログを有効にすると、階層化されたクォータの計測にカウントされます。ログレベルを増やすと、メッセージ量が増え、追加コストが発生します。

Setup Hub SDK ログ設定

API を呼び出してランタイムログ設定を設定することで、ハブ SDK ログ設定を構成します。

例 サンプル API リクエスト
aws iot-managed-integrations put-runtime-log-configuration \
    --managed-thing-id MANAGED_THING_ID \
    --runtime-log-configurations LogLevel=DEBUG,UploadLog=TRUE

RuntimeLogConfigurations 属性

次の属性はオプションであり、 RuntimeLogConfigurations API で設定できます。

LogLevel

ランタイムトレースの最小重要度レベルを設定します。値: DEBUG, ERROR, INFO, WARN

デフォルト: WARN (リリースされたビルド）

LogFlushLevel

ローカルストレージへの即時データフラッシュの重要度レベルを決定します。値: DEBUG, ERROR, INFO, WARN

デフォルト: DISABLED

LocalStoreLocation

ランタイムトレースのストレージの場所を指定します。デフォルト: /var/log/awsiotmi

  • アクティブなログ: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.log

  • ローテーションされたログ: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.N.log (N はローテーションの順序を示します）

LocalStoreFileRotationMaxBytes

現在のファイルが指定されたサイズを超えると、ファイルのローテーションをトリガーします。

重要

最適な効率を得るには、ファイルサイズを 125 KB 未満に保ちます。125 KB を超える値は自動的に制限されます。

LocalStoreFileRotationMaxFiles、

ログデーモンで許可されるローテーションファイルの最大数を設定します。

UploadLog

クラウドへのランタイムトレース転送を制御します。ログは /aws/iotmanagedintegration CloudWatch Logs グループに保存されます。

デフォルト: false。

UploadPeriodMinutes

ランタイムトレースのアップロード頻度を定義します。デフォルト: 5

DeleteLocalStoreAfterUpload

アップロード後のファイルの削除を制御します。デフォルト: true

注記

false に設定すると、アップロードされたファイルの名前は次のように変更されます。 /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.uploaded.{uploaded_timestamp}

ログファイルの例

以下の CloudWatch Logs ファイルの例を参照してください。

UploadLog の cloudwatch ログの例