本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将设备端日志上传到亚马逊 CloudWatch

您可以将设备端的历史日志上传 CloudWatch 到亚马逊，以监控和分析设备的现场活动。 Device-side 日志可以包括系统、应用程序和设备日志文件。此过程使用 CloudWatch 日志规则操作参数将设备端日志发布到客户定义的日志组中。

工作原理

当 AWS IoT 设备向 AWS IoT 主题发送包含格式化日志文件的 MQTT 消息时，该过程开始。 AWS IoT 规则监控消息主题并将日志文件发送到您定义的 CloudWatch 日志组。然后，您可以查看和分析信息。

MQTT 主题

选择要用于发布日志的 MQTT 主题命名空间。我们建议将此格式用于公共主题空间 $aws/rules/things/thing_name/logs，并将此格式用于错误主题 $aws/rules/things/thing_name/logs/errors。建议使用日志和错误主题的命名结构，但不是必需要求。有关更多信息，请参阅为 AWS IoT Core设计 MQTT 主题。

通过使用推荐的公共主题空间，您可以利用 AWS IoT Basic Ingest 保留的主题。 AWS IoT Basic Ingest 安全地将设备数据发送到 AWS IoT 规则操作支持的 AWS 服务。它将 publish/subscribe 消息代理从摄取路径中移除，使其更具成本效益。有关更多信息，请参阅借助基本摄取功能降低消息收发成本。

如果您使用 batchMode 上载日志文件，则您的消息必须遵循包括 UNIX 时间戳和消息的特定格式。有关更多信息，请参阅CloudWatch 日志规则操作中的批处理模式的 MQTT 消息格式要求主题。

规则操作

当从客户端设备 AWS IoT 接收 MQTT 消息时， AWS IoT 规则会监控客户定义的主题并将内容发布到您定义的 CloudWatch 日志组中。此过程使用 CloudWatch 日志规则操作来监控 MQTT 中是否有批量日志文件。有关更多信息，请参阅CloudWatch 日志 AWS IoT 规则操作。

批量模式

batchMode是 “ AWS IoT CloudWatch 日志” 规则操作中的布尔参数。此参数是可选的，默认情况下处于关闭状态 (false)。要批量上传设备端日志文件，必须在创建规则时启用此参数 (true)。 AWS IoT 有关更多信息，请参阅AWS IoT 规则操作部分中的CloudWatch 日志。