Registri delle funzioni Edge - Amazon CloudFront
Registri di Lambda@EdgeCloudFront Registri delle funzioni

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

Puoi usare Amazon CloudWatch Logs per ottenere i log delle tue funzioni edge, sia Lambda @Edge che Functions. CloudFront 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 .

Registri di Lambda@Edge

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 del gruppo di log predefinito <FunctionName> è /aws/lambda/<FunctionName> where è 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 richiamata la funzione.

  • Se si specifica un nome di gruppo di log personalizzato, ad esempio Lambda @Edge/MyLogGroup, non aggiungerà il prefisso Region. Il nome del gruppo di log rimane lo stesso in tutte le altre regioni in cui viene richiamata la funzione.

Nota

Se crei un gruppo di log personalizzato e specifichi lo stesso nome di default/aws/lambda/<FunctionName>, Lambda @Edge aggiunge il us-east-1 prefisso al nome della funzione.

Oltre a personalizzare il nome del gruppo di log, le funzioni Lambda @Edge supportano i formati di log JSON e in testo semplice e il filtraggio a livello di log. Per ulteriori informazioni, consulta Configurazione dei controlli di registrazione avanzati per la funzione Lambda nella Guida per gli sviluppatori.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:

CloudFront Registri delle funzioni

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 settentrionaleus-east-1), indipendentemente dalla posizione periferica in cui è stata eseguita la funzione. Il nome del gruppo di log è nel formato /aws/cloudfront/function/<FunctionName> dove <FunctionName> è il nome assegnato alla funzione al momento della creazione. Il nome del flusso di log è nel formato YYYY/M/D/UUID.

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
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, 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 (IAM) per inviare i log ai registri del tuo account. CloudWatch Un ruolo collegato al servizio è un 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 utilizza lo stesso ruolo collegato al servizio).

Quando una funzione fallisce con un errore di convalida o un errore di esecuzione, le informazioni vengono registrate nei log standard e nei log in tempo reale. Per informazioni specifiche sull'errore, consulta i x-edge-result-type campi, e. x-edge-response-result-type x-edge-detailed-result-type