Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# CloudWatch Registri
<a name="cloudwatch-logs-rule-action"></a>

L'azione CloudWatch Logs (`cloudwatchLogs`) invia dati ad Amazon CloudWatch Logs. Puoi utilizzare `batchMode` per caricare e indicare data e ora di più record di log del dispositivo in un unico messaggio. Puoi anche specificare il gruppo di log in cui l'azione invia i dati.

## Requisiti
<a name="cloudwatch-logs-rule-action-requirements"></a>

Questa operazione della regola presenta i seguenti requisiti:
+ Un ruolo IAM che AWS IoT può assumere di eseguire le operazioni `logs:CreateLogStream``logs:DescribeLogStreams`, e`logs:PutLogEvents`. Per ulteriori informazioni, consulta [Concedere a qualsiasi AWS IoT regola l'accesso richiesto](iot-create-role.md).

  Nella AWS IoT console, puoi scegliere o creare un ruolo per consentire l'esecuzione di questa azione relativa AWS IoT alla regola.
+ Se si utilizza una chiave gestita dal cliente AWS KMS key (chiave KMS) per crittografare i dati di registro in CloudWatch Logs, il servizio deve disporre dell'autorizzazione a utilizzare la chiave KMS per conto del chiamante. Per ulteriori informazioni, [consulta Encrypt log data in CloudWatch Logs using AWS KMS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/encrypt-log-data-kms.html) nella *Amazon CloudWatch Logs* User Guide.

## Requisiti relativi al formato del messaggio MQTT per `batchMode`
<a name="cloudwatch-logs-rule-action-message-format"></a>

Se utilizzi l'azione della regola CloudWatch Logs con `batchMode` disattivata, non ci sono requisiti di formattazione dei messaggi MQTT. Nota: il valore predefinito del parametro `batchMode` è `false`. Tuttavia, se si utilizza l'azione della regola CloudWatch Logs con `batchMode` attivata (il valore del parametro è`true`), i messaggi MQTT contenenti registri lato dispositivo devono essere formattati in modo da contenere un timestamp e un payload dei messaggi. **Nota:** `timestamp` rappresenta l'ora in cui si è verificato l'evento ed è espressa come numero di millisecondi dopo le ore 00:00:00 UTC del 1° gennaio 1970.

Di seguito è riportato un esempio del formato di pubblicazione:

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

A seconda di come vengono generati i log lato dispositivo, potrebbe essere necessario filtrarli e riformattarli prima che vengano inviati per soddisfare questo requisito. Per ulteriori informazioni, consulta [Payload del messaggio MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topicdata.html).

Indipendentemente dal parametro, i contenuti devono rispettare i limiti di dimensione dei messaggi. `batchMode` `message` AWS IoT Per ulteriori informazioni, consulta [Endpoint e quote per AWS IoT Core](https://docs.aws.amazon.com/general/latest/gr/iot-core.html).

## Parameters
<a name="cloudwatch-logs-rule-action-parameters"></a>

Quando si crea una AWS IoT regola con questa azione, è necessario specificare le seguenti informazioni:

`logGroupName`  
Il gruppo di CloudWatch log a cui l'azione invia i dati.  
Supporta [modelli sostitutivi](iot-substitution-templates.md): API e solo AWS CLI 

`roleArn`  
Il ruolo IAM che consente l'accesso al gruppo di CloudWatch log. Per ulteriori informazioni, consulta [Requisiti](#cloudwatch-logs-rule-action-requirements).   
Supporta [modelli di sostituzione](iot-substitution-templates.md): no

`batchMode` (facoltativo)  
 Indica se i batch di record di registro verranno estratti e caricati in. CloudWatch I valori includono `true` o `false` (impostazione predefinita). Per ulteriori informazioni, consulta [Requisiti](#cloudwatch-logs-rule-action-requirements).   
Supporta [modelli di sostituzione](iot-substitution-templates.md): no

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

Il seguente esempio JSON definisce un'azione CloudWatch Logs in una regola. AWS IoT 

```
{
    "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                    
                }
            }
        ]
    }
}
```

## Consulta anche
<a name="cloudwatch-logs-rule-action-see-also"></a>
+ [Che cos'è Amazon CloudWatch Logs?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/) nella Guida per l'*utente di Amazon CloudWatch Logs*