Registri delle funzioni Edge - Amazon CloudFront

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 luogo in Regioni AWS cui vengono eseguite le funzioni. Il nome del gruppo di log è formattato come/aws/lambda/us-east-1.function-name: dove function-name è il nome che hai dato alla funzione quando l'hai creata ed us-east-1 è il codice regionale del Regione AWS luogo in cui è stata creata la funzione. Il nome del gruppo di log contiene sempreus-east-1, anche per i gruppi di log di altre regioni in cui viene eseguita la funzione.

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 forma corretta Regione AWS 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 AWS. 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 quanto segue:

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 alle 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 dell'account. CloudWatch Un ruolo collegato ai servizi è un tipo univoco di ruolo IAM collegato direttamente a un servizio AWS . I ruoli collegati ai servizi sono predefiniti dal servizio e includono tutte le autorizzazioni richieste dal servizio per chiamare altri servizi per tuo conto. AWS CloudFront Functions utilizza un ruolo collegato al servizio chiamato. 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 a causa di un errore di convalida o di esecuzione, le informazioni vengono registrate nei log standard e nei CloudFront log in tempo reale. Le informazioni sull'errore vengono registrate nei campi x-edge-result-type, x-edge-response-result-type e x-edge-detailed-result-type.