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
DurableExecutionDurationper 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
DurableExecutionFaileddi 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 quotaDurableExecutionFailedaumenta al di sopra di una sogliaDurableExecutionTimedOutindica che le esecuzioni stanno scadendoDurableExecutionStorageWrittenBytessi 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.lambdaTipo di dettaglio:
Durable Execution Status Change
Gli eventi di modifica dello stato vengono pubblicati per i seguenti stati di esecuzione:
RUNNING- Esecuzione iniziataSUCCEEDED- Esecuzione completata con successoSTOPPED- Esecuzione interrotta utilizzando l' StopDurableExecution APIFAILED- Esecuzione non riuscita con un erroreTIMED_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.