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 name="cloudwatch-logs-rule-action"></a>

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
<a name="cloudwatch-logs-rule-action-requirements"></a>

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:CreateLogStream``logs:DescribeLogStreams`, e. Para obter mais informações, consulte [Conceder a uma AWS IoT regra o acesso que ela exige](iot-create-role.md).

  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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/encrypt-log-data-kms.html) o *Guia do usuário do Amazon CloudWatch Logs*.

## Requisitos de formato de mensagem MQTT para `batchMode`
<a name="cloudwatch-logs-rule-action-message-format"></a>

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](https://docs.aws.amazon.com/iot/latest/developerguide/topicdata.html).

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](https://docs.aws.amazon.com/general/latest/gr/iot-core.html).

## Parâmetros
<a name="cloudwatch-logs-rule-action-parameters"></a>

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](iot-substitution-templates.md): 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](#cloudwatch-logs-rule-action-requirements).   
Compatível com [modelos de substituição](iot-substitution-templates.md): 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](#cloudwatch-logs-rule-action-requirements).   
Compatível com [modelos de substituição](iot-substitution-templates.md): Não

## Exemplos
<a name="cloudwatch-logs-rule-action-examples"></a>

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
<a name="cloudwatch-logs-rule-action-see-also"></a>
+ [O que é o Amazon CloudWatch Logs?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/) no *Guia do usuário do Amazon CloudWatch Logs*