Monitoraggio di funzioni durature - AWS Lambda

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

Monitoraggio di funzioni durature

Puoi monitorare le tue funzioni durevoli utilizzando CloudWatch metriche, CloudWatch registri e tracciamento. Poiché le funzioni durevoli possono funzionare per periodi prolungati e richiamare più funzioni, il loro monitoraggio richiede la comprensione dei loro modelli di esecuzione unici, inclusi i checkpoint, le transizioni di stato e il comportamento di riproduzione.

CloudWatch metriche

Lambda pubblica automaticamente le metriche senza costi CloudWatch aggiuntivi. Le funzioni durevoli forniscono metriche aggiuntive oltre alle metriche Lambda standard per aiutarti a monitorare i flussi di lavoro di lunga durata, la gestione dello stato e l'utilizzo delle risorse.

Metriche di esecuzione durevoli

Lambda emette le seguenti metriche per esecuzioni durevoli:

Metrica Description
ApproximateRunningDurableExecutions Numero di esecuzioni durevoli nello stato RUNNING
ApproximateRunningDurableExecutionsUtilization Percentuale della quota massima di esecuzioni durevoli in esecuzione del tuo account attualmente in uso
DurableExecutionDuration Tempo trascorso dall'orologio da parete, espresso in millisecondi, durante il quale un'esecuzione durevole è rimasta nello stato RUNNING
DurableExecutionStarted Numero di esecuzioni durevoli avviate
DurableExecutionStopped Numero di esecuzioni durevoli interrotte utilizzando l'API StopDurableExecution
DurableExecutionSucceeded Numero di esecuzioni durevoli completate con successo
DurableExecutionFailed Numero di esecuzioni durevoli completate con un errore
DurableExecutionTimedOut Numero di esecuzioni durevoli che hanno superato il timeout di esecuzione configurato
DurableExecutionOperations Numero cumulativo di operazioni eseguite nell'ambito di un'esecuzione durevole (max: 3.000)
DurableExecutionStorageWrittenBytes Quantità cumulativa di dati in byte resa persistente da un'esecuzione durevole (max: 100 MB)

CloudWatch metriche

Lambda emette metriche standard di invocazione, prestazioni e concorrenza per funzioni durevoli. Poiché un'esecuzione durevole può includere più chiamate di funzioni man mano che avanza attraverso checkpoint e replay, queste metriche si comportano in modo diverso rispetto alle funzioni standard:

  • Invocazioni: conta ogni chiamata di funzione, inclusi i replay. Una singola esecuzione durevole può generare più punti dati di invocazione.

  • Durata: misura ogni chiamata di funzione separatamente. Da utilizzare DurableExecutionDuration per il tempo totale impiegato da una singola esecuzione durevole.

  • Errori: tiene traccia degli errori di invocazione delle funzioni. Da utilizzare per gli errori a livello DurableExecutionFailed di esecuzione.

Per un elenco completo delle metriche Lambda standard, consulta Tipi di metriche per le funzioni Lambda.

Creazione di allarmi CloudWatch

Crea CloudWatch allarmi per avvisarti quando le metriche superano le soglie. Gli allarmi più comuni includono:

  • ApproximateRunningDurableExecutionsUtilizationsupera l'80% della tua quota

  • DurableExecutionFailedaumenta al di sopra di una soglia

  • DurableExecutionTimedOutindica che le esecuzioni stanno scadendo

  • DurableExecutionStorageWrittenBytessi avvicina ai limiti di archiviazione

Per ulteriori informazioni, vedere Uso degli CloudWatch allarmi.

.

EventBridge eventi

Lambda pubblica eventi duraturi di modifica dello stato di esecuzione su. EventBridge Puoi utilizzare questi eventi per attivare flussi di lavoro, inviare notifiche o tenere traccia delle modifiche del ciclo di vita dell'esecuzione tra le tue funzioni durevoli.

Eventi durevoli di modifica dello stato di esecuzione

Lambda emette un evento EventBridge ogni volta che un'esecuzione durevole cambia lo stato. Questi eventi hanno le seguenti caratteristiche:

  • Origine: aws.lambda

  • Tipo di dettaglio: Durable Execution Status Change

Gli eventi di modifica dello stato vengono pubblicati per i seguenti stati di esecuzione:

  • RUNNING- Esecuzione iniziata

  • SUCCEEDED- Esecuzione completata con successo

  • STOPPED- Esecuzione interrotta utilizzando l' StopDurableExecution API

  • FAILED- Esecuzione non riuscita con un errore

  • TIMED_OUT- L'esecuzione ha superato il timeout configurato

L'esempio seguente mostra un evento duraturo di modifica dello stato di esecuzione:

{ "version": "0", "id": "d019b03c-a8a3-9d58-85de-241e96206538", "detail-type": "Durable Execution Status Change", "source": "aws.lambda", "account": "123456789012", "time": "2025-11-20T13:08:22Z", "region": "us-east-1", "resources": [], "detail": { "durableExecutionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/090c4189-b18b-4296-9d0c-cfd01dc3a122/9f7d84c9-ea3d-3ffc-b3e5-5ec51c34ffc9", "durableExecutionName": "order-123", "functionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function:2", "status": "RUNNING", "startTimestamp": "2025-11-20T13:08:22.345Z" } }

Per gli stati terminali (SUCCEEDEDSTOPPED,,FAILED,TIMED_OUT), l'evento include un endTimestamp campo che indica quando l'esecuzione è stata completata.

Creazione di EventBridge regole

Crea regole per indirizzare eventi duraturi di modifica dello stato di esecuzione verso obiettivi come Amazon Simple Notification Service, Amazon Simple Queue Service o altre funzioni Lambda.

L'esempio seguente crea una regola che corrisponde a tutte le modifiche durature dello stato di esecuzione:

{ "source": ["aws.lambda"], "detail-type": ["Durable Execution Status Change"] }

L'esempio seguente crea una regola che corrisponde solo alle esecuzioni non riuscite:

{ "source": ["aws.lambda"], "detail-type": ["Durable Execution Status Change"], "detail": { "status": ["FAILED"] } }

L'esempio seguente crea una regola che corrisponde alle modifiche di stato per una funzione specifica:

{ "source": ["aws.lambda"], "detail-type": ["Durable Execution Status Change"], "detail": { "functionArn": [{ "prefix": "arn:aws:lambda:us-east-1:123456789012:function:my-function" }] } }

Per ulteriori informazioni sulla creazione di regole, consulta EventBridge i tutorial di Amazon nella Guida per l' EventBridge utente.

AWS X-Ray tracciamento

È possibile abilitare il tracciamento a raggi X sulle funzioni durevoli. Lambda passa l'intestazione di traccia X-Ray all'esecuzione durevole, consentendoti di tracciare le richieste in tutto il flusso di lavoro.

Per abilitare il tracciamento a raggi X tramite la console Lambda, scegli la tua funzione, quindi scegli Strumenti di configurazione, monitoraggio e operazioni e attiva il tracciamento attivo in X-Ray.

Per abilitare il tracciamento X-Ray utilizzando: AWS CLI

aws lambda update-function-configuration \ --function-name my-durable-function \ --tracing-config Mode=Active

Per abilitare il AWS X-Ray tracciamento utilizzando: AWS SAM

Resources: MyDurableFunction: Type: AWS::Serverless::Function Properties: Tracing: Active DurableConfig: ExecutionTimeout: 3600

Per ulteriori informazioni su X-Ray, consulta la AWS X-Ray Developer Guide.