As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Faça upload de registros do lado do dispositivo para a Amazon CloudWatch
<a name="upload-device-logs-to-cloudwatch"></a>

Você pode fazer upload de registros históricos do lado do dispositivo na Amazon CloudWatch para monitorar e analisar a atividade de um dispositivo no campo. Os logs do lado do dispositivo podem incluir arquivos de logs do sistema, do aplicativo e do dispositivo. [Esse processo usa um parâmetro de ação de regras de CloudWatch registros para publicar registros do lado do dispositivo em um grupo de registros definido pelo cliente.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) 

## Como funciona
<a name="upload-process-overview"></a>

O processo começa quando um AWS IoT dispositivo envia mensagens MQTT contendo arquivos de log formatados para um AWS IoT tópico. Uma AWS IoT regra monitora o tópico da mensagem e envia os arquivos de log para um grupo de CloudWatch registros definido por você. Em seguida, você pode revisar e analisar as informações.

**Topics**
+ [Tópicos do MQTT](#upload-mqtt-topics-overview)
+ [Ação da regra](#upload-rule-action-overview)

### Tópicos do MQTT
<a name="upload-mqtt-topics-overview"></a>

Escolha um espaço de nome de tópico do MQTT que você usará para publicar os logs. Recomendamos usar esse formato para o espaço de tópicos comuns,`$aws/rules/things/thing_name/logs`, e esse formato para tópicos de erro, `$aws/rules/things/thing_name/logs/errors`. A estrutura de nomenclatura para logs e tópicos de erro é recomendada, mas não obrigatória. Para obter mais informações, consulte [Elaboração de tópicos MQTT para AWS IoT Core](https://docs.aws.amazon.com/whitepapers/latest/designing-mqtt-topics-aws-iot-core/designing-mqtt-topics-aws-iot-core.html). 

Ao usar o espaço de tópico comum recomendado, você utiliza tópicos reservados do AWS IoT Basic Ingest. AWS IoT O Basic Ingest envia com segurança os dados do dispositivo para os AWS serviços que são suportados por AWS IoT ações de regras. Ele remove o agente de publish/subscribe mensagens do caminho de ingestão, tornando-o mais econômico. Para obter mais informações, consulte [Reduzir custos do sistema de mensagens com a ingestão básica no](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html). 

Se você usa o BatchMode para carregar arquivos de log, suas mensagens devem seguir um formato específico que inclua um carimbo de data/hora e uma mensagem do UNIX. Para obter mais informações, consulte o tópico [Requisitos de formato de mensagem MQTT para BatchMode em Ação de](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html#cloudwatch-logs-rule-action-message-format) regra de [CloudWatch registros](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html). 

### Ação da regra
<a name="upload-rule-action-overview"></a>

Quando AWS IoT recebe as mensagens MQTT dos dispositivos cliente, uma AWS IoT regra monitora o tópico definido pelo cliente e publica o conteúdo em um grupo de CloudWatch registros definido por você. Esse processo usa uma ação de regra de CloudWatch registros para monitorar o MQTT em lotes de arquivos de log. Para obter mais informações, consulte a ação da AWS IoT regra de [CloudWatch registros](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html).

#### Modo Batch
<a name="upload-batch-mode-overview"></a>

 `batchMode`é um parâmetro booleano dentro da ação da regra AWS IoT CloudWatch Logs. Esse parâmetro é opcional e está desativado (`false`) por padrão. Para carregar arquivos de log do lado do dispositivo em lotes, você deve ativar esse parâmetro (`true`) ao criar a regra. AWS IoT Para obter mais informações, consulte [CloudWatch Registros](https://docs.aws.amazon.com/iot/latest/developerguide/cloudwatch-logs-rule-action.html) na seção de [ações de AWS IoT regras](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rule-actions.html).