

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

# Consegna dei log

**Nota**  
Questa operazione non è supportata per le cache serverless.  
Slow Log è supportato per Valkey 7.x e versioni successive e per i cluster e i gruppi di replica Redis OSS che utilizzano il motore dalla versione 6.0 in poi.   
Engine Log è supportato per Valkey 7.x e versioni successive e per i cluster e i gruppi di replica Redis OSS che utilizzano la versione del motore 6.2 in poi.

La distribuzione dei log consente di eseguire lo streaming di [ SLOWLOG ](https://valkey.io/commands/slowlog) o ** Engine Log verso una delle due destinazioni: **
+ Amazon Data Firehose
+ Amazon Logs CloudWatch 

Si abilita e si configura la distribuzione dei log quando si crea o si modifica un cluster utilizzando le ElastiCache API. Ogni voce del registro verrà recapitata alla destinazione specificata in uno dei due formati: *JSON* o *TEXT*.

Un numero fisso di voci di Slow log viene recuperato periodicamente dal motore. A seconda del valore specificato per il parametro del motore`slowlog-max-len`, ulteriori voci di registro lente potrebbero non essere recapitate alla destinazione.

Puoi scegliere di modificare le configurazioni di distribuzione o disabilitare la consegna dei log in qualsiasi momento utilizzando la AWS console o una delle API di modifica, modify-cache-cluster o modify-replication-group[. ](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html) [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) 

È necessario impostare il parametro `apply-immediately` per tutte le modifiche al recapito dei registri.

**Nota**  
 CloudWatch I costi di Amazon Logs si applicano quando la consegna dei log è abilitata, anche quando i log vengono consegnati direttamente ad Amazon Data Firehose. Per ulteriori informazioni, consulta la sezione Vended Logs nei prezzi di [ Amazon CloudWatch . ](https://aws.amazon.com/cloudwatch/pricing/)

## Contenuto di una voce di registro lenta
<a name="Log_contents"></a>

Lo Slow Log contiene le seguenti informazioni: 
+ **CacheClusterId**— L'ID del cluster
+ **CacheNodeId**— L'ID del nodo della cache
+ **Id** – Un identificativo progressivo univoco per ogni voce di registro lenta
+ **Timestamp** – Il timestamp Unix nella quale il comando registrato è stato elaborato
+ **Durata** – La quantità di tempo necessario per la sua esecuzione, in microsecondi
+ **Comando** – Il comando utilizzato dal client. Ad esempio, `set foo bar` `foo` dov'è la chiave e `bar` il valore. ElastiCache sostituisce il nome e il valore effettivi della chiave con `(2 more arguments)` per evitare di esporre dati sensibili.
+ **ClientAddress**— Indirizzo IP e porta del client
+ **ClientName**— Nome del client se impostato tramite il `CLIENT SETNAME` comando 

## Contenuto di una voce del registro motore
<a name="Log_contents-engine-log"></a>

ElastiCache fornisce un sottoinsieme curato di eventi del registro del motore, non il set completo di tutti i log interni del motore. Solo gli eventi operativi significativi, come replica, istantanee, integrità del cluster e scripting, sono inclusi nei log forniti.

I log del motore sono progettati per escludere i dati sensibili. Le informazioni private come indirizzi IP, ID di processo, percorsi di file e corpo degli script vengono cancellate prima della consegna. Nessun dato utente, password, token di autenticazione, nome di chiave o valore viene visualizzato in nessuna voce di registro emessa.

Il registro ElastiCache del motore contiene le seguenti informazioni: 
+ **CacheClusterId**— L'ID del cluster
+ **CacheNodeId**— L'ID del nodo della cache
+ **Livello di registro**: LogLevel può essere uno dei seguenti:`VERBOSE("-")`,`NOTICE("*")`,`WARNING("#")`.
+ **Ora**: l’ora UTC del messaggio registrato. L'ora è nel formato seguente: `"DD MMM YYYY hh:mm:ss.ms UTC"`
+ **Ruolo**: il ruolo del nodo da cui viene emesso il registro. Può essere uno dei seguenti: «M» per Primary, «S» per replica, «C» per writer child process working on RDB/AOF o «X» per sentinel.
+ **Messaggio**: messaggio di registro del motore.

## Autorizzazioni per configurare la registrazione
<a name="Log_permissions"></a>

Devi includere le seguenti autorizzazioni IAM nella tua user/role policy IAM: 
+ `logs:CreateLogDelivery`
+ `logs:UpdateLogDelivery`
+ `logs:DeleteLogDelivery`
+ `logs:GetLogDelivery`
+ `logs:ListLogDeliveries`

Per ulteriori informazioni, consulta [Panoramica delle autorizzazioni e delle policy per la gestione degli accessi](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_access-management.html).

## Specificazioni del tipo di registro e del formato
<a name="Destination_Formats"></a>

### Registro lento
<a name="Destination_Formats-slowlog"></a>

Il registro lento supporta sia JSON che TEXT

Di seguito è riportato un esempio in formato JSON:

```json
{
  "CacheClusterId": "logslowxxxxmsxj", 
  "CacheNodeId": "0001", 
  "Id": 296, 
  "Timestamp": 1605631822, 
  "Duration (us)": 0, 
  "Command": "GET ... (1 more arguments)", 
  "ClientAddress": "192.168.12.104:55452", 
  "ClientName": "logslowxxxxmsxj##" 
}
```

Di seguito è riportato un esempio in formato TEXT:

```
logslowxxxxmsxj,0001,1605631822,30,GET ... (1 more arguments),192.168.12.104:55452,logslowxxxxmsxj## 
```

### Registro motore
<a name="Destination_Formats-engine-log"></a>

Il registro lento supporta sia JSON che TEXT

Di seguito è riportato un esempio in formato JSON:

```json
{ 
  "CacheClusterId": "xxxxxxxxxzy-engine-log-test", 
  "CacheNodeId": "0001", 
  "LogLevel": "VERBOSE", 
  "Role": "M", 
  "Time": "12 Nov 2020 01:28:57.994 UTC", 
  "Message": "Replica is waiting for next BGSAVE before synchronizing with the primary. Check back later" 
}
```

Di seguito è riportato un esempio in formato TEXT:

```
xxxxxxxxxxxzy-engine-log-test/0001:M 29 Oct 2020 20:12:20.499 UTC * A slow-running Lua script detected that is still in execution after 1000 microseconds.
```