本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將裝置端日誌上傳到 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)。

如果您使用批次模式來上傳日誌檔案，您的訊息必須遵循包含 UNIX 時間戳記和訊息的特定格式。如需詳細資訊，請參閱 [CloudWatch Logs 規則動作](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html)中的[批次模式 MQTT 訊息格式要求](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html#cloudwatch-logs-rule-action-message-format)主題。

### 規則動作
<a name="upload-rule-action-overview"></a>

當 從用戶端裝置 AWS IoT 接收 MQTT 訊息時， 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 規則動作中的布林值參數。這個參數是可選的，預設情況下是 off (`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)。