Fazer o upload de logs do lado do dispositivo no Amazon CloudWatch

Você pode fazer upload de logs históricos do lado do dispositivo no 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 das regras do CloudWatch Logs para publicar logs do lado do dispositivo em um grupo de logs definido pelo cliente.

Como funciona

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

Tópicos do MQTT

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.

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 mensagens de publicação/assinatura 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.

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 na ação de regra do CloudWatch Logs.

Ação da regra

Quando AWS IoT recebe as mensagens MQTT dos dispositivos do cliente, uma regra AWS IoT monitora o tópico definido pelo cliente e publica o conteúdo em um grupo de logs do CloudWatch definido por você. Esse processo usa uma ação de regra do CloudWatch Logs para monitorar lotes de arquivos de log no MQTT. Para obter mais informações, consulte a ação da regra CloudWatch Logs AWS IoT.

Modo Batch

batchMode é um parâmetro booleano dentro da ação de regra do 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 Logs na seção AWS IoT de ações de regra.