翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# CloudWatch Logs を有効にする
Hub SDK は包括的なログ記録機能を提供します。デフォルトでは、Hub SDK はローカルファイルシステムにログを書き込みます。ただし、クラウド API を使用して CloudWatch Logs へのログストリーミングを設定できます。これにより、以下が提供されます。
+ **デバイスのパフォーマンスのモニタリング**: プロアクティブなデバイス管理のために詳細なランタイムログをキャプチャします。デバイスフリート全体で高度なログ分析とモニタリングを有効にする
+ **問題のトラブルシューティング**: 迅速な診断分析のための詳細なログエントリを生成します。詳細な調査のために、システムとアプリケーションレベルのイベントを記録します。
+ **柔軟で一元化されたログ記録**: デバイスに直接アクセスしないリモートログ管理。複数のデバイスからのログを単一の検索可能なリポジトリに集約します。
## 前提条件
+ マネージドデバイスをクラウドにオンボードします。詳細については、「[ハブオンボーディングの設定](managedintegrations-sdk-v2-cookbook-hubsetup.md)」を参照してください。
+ Hub エージェントの起動と正常な初期化を検証します。詳細については、「[マネージド統合 Hub SDK をインストールして検証する](managedintegrations-sdk-v2-cookbook-deployment.md)」を参照してください。
**注記**
ログ記録設定を作成するには、[PutRuntimeLogConfiguration API](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_PutRuntimeLogConfiguration.html) を参照してください。
**警告**
ログを有効にすると、階層化されたクォータの計測にカウントされます。ログレベルを増やすと、メッセージ量が増え、追加コストが発生します。
## Setup Hub SDK ログ設定
API を呼び出してランタイムログ設定を設定することで、ハブ SDK ログ設定を構成します。
**Example サンプル 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 ファイルの例を参照してください。
