CloudWatch Registros - AWS IoT Core
RequisitosRequisitos de formato de mensagem MQTT para batchModeParâmetrosExemplosConsulte também

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á.

CloudWatch Registros

A ação CloudWatch Logs (cloudwatchLogs) envia dados para o Amazon CloudWatch Logs. Você pode usar batchMode para carregar e marcar com data e hora vários registros de log do dispositivo em uma mensagem. Você pode também especificar o grupo de logs para o qual a ação envia dados.

Requisitos

Esta ação de regra tem os seguintes requisitos:

  • Uma função do IAM que você AWS IoT pode assumir para realizar as logs:PutLogEvents operações logs:CreateLogStreamlogs:DescribeLogStreams, e. Para obter mais informações, consulte Conceder a uma AWS IoT regra o acesso que ela exige.

    No AWS IoT console, você pode escolher ou criar uma função para permitir AWS IoT a execução dessa ação de regra.

  • Se você usar uma chave gerenciada pelo cliente AWS KMS key (chave KMS) para criptografar dados de registro no CloudWatch Logs, o serviço deverá ter permissão para usar a chave KMS em nome do chamador. Para obter mais informações, consulte Criptografar dados de log em CloudWatch registros usando AWS KMS o Guia do usuário do Amazon CloudWatch Logs.

Requisitos de formato de mensagem MQTT para batchMode

Se você usar a ação de regra de CloudWatch registros com batchMode desativada, não há requisitos de formatação de mensagens do MQTT. (Nota: o batchMode valor padrão do parâmetro é false.) No entanto, se você usar a ação de regra de CloudWatch registros batchMode ativada (o valor do parâmetro étrue), as mensagens MQTT contendo registros do lado do dispositivo deverão ser formatadas para conter um carimbo de data/hora e uma carga útil da mensagem. Nota: timestamp representa a hora em que o evento ocorreu e é expresso como um número de milissegundos após 1º de janeiro de 1970 00:00:00 UTC.

A seguir está um exemplo do formato de publicação:

[
  {"timestamp": 1673520691093, "message": "Test message 1"}, 
  {"timestamp": 1673520692879, "message": "Test message 2"}, 
  {"timestamp": 1673520693442, "message": "Test message 3"}
]

Dependendo de como os registros do lado do dispositivo são gerados, poderá ser necessário filtrá-los e reformatá-los antes de serem enviados para cumprir este requisito.​ Para obter mais informações, consulte Carga útil da mensagem MQTT.

Independentemente do batchMode parâmetro, o message conteúdo deve estar em conformidade com as limitações de tamanho da AWS IoT mensagem. Para obter mais informações, consulte AWS IoT Core Endpoints e cotas.

Parâmetros

Ao criar uma AWS IoT regra com essa ação, você deve especificar as seguintes informações:

logGroupName

O grupo de CloudWatch registros para o qual a ação envia dados.

Suporta modelos de substituição: API e somente AWS CLI

roleArn

A função do IAM que permite acesso ao grupo de CloudWatch registros. Para obter mais informações, consulte Requisitos.

Compatível com modelos de substituição: Não

(opcional) batchMode

Indica se lotes de registros de log serão extraídos e enviados para. CloudWatch Os valores incluem true ou false (padrão). Para obter mais informações, consulte Requisitos.

Compatível com modelos de substituição: Não

Exemplos

O exemplo de JSON a seguir define uma ação de CloudWatch registros em uma AWS IoT regra.

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "cloudwatchLogs": {
                    "logGroupName": "IotLogs",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_cw",
                    "batchMode": false                    
                }
            }
        ]
    }
}

Consulte também