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 essere eseguite per lunghi periodi e comprendere più invocazioni di funzioni, il loro monitoraggio richiede la comprensione dei loro modelli di esecuzione unici, inclusi i checkpoint, le transizioni di stato e il comportamento di ripetizione. ## CloudWatch metriche Lambda pubblica automaticamente le metriche senza costi aggiuntivi CloudWatch . Le funzioni Durable 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 durature: | 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 | È trascorso il tempo in millisecondi in cui un'esecuzione duratura è rimasta nello stato RUNNING | | DurableExecutionStarted | Numero di esecuzioni durature iniziate | | 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 duratura (massimo: 3.000) | | DurableExecutionStorageWrittenBytes | Quantità cumulativa di dati in byte mantenuta da un'esecuzione duratura (max: 100 MB) | ### CloudWatch metriche Lambda emette metriche standard di invocazione, prestazioni e concorrenza per funzioni durature. Poiché un'esecuzione duratura può includere più invocazioni di funzioni man mano che procede attraverso checkpoint e replay, queste metriche si comportano diversamente rispetto alle funzioni standard: + **Richiami: conta ogni chiamata di funzione, inclusi i replay. ** Una singola esecuzione duratura può generare più punti dati di chiamata. + **Durata: ** misura ogni chiamata di funzione separatamente. Utilizza `DurableExecutionDuration` il tempo totale impiegato da una singola esecuzione duratura. + **Errori: ** tiene traccia degli errori di richiamo delle funzioni. Da utilizzare per errori a livello `DurableExecutionFailed` di esecuzione. Per un elenco completo delle metriche Lambda standard, vedi [ Tipi di metriche per le funzioni Lambda. ](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html) ### Creazione di allarmi CloudWatch Crea CloudWatch allarmi per notificarti quando le metriche superano le soglie. Gli allarmi comuni includono: + `ApproximateRunningDurableExecutionsUtilization`supera l'80% della tua quota + `DurableExecutionFailed`aumenta al di sopra di una soglia + `DurableExecutionTimedOut`indica che le esecuzioni stanno scadendo + `DurableExecutionStorageWrittenBytes`si avvicina ai limiti di archiviazione Per ulteriori informazioni, vedere [ Utilizzo degli CloudWatch allarmi](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html). ## EventBridge eventi Lambda pubblica eventi durevoli di modifica dello stato di esecuzione in. EventBridge Puoi utilizzare questi eventi per attivare flussi di lavoro, inviare notifiche o tenere traccia delle modifiche al ciclo di vita dell'esecuzione nelle tue funzioni durevoli. ### Eventi di modifica dello stato di esecuzione duraturi Lambda emette un evento EventBridge ogni volta che un'esecuzione durevole cambia 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 (`SUCCEEDED``STOPPED`,,`FAILED`,`TIMED_OUT`), l'evento include un `endTimestamp` campo che indica quando l'esecuzione è stata completata. ### Creazione di EventBridge regole Crea EventBridge regole per indirizzare eventi duraturi di modifica dello stato di esecuzione a destinazioni 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 EventBridge regole, consulta i EventBridge tutorial di [ Amazon ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tutorial.html) nella Guida per l' EventBridge utente. ### Utilizzo di code di lettere morte con eventi EventBridge EventBridge Gli eventi di modifica dello stato forniscono una notifica in tempo reale quando un'esecuzione durevole entra in uno stato FAILED, STOPPED o TIMED\_OUT, ma non includono il payload dell'evento originale che ha attivato l'esecuzione. Per acquisire l'evento scatenante per un'analisi o una rielaborazione successive, configura una coda di lettere morte (DLQ) sulla tua funzione durevole. Quando un'esecuzione durevole fallisce dopo un'invocazione asincrona, Lambda invia l'evento di attivazione originale al DLQ configurato. Usa EventBridge eventi e DLQ insieme per una strategia completa di gestione dei guasti: + **EventBridge eventi**: attiva avvisi immediati, aggiorna le dashboard o avvia flussi di lavoro di correzione quando le esecuzioni falliscono. + **Dead-letter code**: preserva il payload originale dell'evento in modo da poter verificare la causa dell'errore, eseguire il debug del problema e, facoltativamente, rielaborare l'evento dopo aver risolto il problema sottostante. Per informazioni sulla configurazione di un DLQ sulla tua funzione, vedi queues. [ Dead-letter ](invocation-async-retain-records.md#invocation-dlq) ## AWS X-Ray tracciato Puoi abilitare il X-Ray tracciamento sulle tue funzioni durevoli. Lambda passa l'intestazione X-Ray trace all'esecuzione durevole, consentendoti di tracciare le richieste nel tuo flusso di lavoro. Per abilitare il X-Ray tracciamento utilizzando la console Lambda, scegli la tua funzione, quindi scegli Strumenti di configurazione, monitoraggio e operazioni e attiva Active tracing in. X-Ray Per abilitare il X-Ray tracciamento 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 X-Ray, consulta la Guida [ per gli ](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html)AWS X-Ray sviluppatori.