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 registri
**Nota**
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 il motore dalla versione 6.2 in poi.
**La distribuzione dei log consente di eseguire lo streaming di [SLOWLOG o Engine Log verso](https://valkey.io/commands/slowlog) una delle due destinazioni:**
+ Amazon Data Firehose
+ CloudWatch Registri Amazon
Puoi abilitare e configurare la consegna dei log quando crei o modifichi un cluster utilizzando ElastiCache APIs. Ogni voce del registro verrà recapitata alla destinazione specificata in uno dei due formati: *JSON* o *TEXT*.
Un numero fisso di voci 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 consegna o disabilitare la consegna dei log in qualsiasi momento utilizzando la AWS console o una delle opzioni di modifica APIs, oppure [modify-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html). [modify-replication-group](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 Vend Logs in [Amazon CloudWatch ](https://aws.amazon.com/cloudwatch/pricing/) Pricing.
## Contenuto di una voce di registro lenta
Lo Slow Log contiene le seguenti informazioni:
+ **CacheClusterId**— L'ID del cluster
+ **CacheNodeId**— L'ID del nodo di 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 dove `bar` è il valore. ElastiCache sostituisce il nome e il valore della chiave effettivi con `(2 more arguments)` per evitare l'esposizione di 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
Il registro ElastiCache del motore contiene le seguenti informazioni:
+ **CacheClusterId**— L'ID del cluster
+ **CacheNodeId**— L'ID del nodo di 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 on working on RDB/AOF o «X» per Sentinel.
+ **Messaggio: messaggio** di registro del motore.
## Autorizzazioni per configurare la registrazione
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
### Registro lento
Il registro lento supporta sia JSON che TEXT
Di seguito è riportato un esempio in formato 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
Il registro lento supporta sia JSON che TEXT
Di seguito è riportato un esempio in formato 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.
```
# ElastiCache destinazioni di registrazione
Questa sezione descrive le destinazioni di registrazione che è possibile scegliere per i ElastiCache registri. Ogni sezione fornisce indicazioni per configurare la registrazione per il tipo di destinazione e informazioni su qualsiasi comportamento specifico del tipo di destinazione. Dopo aver configurato la destinazione di registrazione, puoi fornire le relative specifiche alla configurazione di ElastiCache registrazione per iniziare a registrarla.
**Topics**
+ [CloudWatch Registri Amazon](#Destination_Specs_CloudWatch_Logs)
+ [Amazon Data Firehose](#Destination_Specs_Kinesis_Firehose_Stream)
## CloudWatch Registri Amazon
+ CloudWatch Specifichi un gruppo di log Logs in cui verranno consegnati i log.
+ I log di più cluster e gruppi di replica Valkey o Redis OSS possono essere consegnati allo stesso gruppo di log.
+ Verrà creato un nuovo flusso di log per ogni nodo all'interno di un cluster o di un gruppo di replica e i log verranno consegnati ai rispettivi flussi di log. Il nome del flusso di registrazione utilizzerà il formato seguente: `elasticache/${engine-name}/${cache-cluster-id}/${cache-node-id}/${log-type}`
**Autorizzazioni per pubblicare i log in Logs CloudWatch **
È necessario disporre delle seguenti impostazioni di autorizzazione per configurare l'invio di log ElastiCache a un gruppo di log Logs: CloudWatch
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"logs:CreateLogDelivery",
"logs:GetLogDelivery",
"logs:UpdateLogDelivery",
"logs:DeleteLogDelivery",
"logs:ListLogDeliveries"
],
"Resource": [
"*"
],
"Effect": "Allow",
"Sid": "ElastiCacheLogging"
},
{
"Sid": "ElastiCacheLoggingCWL",
"Action": [
"logs:PutResourcePolicy",
"logs:DescribeResourcePolicies",
"logs:DescribeLogGroups"
],
"Resource": [
"*"
],
"Effect": "Allow"
}
]
}
```
------
Per ulteriori informazioni, vedere [Logs sent to Logs. CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-CWL)
## Amazon Data Firehose
+ Si specifica un flusso di distribuzione Firehose in cui verranno consegnati i log.
+ I log provenienti da più cluster e gruppi di replica Valkey o Redis OSS possono essere inviati allo stesso flusso di distribuzione.
+ I log di ogni nodo all'interno di un cluster o di un gruppo di replica verranno recapitati allo stesso flusso di distribuzione. È possibile distinguere i messaggi di registro da nodi di cache differenti in base al `cache-cluster-id` e `cache-node-id` inclusi in ogni messaggio di registro.
+ La consegna dei registri a Firehose non è attualmente disponibile nella regione Asia Pacifico (Osaka).
**Autorizzazioni per la pubblicazione dei log su Firehose**
È necessario disporre delle seguenti autorizzazioni per configurare l'invio di log ElastiCache a un flusso di distribuzione di Amazon Kinesis Data Firehose.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"logs:CreateLogDelivery",
"logs:GetLogDelivery",
"logs:UpdateLogDelivery",
"logs:DeleteLogDelivery",
"logs:ListLogDeliveries"
],
"Resource": [
"*"
],
"Effect": "Allow",
"Sid": "ElastiCacheLogging"
},
{
"Sid": "ElastiCacheLoggingFHSLR",
"Action": [
"iam:CreateServiceLinkedRole"
],
"Resource": "*",
"Effect": "Allow"
},
{
"Sid": "ElastiCacheLoggingFH",
"Action": [
"firehose:TagDeliveryStream"
],
"Resource": "arn:aws:iam::*:role/*",
"Effect": "Allow"
}
]
}
```
------
# Specifica della consegna del registro tramite la console
Utilizzando il è Console di gestione AWS possibile creare un cluster Valkey o Redis OSS (modalità cluster disabilitata) seguendo i passaggi indicati [Creazione di un cluster Valkey (modalità cluster disabilitata) (console)](SubnetGroups.designing-cluster-pre.valkey.md#Clusters.Create.CON.valkey-gs) o creare un cluster Valkey o Redis OSS (modalità cluster abilitata) utilizzando i passaggi indicati in. [Creazione di un cluster Valkey o Redis OSS (modalità cluster abilitata) (Console)](Clusters.Create.md#Clusters.Create.CON.RedisCluster) In entrambi i casi, è possibile configurare la consegna dei registri eseguendo le operazioni seguenti;
1. **In **Impostazioni avanzate**, scegli **Logs, quindi seleziona **Slow** logs** o Engine logs.**
1. In **Formato del registro**, scegliere **Text** o **JSON**.
1. In **Tipo di destinazione**, scegli **CloudWatch Logs** o **Kinesis Firehose**.
1. In **Destinazione del registro**, scegli **Crea nuovo** e inserisci il nome del bucket Amazon S3, il nome del gruppo di CloudWatchLogs log o il nome dello stream Kinesis Data Firehose, oppure **scegli Seleziona esistente e quindi scegli** il nome del gruppo Logs o CloudWatch il nome dello stream Kinesis Data Firehose,
**Quando si modifica un cluster:**
Puoi scegliere di enable/disable registrare la consegna o modificare il tipo, il formato o la destinazione di destinazione:
1. Accedi alla console e apri la ElastiCache console all'indirizzo [https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/home).
1. Dal pannello di navigazione, scegli i cluster **Valkey o i cluster** **Redis OSS**.
1. Nell'elenco di cluster, scegliere quello da dimensionare. Seleziona **Cluster name (Nome del cluster)** e non la casella di controllo accanto ad essa.
1. Sul **Cluster name (Nome del cluster)** Scegliere la scheda **registro**.
1. **Per enable/disable rallentare i log, scegli Abilita i log lenti o **Disabilita i log lenti**.**
1. **Per visualizzare i registri enable/disable del motore, scegli Abilita i registri del motore o **Disabilita i registri del motore**.**
1. Per modificare la configurazione, scegli **Modifica registri lenti** o **Modifica registri motore**:
+ In **Tipo di destinazione**, scegli **CloudWatch Logs** o **Kinesis Firehose**.
+ In **Destinazione del registro**, scegli **Crea nuovo** e inserisci il nome del gruppo di CloudWatchLogs log o il nome dello stream Kinesis Data Firehose. Oppure scegli **Seleziona esistente**, quindi scegli il nome del gruppo di CloudWatchLogs log o il nome dello stream Kinesis Data Firehose.
# Specificare la consegna dei registri utilizzando il AWS CLI
**Registro lento**
Creare un gruppo di replica con consegna lenta dei log ai CloudWatch registri.
Per Linux, macOS o Unix:
```
aws elasticache create-replication-group \
--replication-group-id test-slow-log \
--replication-group-description test-slow-log \
--engine redis \
--cache-node-type cache.r5.large \
--num-cache-clusters 2 \
--log-delivery-configurations '{
"LogType":"slow-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Per Windows:
```
aws elasticache create-replication-group ^
--replication-group-id test-slow-log ^
--replication-group-description test-slow-log ^
--engine redis ^
--cache-node-type cache.r5.large ^
--num-cache-clusters 2 ^
--log-delivery-configurations '{
"LogType":"slow-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Modifica un gruppo di replica per fornire log lenti a Logs CloudWatch
Per Linux, macOS o Unix:
```
aws elasticache modify-replication-group \
--replication-group-id test-slow-log \
--apply-immediately \
--log-delivery-configurations '
{
"LogType":"slow-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Per Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id test-slow-log ^
--apply-immediately ^
--log-delivery-configurations '
{
"LogType":"slow-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Modificare un gruppo di replica per disabilitare la consegna lenta dei registri
Per Linux, macOS o Unix:
```
aws elasticache modify-replication-group \
--replication-group-id test-slow-log \
--apply-immediately \
--log-delivery-configurations '
{
"LogType":"slow-log",
"Enabled":false
}'
```
Per Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id test-slow-log ^
--apply-immediately ^
--log-delivery-configurations '
{
"LogType":"slow-log",
"Enabled":false
}'
```
**Registro motore**
Crea un gruppo di replica con consegna dei log del motore a Logs. CloudWatch
Per Linux, macOS o Unix:
```
aws elasticache create-replication-group \
--replication-group-id test-slow-log \
--replication-group-description test-slow-log \
--engine redis \
--cache-node-type cache.r5.large \
--num-cache-clusters 2 \
--log-delivery-configurations '{
"LogType":"engine-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Per Windows:
```
aws elasticache create-replication-group ^
--replication-group-id test-slow-log ^
--replication-group-description test-slow-log ^
--engine redis ^
--cache-node-type cache.r5.large ^
--num-cache-clusters 2 ^
--log-delivery-configurations '{
"LogType":"engine-log",
"DestinationType":"cloudwatch-logs",
"DestinationDetails":{
"CloudWatchLogsDetails":{
"LogGroup":"my-log-group"
}
},
"LogFormat":"json"
}'
```
Modificare un gruppo di replica per inviare il registro del motore a Firehose
Per Linux, macOS o Unix:
```
aws elasticache modify-replication-group \
--replication-group-id test-slow-log \
--apply-immediately \
--log-delivery-configurations '
{
"LogType":"engine-log",
"DestinationType":"kinesis-firehose",
"DestinationDetails":{
"KinesisFirehoseDetails":{
"DeliveryStream":"test"
}
},
"LogFormat":"json"
}'
```
Per Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id test-slow-log ^
--apply-immediately ^
--log-delivery-configurations '
{
"LogType":"engine-log",
"DestinationType":"kinesis-firehose",
"DestinationDetails":{
"KinesisFirehoseDetails":{
"DeliveryStream":"test"
}
},
"LogFormat":"json"
}'
```
Modifica di un gruppo di replica per passare al formato motore
Per Linux, macOS o Unix:
```
aws elasticache modify-replication-group \
--replication-group-id test-slow-log \
--apply-immediately \
--log-delivery-configurations '
{
"LogType":"engine-log",
"LogFormat":"json"
}'
```
Per Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id test-slow-log ^
--apply-immediately ^
--log-delivery-configurations '
{
"LogType":"engine-log",
"LogFormat":"json"
}'
```
Modifica di un gruppo di replica per disabilitare la consegna registri motore
Per Linux, macOS o Unix:
```
aws elasticache modify-replication-group \
--replication-group-id test-slow-log \
--apply-immediately \
--log-delivery-configurations '
{
"LogType":"engine-log",
"Enabled":false
}'
```
Per Windows:
```
aws elasticache modify-replication-group ^
--replication-group-id test-slow-log ^
--apply-immediately ^
--log-delivery-configurations '
{
"LogType":"engine-log",
"Enabled":false
}'
```