

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

# Registri delle funzioni Edge
<a name="edge-functions-logs"></a>

[Puoi usare Amazon CloudWatch Logs per ottenere i log delle tue funzioni edge, sia [Lambda](lambda-at-the-edge.md) @Edge che Functions. CloudFront ](cloudfront-functions.md) Puoi accedere ai log utilizzando la CloudWatch console o l'API Logs. CloudWatch 

**Importante**  
Ti consigliamo di utilizzare i log per comprendere la natura delle richieste relative ai tuoi contenuti, non come contabilità completa di tutte le richieste. CloudFront fornisce i registri delle funzioni Edge con la massima diligenza possibile. È possibile che la voce di log per una specifica richiesta venga distribuita molto tempo dopo l'elaborazione effettiva della richiesta e, in rari casi, che non venga distribuita affatto. Quando una voce di log viene omessa dai log delle funzioni edge, il numero di voci nei log delle funzioni edge non corrisponderà all'utilizzo visualizzato nei report di utilizzo e fatturazione di AWS .

**Topics**
+ [Registri di Lambda@Edge](#lambda-at-edge-logs)
+ [CloudFront Registri delle funzioni](#cloudfront-function-logs)

## Registri di Lambda@Edge
<a name="lambda-at-edge-logs"></a>

Lambda @Edge invia automaticamente i log delle funzioni ai CloudWatch registri, creando flussi di log nel punto in Regioni AWS cui vengono richiamate le funzioni. Quando crei o modifichi una funzione in AWS Lambda, puoi utilizzare il nome del gruppo di CloudWatch log predefinito o personalizzarlo.
+ Il nome predefinito del gruppo di log è `/aws/lambda/<FunctionName>`, dove `<FunctionName>` è il nome specificato al momento della creazione della funzione. Quando si inviano i log a CloudWatch, Lambda @Edge aggiungerà automaticamente `us-east-1` il prefisso al nome della funzione, in modo che il nome del gruppo di log sia. `/aws/lambda/us-east-1.<FunctionName>` Questo prefisso corrisponde al luogo in Regione AWS cui è stata creata la funzione. Questo prefisso rimane parte del nome del gruppo di log, anche in altre regioni in cui viene invocata la funzione. 
+ Se si specifica un nome di gruppo di log personalizzato, come `/MyLogGroup`, Lambda@Edge non aggiungerà il prefisso Regione. Il nome del gruppo di log rimane lo stesso in tutte le altre regioni in cui viene invocata la funzione.

**Nota**  
Se si crea un gruppo di log personalizzato e si specifica lo stesso nome di quello predefinito `/aws/lambda/<FunctionName>`, Lambda@Edge aggiunge il prefisso `us-east-1` al nome della funzione.

Oltre alla personalizzazione del nome del gruppo di log, le funzioni Lambda@Edge supportano i formati di log JSON e testo normale e il filtraggio a livello di log. Per ulteriori informazioni, consulta [Configurazione dei controlli di registrazione di log avanzati per la funzione Lambda](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs-advanced.html) nella *Guida per gli sviluppatori di AWS Lambda *.

**Nota**  
Lambda@Edge sottopone a throttling i log in base al volume di richieste e alla dimensione dei log.

È necessario esaminare i file di CloudWatch registro nella regione corretta per visualizzare i file di registro delle funzioni Lambda @Edge. Per vedere le regioni in cui è in esecuzione la funzione Lambda @Edge, visualizza i grafici delle metriche per la funzione nella console. CloudFront I parametri vengono visualizzati per ogni regione . Nella stessa pagina, puoi scegliere una regione e quindi visualizzare i file di registro per tale regione, in modo da analizzare i problemi.

Per ulteriori informazioni su come utilizzare CloudWatch i log con le funzioni Lambda @Edge, consulta i seguenti argomenti:
+ Per ulteriori informazioni sulla visualizzazione dei grafici nella sezione **Monitoraggio** della CloudFront console, consulta. [Monitora le CloudFront metriche con Amazon CloudWatch](monitoring-using-cloudwatch.md)
+ Per informazioni sulle autorizzazioni necessarie per inviare dati ai CloudWatch registri, vedere. [Configurazione di ruoli e autorizzazioni IAM per Lambda@Edge](lambda-edge-permissions.md)
+ Per informazioni sull'aggiunta della registrazione a una funzione Lambda@Edge, consulta [Registrazione della funzione AWS Lambda in Node.js](https://docs.aws.amazon.com/lambda/latest/dg/nodejs-logging.html) o [Registrazione della funzione AWS Lambda in Python](https://docs.aws.amazon.com/lambda/latest/dg/python-logging.html) nella *Guida per gli sviluppatori di AWS Lambda *.
+ *Per informazioni sulle quote di CloudWatch Logs (precedentemente note come limiti), consulta Logs [CloudWatch quotas nella Amazon Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html) User Guide. CloudWatch *

## CloudFront Registri delle funzioni
<a name="cloudfront-function-logs"></a>

Se il codice di una CloudFront funzione contiene `console.log()` istruzioni, CloudFront Functions invia automaticamente queste righe di registro a CloudWatch Logs. Se non ci sono `console.log()` istruzioni, non viene inviato nulla a CloudWatch Logs.

CloudFront Functions crea sempre flussi di log nella regione () degli Stati Uniti orientali (Virginia settentrionale`us-east-1`), indipendentemente dalla posizione periferica in cui è stata eseguita la funzione. Il nome del flusso di log è nel formato `YYYY/M/D/UUID`.

Il nome del gruppo di log utilizza il seguente formato:
+ Per CloudFront le funzioni a livello di comportamento della cache, il formato è `/aws/cloudfront/function/<FunctionName>`
+ Per CloudFront le funzioni a livello di distribuzione (Funzioni di connessione), il formato è `/aws/cloudfront/connection-function/<FunctionName>`

`<FunctionName>`è il nome che hai dato alla funzione quando l'hai creata.

**Example Richieste del visualizzatore**  
Di seguito viene illustrato un esempio di messaggio di registro inviato a CloudWatch Logs. Ogni riga inizia con un ID che identifica in modo univoco una richiesta. CloudFront Il messaggio inizia con una `START` riga che include l'ID di CloudFront distribuzione e termina con una `END` riga. Tra le righe `START` e `END` vi sono le righe di log generate dalle istruzioni `console.log()` nella funzione.  

```
U7b4hR_RaxMADupvKAvr8_m9gsGXvioUggLV5Oyq-vmAtH8HADpjhw== START DistributionID: E3E5D42GADAXZZ
U7b4hR_RaxMADupvKAvr8_m9gsGXvioUggLV5Oyq-vmAtH8HADpjhw== Example function log output
U7b4hR_RaxMADupvKAvr8_m9gsGXvioUggLV5Oyq-vmAtH8HADpjhw== END
```

**Example Richieste di connessione**  
Di seguito viene illustrato un esempio di messaggio di registro inviato a CloudWatch Logs. Ogni riga inizia con un ID che identifica in modo univoco una richiesta. CloudFront Il messaggio inizia con una `START` riga che include l'ID di CloudFront distribuzione e termina con una `END` riga. Tra le righe `START` e `END` vi sono le righe di log generate dalle istruzioni `console.log()` nella funzione.  

```
U7b4hR_RaxMADupvKAvr8_m9gsGXvioUggLV5Oyq-vmAtH8HADpjhw== START DistributionID: E3E5D42GADA123
U7b4hR_RaxMADupvKAvr8_m9gsGXvioUggLV5Oyq-vmAtH8HADpjhw== 1.2.3.4
U7b4hR_RaxMADupvKAvr8_m9gsGXvioUggLV5Oyq-vmAtH8HADpjhw== END
```

**Nota**  
CloudFront Functions invia i log CloudWatch solo per le funzioni nella `LIVE` fase in cui viene eseguita in risposta alle richieste e alle risposte di produzione. Quando [testate una funzione](test-function.md), CloudFront non invia alcun registro a. CloudWatch L'output del test contiene informazioni sugli errori, sull'utilizzo del calcolo e sui registri delle funzioni (`console.log()`istruzioni), ma queste informazioni non vengono inviate a. CloudWatch

CloudFront Functions utilizza un [ruolo collegato al servizio AWS Identity and Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) (IAM) per inviare i log ai registri del tuo account. CloudWatch Un ruolo collegato ai servizi è un tipo univoco di ruolo IAM collegato direttamente a un Servizio AWS. I ruoli collegati al servizio sono predefiniti dal servizio e includono tutte le autorizzazioni richieste dal servizio per chiamare altri utenti. Servizi AWS CloudFront Functions utilizza il ruolo collegato al servizio. **AWSServiceRoleForCloudFrontLogger** Per ulteriori informazioni su questo ruolo, consulta [Ruoli collegati ai servizi per Lambda@Edge](lambda-edge-permissions.md#using-service-linked-roles-lambda-edge) (Lambda@Edge utilizza lo stesso ruolo collegato al servizio).

[Quando una funzione fallisce a causa di un errore di convalida o di esecuzione, le informazioni vengono registrate nei log [standard e nei log](AccessLogs.md) di accesso in tempo reale.](real-time-logs.md) Per informazioni specifiche sull’errore, consulta i campi `x-edge-result-type`, `x-edge-response-result-type` e `x-edge-detailed-result-type`.