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

# Amazon CloudWatch にデバイス側のログをアップロード
<a name="upload-device-logs-to-cloudwatch"></a>

過去のデバイス側のログを Amazon CloudWatch にアップロードして、現場でのデバイスのアクティビティを監視および分析できます。デバイス側のログには、システム、アプリケーション、およびデバイスログファイルを含めることができます。このプロセスでは、CloudWatch Logs ルールアクションパラメータを使用して、デバイス側のログを顧客定義の[ロググループ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)に公開します。

## 仕組み
<a name="upload-process-overview"></a>

このプロセスは、 AWS IoT デバイスがフォーマットされたログファイルを含む MQTT メッセージを AWS IoT トピックに送信したときに開始されます。 AWS IoT ルールはメッセージトピックをモニタリングし、定義した CloudWatch Logs グループにログファイルを送信します。その後、情報を確認して分析できます。

**Topics**
+ [MQTT トピック](#upload-mqtt-topics-overview)
+ [ルールアクション](#upload-rule-action-overview)

### MQTT トピック
<a name="upload-mqtt-topics-overview"></a>

ログの発行に使用する MQTT トピック名前空間を選択します。一般的なトピックスペース、`$aws/rules/things/thing_name/logs` にはこの形式を使用し、エラートピック、`$aws/rules/things/thing_name/logs/errors` にはこの形式を使用することをお勧めします。ログとエラートピックの命名構造は推奨されますが、必須ではありません。詳細については、「[AWS IoT Coreのための MQTT トピックの設計](https://docs.aws.amazon.com/whitepapers/latest/designing-mqtt-topics-aws-iot-core/designing-mqtt-topics-aws-iot-core.html)」を参照してください。

推奨される共通トピックスペースを使用すると、 AWS IoT 基本的な取り込み予約トピックを利用できます。 AWS IoT 基本的な取り込みは、 AWS IoT ルールアクションでサポートされている AWS サービスにデバイスデータを安全に送信します。これにより、パブリッシュ/サブスクライブのメッセージブローカーが取り込みパスから除外され、コスト効率が向上します。詳細については、「[基本的な取り込みによるメッセージングコストの削減](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html)」を参照してください。

batchMode を使用してログファイルをアップロードする場合、メッセージは UNIX タイムスタンプとメッセージを含む特定の形式に従う必要があります。詳細については、「[CloudWatch Logs rule action](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html)」(CloudWatch Logs ルールアクション) 内の「[MQTT message format requirements for batchMode](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html#cloudwatch-logs-rule-action-message-format)」(BatchMode の MQTT メッセージフォーマット要件) トピックを参照してください。

### ルールアクション
<a name="upload-rule-action-overview"></a>

がクライアントデバイスから MQTT メッセージ AWS IoT を受信すると、 AWS IoT ルールはユーザー定義トピックをモニタリングし、定義した CloudWatch ロググループにコンテンツを公開します。このプロセスでは、CloudWatch Logs ルールアクションを使用して MQTT のログファイルのバッチを監視します。詳細については、[CloudWatch Logs](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html) AWS IoT ルールアクション」を参照してください。

#### バッチモード
<a name="upload-batch-mode-overview"></a>

 `batchMode` は、 AWS IoT CloudWatch Logs ルールアクション内のブールパラメータです。このパラメータはオプションで、デフォルトはオフ (`false`) です。デバイス側のログファイルをバッチでアップロードするには、 AWS IoT ルールの作成時にこのパラメータを (`true`) をオンにする必要があります。詳細については、[AWS IoT ルールアクション](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rule-actions.html)セクションの「[CloudWatch Logs](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html)」を参照してください。