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à.
Registra e monitora le funzioni Java Lambda
AWS Lambda monitora automaticamente le funzioni Lambda e invia le voci di registro ad Amazon. CloudWatch La funzione Lambda include un gruppo di log CloudWatch Logs e un flusso di log per ogni istanza della funzione. L’ambiente di runtime di Lambda invia al flusso di log i dettagli su ogni invocazione e altri output dal codice della funzione. Per ulteriori informazioni sui CloudWatch registri, consulta. Utilizzo dei CloudWatch log di log con Lambda
Per generare output di log dal codice della funzione, puoi utilizzare i metodi di java.lang.System
Sections
- Creazione di una funzione che restituisce i registri
- Utilizzo dei controlli di registrazione avanzati di Lambda con Java
- Implementazione della registrazione avanzata con Log4j2 e SLF4J
- Utilizzo di altri strumenti e librerie di registrazione
- Utilizzo di Powertools per AWS Lambda (Java) e per la registrazione strutturata AWS SAM
- Visualizzazione dei log nella console Lambda
- Visualizzazione dei log nella console CloudWatch
- Visualizzazione dei log utilizzando () AWS Command Line InterfaceAWS CLI
- Eliminazione dei log
- Codice di registrazione dei log di esempio
Creazione di una funzione che restituisce i registri
Per i log di output del codice della funzione, puoi usare i metodi di java.lang.Systemstdout
o stderr
. La aws-lambda-java-corelibreria fornisce una classe logger denominata a LambdaLogger
cui è possibile accedere dall'oggetto context. La classe di logger supporta i log multilinea.
Nell'esempio seguente viene utilizzato il logger LambdaLogger
fornito dall'oggetto contestuale.
Esempio Handler.java
// Handler value: example.Handler public class Handler implements RequestHandler<Object, String>{ Gson gson = new GsonBuilder().setPrettyPrinting().create(); @Override public String handleRequest(Object event, Context context) {
LambdaLogger logger = context.getLogger();
String response = new String("SUCCESS"); // log execution detailslogger.log("ENVIRONMENT VARIABLES: " + gson.toJson(System.getenv())); logger.log("CONTEXT: " + gson.toJson(context));
// process eventlogger.log("EVENT: " + gson.toJson(event));
return response; } }
Esempio Formato dei log
START RequestId: 6bc28136-xmpl-4365-b021-0ce6b2e64ab0 Version: $LATEST ENVIRONMENT VARIABLES: { "_HANDLER": "example.Handler", "AWS_EXECUTION_ENV": "AWS_Lambda_java8", "AWS_LAMBDA_FUNCTION_MEMORY_SIZE": "512", ... } CONTEXT: { "memoryLimit": 512, "awsRequestId": "6bc28136-xmpl-4365-b021-0ce6b2e64ab0", "functionName": "java-console", ... } EVENT: { "records": [ { "messageId": "19dd0b57-xmpl-4ac1-bd88-01bbb068cb78", "receiptHandle": "MessageReceiptHandle", "body": "Hello from SQS!", ... } ] } END RequestId: 6bc28136-xmpl-4365-b021-0ce6b2e64ab0 REPORT RequestId: 6bc28136-xmpl-4365-b021-0ce6b2e64ab0 Duration: 198.50 ms Billed Duration: 200 ms Memory Size: 512 MB Max Memory Used: 90 MB Init Duration: 524.75 ms
Il runtime di Java registra START
, END
e REPORT
per ogni chiamata. La riga del report fornisce i seguenti dettagli:
REPORTcampi dati lineari
-
RequestId— L'ID univoco della richiesta per la chiamata.
-
Durata – La quantità di tempo che il metodo del gestore della funzione impiega durante l'elaborazione dell'evento.
-
Durata fatturata – La quantità di tempo fatturata per la chiamata.
-
Dimensioni memoria – La quantità di memoria allocata per la funzione.
-
Quantità max utilizzata – La quantità di memoria utilizzata dalla funzione. Quando le chiamate condividono un ambiente di esecuzione, Lambda riporta la memoria massima utilizzata in tutte le chiamate. Questo comportamento potrebbe comportare un valore riportato superiore al previsto.
-
Durata Init – Per la prima richiesta servita, la quantità di tempo impiegato dal runtime per caricare la funzione ed eseguire il codice al di fuori del metodo del gestore.
-
XRAY TraceId— Per le richieste tracciate, l'ID di AWS X-Ray traccia.
-
SegmentId— Per le richieste tracciate, l'ID del segmento X-Ray.
-
Campionato – Per le richieste tracciate, il risultato del campionamento.
Utilizzo dei controlli di registrazione avanzati di Lambda con Java
Per avere un maggiore controllo sul modo in cui i log delle tue funzioni vengono acquisiti, elaborati e utilizzati, puoi configurare le seguenti opzioni di registrazione per i runtime Java supportati:
-
Formato di registro: scegli tra testo semplice e JSON formato strutturato per i registri della tua funzione
-
Livello di registro: per i log in JSON formato, scegli il livello di dettaglio dei log a cui Lambda invia CloudWatch, ad esempio, o ERROR DEBUG INFO
-
Gruppo di log: scegli il gruppo di CloudWatch log a cui la funzione invia i log
Per ulteriori informazioni su queste opzioni di registrazione e istruzioni su come configurare la funzione per utilizzarle, consulta la pagina Configurazione dei controlli di registrazione avanzati per le funzioni Lambda.
Per utilizzare le opzioni del formato di log e del livello di log con le funzioni Lambda in Java, consulta le istruzioni nelle sezioni seguenti.
Utilizzo del formato di JSON registro strutturato con Java
Se si seleziona JSON il formato di registro della funzione, Lambda invierà l'output dei log utilizzando la LambdaLogger
classe così come è strutturata. JSON Ogni oggetto di JSON registro contiene almeno quattro coppie di valori chiave con le seguenti chiavi:
-
"timestamp"
: l'ora in cui è stato generato il messaggio di log -
"level"
: il livello di log assegnato al messaggio -
"message"
: il contenuto del messaggio di log -
"AWSrequestId"
: l'ID di richiesta univoco dell'invocazione alla funzione
A seconda del metodo di registrazione utilizzato, gli output di log della funzione acquisiti in JSON formato possono contenere anche coppie chiave-valore aggiuntive.
Per assegnare un livello ai log creati utilizzando il logger LambdaLogger
, è necessario fornire un argomento LogLevel
nel comando di registrazione, come mostrato nell'esempio seguente.
Esempio Codice di registrazione di Java
LambdaLogger logger = context.getLogger(); logger.log("This is a debug log", LogLevel.DEBUG);
L'output di registro di questo codice di esempio verrebbe acquisito in CloudWatch Logs come segue:
Esempio JSONrecord di registro
{
"timestamp":"2023-11-01T00:21:51.358Z",
"level":"DEBUG",
"message":"This is a debug log",
"AWSrequestId":"93f25699-2cbf-4976-8f94-336a0aa98c6f"
}
Se non assegni un livello all'output del log, Lambda lo assegnerà automaticamente. INFO
Se il codice utilizza già un'altra libreria di registrazione per produrre log JSON strutturati, non è necessario apportare alcuna modifica. Lambda non codifica due volte i log già codificati. JSON Anche se configuri la funzione per utilizzare il formato di JSON registro, i risultati di registrazione vengono visualizzati nella struttura che definisci. CloudWatch JSON
Utilizzo del filtraggio a livello di log con Java
Per AWS Lambda filtrare i log delle applicazioni in base al relativo livello di registro, la funzione deve utilizzare JSON log formattati. Puoi farlo in due modi:
-
Crea output di registro utilizzando lo standard
LambdaLogger
e configura la tua funzione per utilizzare la formattazione dei log. JSON Lambda filtra quindi gli output dei log utilizzando la coppia chiave-valore «level» nell'JSONoggetto descritto in. Utilizzo del formato di JSON registro strutturato con Java Per informazioni su come configurare il formato di log della funzione, consulta la pagina Configurazione dei controlli di registrazione avanzati per le funzioni Lambda. -
Usa un'altra libreria o metodo di registrazione per creare log JSON strutturati nel codice che includono una coppia chiave-valore «level» che definisce il livello dell'output del log. È possibile utilizzare qualsiasi libreria di registrazione in grado di scrivere JSON registri su o.
stdout
stderr
Ad esempio, puoi utilizzare Powertools for AWS Lambda o il pacchetto Log4j2 per generare output di log JSON strutturati dal tuo codice. Per ulteriori informazioni, consulta le pagine Utilizzo di Powertools per AWS Lambda (Java) e per la registrazione strutturata AWS SAM e Implementazione della registrazione avanzata con Log4j2 e SLF4J.
Quando configuri la tua funzione per utilizzare il filtraggio a livello di log, devi selezionare una delle seguenti opzioni per il livello di log che Lambda invii a Logs: CloudWatch
Livello di log | Utilizzo standard |
---|---|
TRACE(più dettagli) | Le informazioni più dettagliate utilizzate per tracciare il percorso di esecuzione del codice |
DEBUG | Informazioni dettagliate per il debug del sistema |
INFO | Messaggi che registrano il normale funzionamento della funzione |
WARN | Messaggi relativi a potenziali errori che possono portare a comportamenti imprevisti se non risolti |
ERROR | Messaggi relativi a problemi che impediscono al codice di funzionare come previsto |
FATAL(minimo dettaglio) | Messaggi relativi a errori gravi che causano l'interruzione del funzionamento dell'applicazione |
Affinché Lambda filtri i log della tua funzione, devi includere anche una coppia di valori "timestamp"
chiave nell'output del log. JSON L'ora deve essere specificata in un formato timestamp RFC3339
Lambda invia i log del livello selezionato e inferiore a. CloudWatch Ad esempio, se configuri un livello di registro diWARN, Lambda invierà i log corrispondenti ai livelli WARNERROR, e. FATAL
Implementazione della registrazione avanzata con Log4j2 e SLF4J
Nota
AWS Lambda non include Log4j2 nei suoi runtime gestiti o nelle immagini dei contenitori di base. Questi non sono quindi interessati dai problemi descritti in -2021-44228, -2021-45046 e CVE -2021-45105. CVE CVE
Nei casi in cui una funzione cliente include una versione di Log4j2 interessata, abbiamo applicato una modifica ai runtime gestiti di Lambda Java e alle immagini del contenitore di base che aiuta a mitigare i problemi in -2021-44228, -2021-45046 e -2021-45105. CVE CVE CVE Come risultato di questa modifica, i clienti che utilizzano Log4J2 potrebbero vedere una voce di log aggiuntiva, simile a "Transforming org/apache/logging/log4j/core/lookup/JndiLookup (java.net.URLClassLoader@...)
". Tutte le stringhe di log che fanno riferimento al mappatore jndi nell'output Log4J2 saranno sostituite con "Patched JndiLookup::lookup()
".
Indipendentemente da questa modifica, incoraggiamo fortemente tutti i clienti le cui funzioni includono Log4j2 ad aggiornare l'ultima versione. In particolare, i clienti che utilizzano la libreria aws-lambda-java -log4j2 nelle proprie funzioni devono eseguire l'aggiornamento alla versione 1.5.0 (o successiva) e ridistribuire le proprie funzioni. Questa versione aggiorna le dipendenze dell'utility Log4j2 sottostanti alla versione 2.17.0 (o successiva). Il binario aws-lambda-java -log4j2 aggiornato è disponibile nel repository Maven e il suo codice sorgente è disponibile in Github.
Infine, tieni presente che le librerie relative a aws-lambda-java-log4j (v1.0.0 o 1.0.1) non devono essere utilizzate in nessuna circostanza. Queste librerie sono correlate alla versione 1.x di log4j, che ha raggiunto il fine vita nel 2015. Le librerie non sono supportate, non sono gestite, non sono corredate di patch e presentano vulnerabilità di sicurezza note.
Per personalizzare l'output dei log, supportare la registrazione durante i test unitari e registrare le chiamate, usa Apache Log4j2 con. AWS SDK SLF4J Log4j è una libreria di registrazione per i programmi Java che consente di configurare i livelli di log e utilizzare librerie appender. SLF4Jè una libreria di facciate che consente di modificare la libreria utilizzata senza modificare il codice della funzione.
Per aggiungere l'ID della richiesta ai log della funzione, usa l'appender nella libreria aws-lambda-java-log4j2.
Esempio src/main/resources/log4j2.xml – Configurazione dell'appender
<Configuration> <Appenders> <Lambda name="Lambda" format="${env:AWS_LAMBDA_LOG_FORMAT:-TEXT}"> <LambdaTextFormat> <PatternLayout> <pattern>%d{yyyy-MM-dd HH:mm:ss} %X{AWSRequestId} %-5p %c{1} - %m%n </pattern> </PatternLayout> </LambdaTextFormat> <LambdaJSONFormat> <JsonTemplateLayout eventTemplateUri="classpath:LambdaLayout.json" /> </LambdaJSONFormat> </Lambda> </Appenders> <Loggers> <Root level="${env:AWS_LAMBDA_LOG_LEVEL:-INFO}"> <AppenderRef ref="Lambda"/> </Root> <Logger name="software.amazon.awssdk" level="WARN" /> <Logger name="software.amazon.awssdk.request" level="DEBUG" /> </Loggers> </Configuration>
Puoi decidere come configurare i tuoi log Log4j2 per il testo semplice o per gli JSON output specificando un layout sotto i tag and. <LambdaTextFormat>
<LambdaJSONFormat>
Con questa configurazione, in modalità di testo, ogni riga è preceduta da data, ora, ID richiesta, livello di log e nome della classe. In JSON modalità, <JsonTemplateLayout>
viene utilizzato con una configurazione fornita insieme alla libreria. aws-lambda-java-log4j2
SLF4Jè una libreria di facciate per la registrazione del codice Java. Nel codice della funzione, si utilizza il SLF4J logger factory per recuperare un logger con metodi per i livelli di registro come e. info()
warn()
Nella configurazione della build, includi la libreria di registrazione e l'SLF4Jadattatore nel classpath. Modificando le librerie nella configurazione di compilazione, è possibile modificare il tipo di logger senza modificare il codice della funzione. SLF4Jè necessario per acquisire i log da for Java. SDK
Nel codice di esempio seguente, la classe handler utilizza SLF4J per recuperare un logger.
Esempio src/main/java/example/HandlerS3.java — Registrazione con SLF4J
package example; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import com.amazonaws.services.lambda.runtime.Context; import com.amazonaws.services.lambda.runtime.RequestHandler; import com.amazonaws.services.lambda.runtime.events.S3Event; import static org.apache.logging.log4j.CloseableThreadContext.put; public class HandlerS3 implements RequestHandler<S3Event, String>{ private static final Logger logger = LoggerFactory.getLogger(HandlerS3.class); @Override public String handleRequest(S3Event event, Context context) { for(var record : event.getRecords()) { try (var loggingCtx = put("awsRegion", record.getAwsRegion())) { loggingCtx.put("eventName", record.getEventName()); loggingCtx.put("bucket", record.getS3().getBucket().getName()); loggingCtx.put("key", record.getS3().getObject().getKey()); logger.info("Handling s3 event"); } } return "Ok"; } }
Questo codice genera output log simili al seguente:
Esempio Formato dei log
{ "timestamp": "2023-11-15T16:56:00.815Z", "level": "INFO", "message": "Handling s3 event", "logger": "example.HandlerS3", "AWSRequestId": "0bced576-3936-4e5a-9dcd-db9477b77f97", "awsRegion": "eu-south-1", "bucket": "java-logging-test-input-bucket", "eventName": "ObjectCreated:Put", "key": "test-folder/" }
La configurazione di build richiede le dipendenze di runtime dall'appender SLF4J e dall'adattatore Lambda e le dipendenze dall'implementazione su Log4j2.
Esempio build.gradle – Registrazione delle dipendenze
dependencies { ... 'com.amazonaws:aws-lambda-java-log4j2:[1.6.0,)', 'com.amazonaws:aws-lambda-java-events:[3.11.3,)', 'org.apache.logging.log4j:log4j-layout-template-json:[2.17.1,)', 'org.apache.logging.log4j:log4j-slf4j2-impl:[2.19.0,)', ... }
Quando esegui localmente il codice per i test, l'oggetto contestuale con il logger Lambda non è disponibile e non esiste alcun ID richiesta che possa essere utilizzato dall'appender Lambda. Per configurazioni di test di esempio, consulta le applicazioni di esempio nella sezione successiva.
Utilizzo di altri strumenti e librerie di registrazione
Powertools for AWS Lambda (Java)
Acquisisci i campi chiave dal contesto Lambda, dall'avvio a freddo e dall'output di registrazione delle strutture come JSON
Registrazione degli eventi di chiamata Lambda quando richiesto (disabilitata per impostazione predefinita)
Stampa di tutti i log solo per una percentuale di chiamate tramite campionamento dei log (disabilitata per impostazione predefinita)
Aggiunta di chiavi supplementari al log strutturato in qualsiasi momento
Utilizza un formattatore di log personalizzato (Bring Your Own Formatter) per generare i log in una struttura compatibile con il Logging della tua organizzazione RFC
Utilizzo di Powertools per AWS Lambda (Java) e per la registrazione strutturata AWS SAM
Segui i passaggi seguenti per scaricare, creare e distribuire un'applicazione Java Hello World di esempio con i moduli Powertools for AWS Lambda (Java) ~hello world
.
Prerequisiti
Per completare le fasi riportate in questa sezione, è necessario:
-
Java 11
-
AWS SAM CLIversione 1.75 o successiva. Se disponi di una versione precedente di AWS SAM CLI, consulta Aggiornamento di. AWS SAM CLI
Distribuisci un'applicazione di esempio AWS SAM
-
Inizializza l'applicazione utilizzando il modello Java Hello World.
sam init --app-template hello-world-powertools-java --name sam-app --package-type Zip --runtime java11 --no-tracing
-
Costruisci l'app.
cd sam-app && sam build
-
Distribuire l'app.
sam deploy --guided
-
Seguire le istruzioni visualizzate sullo schermo. Per accettare le opzioni predefinite fornite nell'esperienza interattiva, premi
Enter
.Nota
Perché HelloWorldFunction potrebbe non avere un'autorizzazione definita, va bene? , assicurati di entrare
y
. -
Scarica URL l'applicazione distribuita:
aws cloudformation describe-stacks --stack-name sam-app --query 'Stacks[0].Outputs[?OutputKey==`HelloWorldApi`].OutputValue' --output text
-
Invoca l'APIendpoint:
curl -X GET
<URL_FROM_PREVIOUS_STEP>
In caso di esito positivo, vedrai questa risposta:
{"message":"hello world"}
-
Per ottenere i log per la funzione, esegui sam logs. Per ulteriori informazioni, consulta l'argomento relativo all'utilizzo dei log nella Guida per sviluppatori AWS Serverless Application Model .
sam logs --stack-name sam-app
L'output del log ha la struttura seguente:
2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:34.095000 INIT_START Runtime Version: java:11.v15 Runtime Version ARN: arn:aws:lambda:eu-central-1::runtime:0a25e3e7a1cc9ce404bc435eeb2ad358d8fa64338e618d0c224fe509403583ca 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:34.114000 Picked up JAVA_TOOL_OPTIONS: -XX:+TieredCompilation -XX:TieredStopAtLevel=1 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:34.793000 Transforming org/apache/logging/log4j/core/lookup/JndiLookup (lambdainternal.CustomerClassLoader@1a6c5a9e) 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:35.252000 START RequestId: 7fcf1548-d2d4-41cd-a9a8-6ae47c51f765 Version: $LATEST 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:36.531000 { "_aws": { "Timestamp": 1675416276051, "CloudWatchMetrics": [ { "Namespace": "sam-app-powerools-java", "Metrics": [ { "Name": "ColdStart", "Unit": "Count" } ], "Dimensions": [ [ "Service", "FunctionName" ] ] } ] }, "function_request_id": "7fcf1548-d2d4-41cd-a9a8-6ae47c51f765", "traceId": "Root=1-63dcd2d1-25f90b9d1c753a783547f4dd;Parent=e29684c1be352ce4;Sampled=1", "FunctionName": "sam-app-HelloWorldFunction-y9Iu1FLJJBGD", "functionVersion": "$LATEST", "ColdStart": 1.0, "Service": "service_undefined", "logStreamId": "2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81", "executionEnvironment": "AWS_Lambda_java11" } 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:36.974000 Feb 03, 2023 9:24:36 AM com.amazonaws.xray.AWSXRayRecorder <init> 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:36.993000 Feb 03, 2023 9:24:36 AM com.amazonaws.xray.config.DaemonConfiguration <init> 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:36.993000 INFO: Environment variable AWS_XRAY_DAEMON_ADDRESS is set. Emitting to daemon on address XXXX.XXXX.XXXX.XXXX:2000. 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:37.331000 09:24:37.294 [main] INFO helloworld.App - {"version":null,"resource":"/hello","path":"/hello/","httpMethod":"GET","headers":{"Accept":"*/*","CloudFront-Forwarded-Proto":"https","CloudFront-Is-Desktop-Viewer":"true","CloudFront-Is-Mobile-Viewer":"false","CloudFront-Is-SmartTV-Viewer":"false","CloudFront-Is-Tablet-Viewer":"false","CloudFront-Viewer-ASN":"16509","CloudFront-Viewer-Country":"IE","Host":"XXXX.execute-api.eu-central-1.amazonaws.com","User-Agent":"curl/7.86.0","Via":"2.0 f0300a9921a99446a44423d996042050.cloudfront.net (CloudFront)","X-Amz-Cf-Id":"t9W5ByT11HaY33NM8YioKECn_4eMpNsOMPfEVRczD7T1RdhbtiwV1Q==","X-Amzn-Trace-Id":"Root=1-63dcd2d1-25f90b9d1c753a783547f4dd","X-Forwarded-For":"XX.XXX.XXX.XX, XX.XXX.XXX.XX","X-Forwarded-Port":"443","X-Forwarded-Proto":"https"},"multiValueHeaders":{"Accept":["*/*"],"CloudFront-Forwarded-Proto":["https"],"CloudFront-Is-Desktop-Viewer":["true"],"CloudFront-Is-Mobile-Viewer":["false"],"CloudFront-Is-SmartTV-Viewer":["false"],"CloudFront-Is-Tablet-Viewer":["false"],"CloudFront-Viewer-ASN":["16509"],"CloudFront-Viewer-Country":["IE"],"Host":["XXXX.execute-api.eu-central-1.amazonaws.com"],"User-Agent":["curl/7.86.0"],"Via":["2.0 f0300a9921a99446a44423d996042050.cloudfront.net (CloudFront)"],"X-Amz-Cf-Id":["t9W5ByT11HaY33NM8YioKECn_4eMpNsOMPfEVRczD7T1RdhbtiwV1Q=="],"X-Amzn-Trace-Id":["Root=1-63dcd2d1-25f90b9d1c753a783547f4dd"],"X-Forwarded-For":["XXX, XXX"],"X-Forwarded-Port":["443"],"X-Forwarded-Proto":["https"]},"queryStringParameters":null,"multiValueQueryStringParameters":null,"pathParameters":null,"stageVariables":null,"requestContext":{"accountId":"XXX","stage":"Prod","resourceId":"at73a1","requestId":"ba09ecd2-acf3-40f6-89af-fad32df67597","operationName":null,"identity":{"cognitoIdentityPoolId":null,"accountId":null,"cognitoIdentityId":null,"caller":null,"apiKey":null,"principalOrgId":null,"sourceIp":"54.240.197.236","cognitoAuthenticationType":null,"cognitoAuthenticationProvider":null,"userArn":null,"userAgent":"curl/7.86.0","user":null,"accessKey":null},"resourcePath":"/hello","httpMethod":"GET","apiId":"XXX","path":"/Prod/hello/","authorizer":null},"body":null,"isBase64Encoded":false} 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:37.351000 09:24:37.351 [main] INFO helloworld.App - Retrieving https://checkip.amazonaws.com 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:39.313000 { "function_request_id": "7fcf1548-d2d4-41cd-a9a8-6ae47c51f765", "traceId": "Root=1-63dcd2d1-25f90b9d1c753a783547f4dd;Parent=e29684c1be352ce4;Sampled=1", "xray_trace_id": "1-63dcd2d1-25f90b9d1c753a783547f4dd", "functionVersion": "$LATEST", "Service": "service_undefined", "logStreamId": "2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81", "executionEnvironment": "AWS_Lambda_java11" } 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:39.371000 END RequestId: 7fcf1548-d2d4-41cd-a9a8-6ae47c51f765 2023/02/03/[$LATEST]851411a899b545eea2cffeba4cfbec81 2023-02-03T09:24:39.371000 REPORT RequestId: 7fcf1548-d2d4-41cd-a9a8-6ae47c51f765 Duration: 4118.98 ms Billed Duration: 4119 ms Memory Size: 512 MB Max Memory Used: 152 MB Init Duration: 1155.47 ms XRAY TraceId: 1-63dcd2d1-25f90b9d1c753a783547f4dd SegmentId: 3a028fee19b895cb Sampled: true
-
Si tratta di un API endpoint pubblico accessibile tramite Internet. È consigliabile eliminare l'endpoint dopo il test.
sam delete
Gestione della conservazione dei log
I gruppi di log non vengono eliminati automaticamente quando si elimina una funzione. Per evitare di archiviare i log a tempo indeterminato, elimina il gruppo di log o configura un periodo di conservazione dopo il quale i log CloudWatch vengono eliminati automaticamente. Per configurare la conservazione dei log, aggiungi quanto segue al tuo modello: AWS SAM
Resources: HelloWorldFunction: Type: AWS::Serverless::Function Properties: # Omitting other properties LogGroup: Type: AWS::Logs::LogGroup Properties: LogGroupName: !Sub "/aws/lambda/${HelloWorldFunction}" RetentionInDays: 7
Visualizzazione dei log nella console Lambda
È possibile utilizzare la console Lambda per visualizzare l'output del log dopo aver richiamato una funzione Lambda.
Se il codice può essere testato dall'editor del codice incorporato, troverai i log nei risultati dell’esecuzione. Quando utilizzi la funzionalità di test della console per richiamare una funzione, troverai l’output del log nella sezione Dettagli.
Visualizzazione dei log nella console CloudWatch
Puoi utilizzare la CloudWatch console Amazon per visualizzare i log di tutte le chiamate di funzioni Lambda.
Per visualizzare i log sulla console CloudWatch
-
Apri la pagina Registra gruppi
sulla CloudWatch console. -
Scegli il gruppo di log per la tua funzione (/aws/lambda/
your-function-name
). -
Creare un flusso di log.
Ogni flusso di log corrisponde a un'istanza della funzione. Nuovi flussi di log vengono visualizzati quando aggiorni la funzione Lambda e quando vengono create istanze aggiuntive per gestire più chiamate simultanee. Per trovare i log per una chiamata specifica, ti consigliamo di strumentare la tua funzione con. AWS X-Ray X-Ray registra i dettagli sulla richiesta e il flusso di log nella traccia.
Visualizzazione dei log utilizzando () AWS Command Line InterfaceAWS CLI
AWS CLI È uno strumento open source che consente di interagire con i AWS servizi utilizzando i comandi nella shell della riga di comando. Per completare le fasi riportate in questa sezione, è necessario:
È possibile utilizzare AWS CLI per recuperare i log per una chiamata utilizzando l'opzione di comando --log-type
. La risposta include un campo LogResult
che contiene fino a 4 KB di log con codifica base64 del richiamo.
Esempio recuperare un ID di log
Nell'esempio seguente viene illustrato come recuperare un ID di log dal LogResult
campo per una funzione denominata my-function
.
aws lambda invoke --function-name my-function out --log-type Tail
Verrà visualizzato l'output seguente:
{ "StatusCode": 200, "LogResult": "U1RBUlQgUmVxdWVzdElkOiA4N2QwNDRiOC1mMTU0LTExZTgtOGNkYS0yOTc0YzVlNGZiMjEgVmVyc2lvb...", "ExecutedVersion": "$LATEST" }
Esempio decodificare i log
Nello stesso prompt dei comandi, utilizzare l'base64
utilità per decodificare i log. Nell'esempio seguente viene illustrato come recuperare i log codificati in base64 per my-function
.
aws lambda invoke --function-name my-function out --log-type Tail \ --query 'LogResult' --output text --cli-binary-format raw-in-base64-out | base64 --decode
L'cli-binary-formatopzione è obbligatoria se si utilizza la AWS CLI versione 2. Per rendere questa impostazione come predefinita, esegui aws configure set cli-binary-format raw-in-base64-out
. Per ulteriori informazioni, consulta la pagina AWS CLI supported global command line options nella Guida per l'utente di AWS Command Line Interface versione 2.
Verrà visualizzato l'output seguente:
START RequestId: 57f231fb-1730-4395-85cb-4f71bd2b87b8 Version: $LATEST "AWS_SESSION_TOKEN": "AgoJb3JpZ2luX2VjELj...", "_X_AMZN_TRACE_ID": "Root=1-5d02e5ca-f5792818b6fe8368e5b51d50;Parent=191db58857df8395;Sampled=0"",ask/lib:/opt/lib", END RequestId: 57f231fb-1730-4395-85cb-4f71bd2b87b8 REPORT RequestId: 57f231fb-1730-4395-85cb-4f71bd2b87b8 Duration: 79.67 ms Billed Duration: 80 ms Memory Size: 128 MB Max Memory Used: 73 MB
L'utilità base64
è disponibile su Linux, macOS e Ubuntu su Windowsbase64 -D
.
Esempio Script get-logs.sh
Nello stesso prompt dei comandi, utilizzare lo script seguente per scaricare gli ultimi cinque eventi di log. Lo script utilizza sed
per rimuovere le virgolette dal file di output e rimane in sospensione per 15 secondi in attesa che i log diventino disponibili. L'output include la risposta di Lambda e l'output del comando get-log-events
.
Copiare il contenuto del seguente esempio di codice e salvare nella directory del progetto Lambda come get-logs.sh
.
L'cli-binary-formatopzione è obbligatoria se utilizzi la AWS CLI versione 2. Per rendere questa impostazione come predefinita, esegui aws configure set cli-binary-format raw-in-base64-out
. Per ulteriori informazioni, consulta la pagina AWS CLI supported global command line options nella Guida per l'utente di AWS Command Line Interface versione 2.
#!/bin/bash aws lambda invoke --function-name my-function --cli-binary-format raw-in-base64-out --payload '{"key": "value"}' out sed -i'' -e 's/"//g' out sleep 15 aws logs get-log-events --log-group-name /aws/lambda/
my-function
--log-stream-namestream1
--limit 5
Esempio (solo) macOS e Linux
Nello stesso prompt dei comandi, gli utenti macOS e Linux potrebbero dover eseguire il seguente comando per assicurarsi che lo script sia eseguibile.
chmod -R 755 get-logs.sh
Esempio recuperare gli ultimi cinque eventi di log
Nello stesso prompt dei comandi, eseguire lo script seguente per ottenere gli ultimi cinque eventi di log.
./get-logs.sh
Verrà visualizzato l'output seguente:
{ "StatusCode": 200, "ExecutedVersion": "$LATEST" } { "events": [ { "timestamp": 1559763003171, "message": "START RequestId: 4ce9340a-b765-490f-ad8a-02ab3415e2bf Version: $LATEST\n", "ingestionTime": 1559763003309 }, { "timestamp": 1559763003173, "message": "2019-06-05T19:30:03.173Z\t4ce9340a-b765-490f-ad8a-02ab3415e2bf\tINFO\tENVIRONMENT VARIABLES\r{\r \"AWS_LAMBDA_FUNCTION_VERSION\": \"$LATEST\",\r ...", "ingestionTime": 1559763018353 }, { "timestamp": 1559763003173, "message": "2019-06-05T19:30:03.173Z\t4ce9340a-b765-490f-ad8a-02ab3415e2bf\tINFO\tEVENT\r{\r \"key\": \"value\"\r}\n", "ingestionTime": 1559763018353 }, { "timestamp": 1559763003218, "message": "END RequestId: 4ce9340a-b765-490f-ad8a-02ab3415e2bf\n", "ingestionTime": 1559763018353 }, { "timestamp": 1559763003218, "message": "REPORT RequestId: 4ce9340a-b765-490f-ad8a-02ab3415e2bf\tDuration: 26.73 ms\tBilled Duration: 27 ms \tMemory Size: 128 MB\tMax Memory Used: 75 MB\t\n", "ingestionTime": 1559763018353 } ], "nextForwardToken": "f/34783877304859518393868359594929986069206639495374241795", "nextBackwardToken": "b/34783877303811383369537420289090800615709599058929582080" }
Eliminazione dei log
I gruppi di log non vengono eliminati automaticamente quando si elimina una funzione. Per evitare di archiviare i log a tempo indeterminato, eliminare il gruppo di log o configurare un periodo di conservazione trascorso il quale i log vengono eliminati automaticamente.
Codice di registrazione dei log di esempio
L' GitHub archivio di questa guida include applicazioni di esempio che dimostrano l'uso di varie configurazioni di registrazione. Ogni applicazione di esempio include script per facilitare la distribuzione e la pulizia, un AWS SAM modello e risorse di supporto.
Applicazioni Lambda di esempio in Java
-
java17-examples
: una funzione Java che dimostra come utilizzare un record Java per rappresentare un oggetto di dati dell'evento di input. -
java-basic
: una raccolta di funzioni Java minimali con unit test e configurazione della registrazione dei log delle variabili. -
java-events
— Una raccolta di funzioni Java che contengono codice scheletrico su come gestire gli eventi di vari servizi come Amazon GatewayAPI, Amazon e Amazon SQS Kinesis. Queste funzioni utilizzano la versione più recente della aws-lambda-java-eventslibreria (3.0.0 e successive). Questi esempi non richiedono che sia una dipendenza AWS SDK. -
s3-java
: una funzione Java che elabora gli eventi di notifica da Amazon S3 e utilizza la Java Class Library JCL () per creare miniature dai file di immagine caricati. -
Usa API Gateway per richiamare una funzione Lambda, una funzione Java che analizza una tabella Amazon DynamoDB che contiene informazioni sui dipendenti. Quindi utilizza Amazon Simple Notification Service per inviare un messaggio di testo ai dipendenti per festeggiare i loro anniversari di lavoro. Questo esempio utilizza API Gateway per richiamare la funzione.
L'applicazione java-basic
di esempio mostra una configurazione di registrazione minima che supporta i test di registrazione. Il codice del gestore utilizza il logger LambdaLogger
fornito dall'oggetto contestuale. Per i test, l'applicazione utilizza una classe TestLogger
personalizzata che implementa l'interfaccia LambdaLogger
con un logger Log4j2. Viene utilizzato SLF4J come facciata per la compatibilità con. AWS SDK Le librerie di logging sono escluse dall'output di compilazione per mantenere il pacchetto di implementazione di dimensioni ridotte.