Configurazione dei controlli di registrazione avanzati per le funzioni Lambda

Per avere un maggiore controllo sul modo in cui i log delle tue funzioni vengono acquisiti, elaborati e utilizzati, Lambda offre le seguenti opzioni di configurazione della registrazione:

Per ulteriori informazioni sulla configurazione dei controlli di registrazione avanzati, consulta le seguenti sezioni:

Configurazione JSON e formati di registro in testo semplice

L'acquisizione degli output dei log come coppie di valori JSON chiave semplifica la ricerca e il filtraggio durante il debug delle funzioni. Con i log JSON formattati, puoi anche aggiungere tag e informazioni contestuali ai tuoi log. Questo può aiutarti a eseguire analisi automatizzate di grandi volumi di dati di log. A meno che il flusso di lavoro di sviluppo non si basi su strumenti esistenti che utilizzano i log Lambda in formato testo semplice, si consiglia di selezionare JSON il formato di registro.

Per tutti i runtime gestiti da Lambda, puoi scegliere se inviare i log di sistema della funzione a CloudWatch Logs in formato testo semplice o non strutturato. JSON I log di sistema sono i log generati da Lambda e a volte vengono chiamati log eventi della piattaforma.

Per i runtime supportati, quando si utilizza uno dei metodi di registrazione integrati supportati, Lambda può anche generare i log delle applicazioni della funzione (i log generati dal codice della funzione) in formato strutturato. JSON Quando configuri il formato di log della funzione per questi runtime, la configurazione scelta si applica sia ai log di sistema sia a quelli delle applicazioni.

Per i runtime supportati, se la funzione utilizza una libreria o un metodo di registrazione supportato, non è necessario apportare modifiche al codice esistente affinché Lambda acquisisca i log in modalità strutturata. JSON

Runtime e metodi di registrazione supportati

Lambda attualmente supporta l'opzione di generare log di applicazioni JSON strutturati per i seguenti runtime.

Affinché Lambda invii i log delle applicazioni della funzione CloudWatch in JSON formato strutturato, la funzione deve utilizzare i seguenti strumenti di registrazione integrati per generare i log:

Per ulteriori informazioni sull'utilizzo dei controlli di registrazione avanzati con runtime supportati, consulta le pagine Registrare e monitorare funzioni Lambda in Java, Registrare e monitorare funzioni Lambda in Node.js e Registrare e monitorare le funzioni Lambda con Python.

Per altri runtime Lambda gestiti, Lambda attualmente supporta nativamente solo l'acquisizione dei log di sistema in formato strutturato. JSON Tuttavia, è ancora possibile acquisire i log delle applicazioni in JSON formato strutturato in qualsiasi runtime utilizzando strumenti di registrazione come Powertools per generare output di log formattati. AWS Lambda JSON

Formati di log predefiniti

Attualmente, il formato di log predefinito per tutti i runtime Lambda è il testo normale.

Se state già utilizzando librerie di registrazione come Powertools AWS Lambda per generare i log delle funzioni in formato JSON strutturato, non è necessario modificare il codice se selezionate la formattazione dei log. JSON Lambda non codifica due volte i log già JSON codificati, quindi i log delle applicazioni della funzione continueranno a essere acquisiti come prima.

JSONformato per i log di sistema

Quando si configura il formato di registro della funzione comeJSON, ogni elemento del registro di sistema (evento della piattaforma) viene acquisito come un JSON oggetto che contiene coppie di valori chiave con le seguenti chiavi:

Il formato del valore "record" varia in base al tipo di evento registrato. Per ulteriori informazioni, consulta Tipi di oggetti Event dell'API di telemetria. Per ulteriori informazioni sui livelli di log assegnati ai log eventi di sistema, consulta la pagina Strumento di mappatura degli eventi a livello di log di sistema.

Per fare un confronto, i due esempi seguenti mostrano lo stesso output di log sia in JSON formato di testo semplice che strutturato. Si noti che nella maggior parte dei casi, gli eventi di registro di sistema contengono più informazioni quando vengono emessi in JSON formato rispetto a quando vengono emessi in testo semplice.

2024-03-13 18:56:24.046000 fbe8c1   INIT_START  Runtime Version: python:3.12.v18  Runtime Version ARN: arn:aws:lambda:eu-west-1::runtime:edb5a058bfa782cb9cedc6d534ac8b8c193bc28e9a9879d9f5ebaaf619cd0fc0

{
  "time": "2024-03-13T18:56:24.046Z",
  "type": "platform.initStart",
  "record": {
    "initializationType": "on-demand",
    "phase": "init",
    "runtimeVersion": "python:3.12.v18",
    "runtimeVersionArn": "arn:aws:lambda:eu-west-1::runtime:edb5a058bfa782cb9cedc6d534ac8b8c193bc28e9a9879d9f5ebaaf619cd0fc0"
  }
}

JSONformato per i registri delle applicazioni

Quando si configura il formato di registro della funzione comeJSON, gli output dei log delle applicazioni scritti utilizzando le librerie e i metodi di registrazione supportati vengono acquisiti come JSON oggetto che contiene coppie di valori chiave con le seguenti chiavi.

A seconda del metodo di runtime e di registrazione utilizzato dalla funzione, questo JSON oggetto può contenere anche coppie di chiavi aggiuntive. Ad esempio, in Node.js, se la funzione utilizza console metodi per registrare gli oggetti di errore utilizzando più argomenti, l'JSONoggetto conterrà coppie di valori chiave aggiuntive con le chiavi errorMessage estackTrace. errorType Per ulteriori informazioni sui log JSON formattati in diversi runtime Lambda, consulta, e. Registrare e monitorare le funzioni Lambda con Python Registrare e monitorare funzioni Lambda in Node.js Registrare e monitorare funzioni Lambda in Java

Per fare un confronto, i due esempi seguenti mostrano lo stesso output di log sia in formato testo semplice che strutturato. JSON

2024-10-27T19:17:45.586Z 79b4f56e-95b1-4643-9700-2807f4e68189 INFO some log message

{
    "timestamp":"2024-10-27T19:17:45.586Z",
    "level":"INFO",
    "message":"some log message",
    "requestId":"79b4f56e-95b1-4643-9700-2807f4e68189"
}

Impostazione del formato di log della funzione

Per configurare il formato di registro per la tua funzione, puoi usare la console Lambda o il AWS Command Line Interface ()AWS CLI. Puoi anche configurare il formato di registro di una funzione utilizzando API i comandi CreateFunctionand UpdateFunctionConfigurationLambda, la risorsa AWS Serverless Application Model (AWS SAM) AWS: :Serverless: :Function e la risorsa: :Lambda AWS CloudFormationAWS: :Function.

La modifica del formato di registro della funzione non influisce sui log esistenti archiviati in Logs. CloudWatch Solo i nuovi log utilizzeranno il formato aggiornato.

Se modifichi il formato di registro della funzione JSON e non lo imposti, Lambda imposta automaticamente il livello di registro dell'applicazione e il livello di registro di sistema della funzione su. INFO Ciò significa che Lambda invia solo output di log di livello INFO e inferiori a Logs. CloudWatch Per ulteriori informazioni sul filtraggio a livello di log di applicazioni e sistemi, consulta Filtraggio a livello di log

Per le funzioni Node.js che emettono log incorporati in formato metrico (EMF), la modifica del formato di registro della funzione in JSON potrebbe comportare l' CloudWatch impossibilità di riconoscere le metriche.

Filtraggio a livello di log

Lambda può filtrare i log della funzione in modo che solo i log con un certo livello di dettaglio o inferiore vengano inviati a Logs. CloudWatch Puoi configurare il filtraggio a livello di log separatamente per i log di sistema della funzione (i log generati da Lambda) e i log delle applicazioni (i log generati dal codice della funzione).

Per Runtime e metodi di registrazione supportati, non è necessario apportare modifiche al codice della funzione per Lambda per filtrare i log delle applicazioni della funzione in Lambda.

Per tutti gli altri runtime e metodi di registrazione, il codice della funzione deve generare gli eventi di registro su stdout o stderr come oggetti JSON formattati che contengono una coppia di valori chiave con la chiave. "level" Ad esempio, Lambda interpreta il seguente output stdout come un DEBUG registro di livello.

print('{"level": "debug", "msg": "my debug log", "timestamp": "2024-11-02T16:51:31.587199Z"}')

Se il campo del "level" valore non è valido o manca, Lambda assegnerà all'output del registro il livello. INFO Affinché Lambda utilizzi il campo timestamp, devi specificare l'ora in un formato timestamp 3339 validoRFC. Se non fornisci un timestamp valido, Lambda assegnerà al log il livello INFO e aggiungerà un timestamp per te.

Quando assegni un nome alla chiave timestamp, segui le convenzioni del runtime che stai utilizzando. Lambda supporta le convenzioni di denominazione più comuni utilizzate dai runtime gestiti.

Per i log delle applicazioni (i log generati dal codice della funzione), puoi scegliere tra i seguenti livelli di log.

Quando si seleziona un livello di registro, Lambda invia i log a quel livello e successivamente a Logs. CloudWatch Ad esempio, se imposti il livello di registro dell'applicazione di una funzione suWARN, Lambda non invia output di log ai livelli and. INFO DEBUG Il livello di registro dell'applicazione predefinito per il filtraggio dei log è. INFO

Quando Lambda filtra i log delle applicazioni della funzione, ai messaggi di registro senza livello verrà assegnato il livello di registro. INFO

Per i log di sistema (i log generati dal servizio Lambda), puoi scegliere tra i seguenti livelli di log.

Quando si seleziona un livello di log, Lambda invia i log di quel livello e di livello inferiore. Ad esempio, se imposti il livello di registro di sistema di una funzione suINFO, Lambda non invia output di log a quel livello. DEBUG

Per impostazione predefinita, Lambda imposta il livello di registro del sistema su. INFO Con questa impostazione, Lambda invia "start" e "report" registra automaticamente i messaggi a. CloudWatch Per ricevere log di sistema più o meno dettagliati, modifica il livello di registro in DEBUG o. WARN Per visualizzare un elenco dei livelli di log a cui Lambda mappa i diversi log eventi di sistema, consulta la pagina Strumento di mappatura degli eventi a livello di log di sistema.

Configurazione del filtraggio a livello di log

Per configurare il filtraggio a livello di registro dell'applicazione e del sistema per la tua funzione, puoi utilizzare la console Lambda o il (). AWS Command Line Interface AWS CLI Puoi anche configurare il livello di registro di una funzione utilizzando API i comandi CreateFunctionand UpdateFunctionConfigurationLambda, la risorsa AWS Serverless Application Model (AWS SAM) AWS: :Serverless: :Function e la risorsa: :Lambda AWS CloudFormationAWS: :Function.

Tieni presente che se imposti il livello di log della funzione nel codice, questa impostazione ha la precedenza su qualsiasi altra impostazione del livello di log che configuri. Ad esempio, se utilizzi il logging setLevel() metodo Python per impostare il livello di registrazione della funzione suINFO, questa impostazione ha la precedenza su un'impostazione configurata utilizzando la console WARN Lambda.

Strumento di mappatura degli eventi a livello di log di sistema

Per gli eventi di log a livello di sistema generati da Lambda, la tabella seguente definisce il livello di log assegnato a ciascun evento. Per ulteriori informazioni sugli eventi elencati nella tabella, consulta la pagina Riferimento allo schema Event dell'API di telemetria Lambda

Filtraggio delle applicazioni a livello di log con runtime personalizzati

Quando configuri il filtraggio a livello di log dell'applicazione per la tua funzione, dietro le quinte Lambda imposta il livello di log dell'applicazione nel runtime utilizzando la variabile di ambiente AWS_LAMBDA_LOG_LEVEL. Lambda imposta anche il formato di log della funzione utilizzando la variabile di ambiente AWS_LAMBDA_LOG_FORMAT. Puoi utilizzare queste variabili per integrare i controlli di registrazione avanzati di Lambda in un runtime personalizzato.

Per poter configurare le impostazioni di registrazione per una funzione utilizzando un runtime personalizzato con la console Lambda e APIs Lambda AWS CLI, configura il runtime personalizzato per controllare il valore di queste variabili di ambiente. È quindi possibile configurare i logger del runtime in base al formato di log e ai livelli di log selezionati.

Configurazione dei gruppi di log CloudWatch

Per impostazione predefinita, crea CloudWatch automaticamente un gruppo di log denominato in base alla funzione quando viene richiamata /aws/lambda/<function name> per la prima volta. Per configurare la tua funzione per l'invio dei log a un gruppo di log esistente o per creare un nuovo gruppo di log per la funzione, puoi utilizzare la console Lambda o la AWS CLI. Puoi anche configurare gruppi di log personalizzati utilizzando i API comandi CreateFunctione UpdateFunctionConfigurationLambda e la risorsa AWS Serverless Application Model (AWS SAM) AWS: :Serverless: :Function.

È possibile configurare più funzioni Lambda per inviare i log allo stesso CloudWatch gruppo di log. Ad esempio, è possibile utilizzare un singolo gruppo di log per archiviare i log per tutte le funzioni Lambda che costituiscono una particolare applicazione. Quando si utilizza un gruppo di log personalizzato per una funzione Lambda, i flussi di log creati da Lambda includono il nome e la versione della funzione. Ciò garantisce che la mappatura tra i messaggi di log e le funzioni venga preservata, anche se si utilizza lo stesso gruppo di log per più funzioni.

Il formato di denominazione per i flussi di log per i gruppi di log personalizzati segue questa convenzione:

YYYY/MM/DD/<function_name>[<function_version>][<execution_environment_GUID>]

Tieni presente che quando configuri un gruppo di log personalizzato, il nome selezionato per il gruppo di log deve seguire le regole di denominazione dei CloudWatch log. Inoltre, i nomi dei gruppi di log personalizzati non devono cominciare con la stringa aws/. Se crei un gruppo di log personalizzato che comincia con aws/, Lambda non sarà in grado di crearlo. Di conseguenza, i log della funzione non verranno inviati a. CloudWatch

Autorizzazioni del ruolo di esecuzione

Affinché la funzione invii i log a CloudWatch Logs, deve disporre dell'autorizzazione logs:. PutLogEvents Quando configuri il gruppo di log della funzione utilizzando la console Lambda, se la funzione non dispone di questa autorizzazione, Lambda la aggiunge al ruolo di esecuzione della funzione per impostazione predefinita. Quando Lambda aggiunge questo permesso, concede alla funzione il permesso di inviare i log a qualsiasi gruppo di log CloudWatch Logs.

Per evitare che Lambda aggiorni automaticamente il ruolo di esecuzione della funzione e modificarlo invece manualmente, espandi Autorizzazioni e deseleziona Aggiungi autorizzazioni richieste.

Quando configuri il gruppo di log della tua funzione utilizzando AWS CLI, Lambda non aggiungerà automaticamente l'logs:PutLogEventsautorizzazione. Aggiungi l'autorizzazione al ruolo di esecuzione della tua funzione, se non ne dispone già. Questa autorizzazione è inclusa nella politica AWSLambdaBasicExecutionRolegestita.