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](https://docs.aws.amazon.com//lambda/latest/dg/monitoring-metrics-types.html) le funzioni Lambda. ### Creazione di allarmi CloudWatch Crea CloudWatch allarmi per avvisarti quando le metriche superano le soglie. Gli allarmi più 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, [consulta Uso degli CloudWatch allarmi](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html). . ## 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 (`SUCCEEDED``STOPPED`,,`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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-tutorial.html) 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](https://docs.aws.amazon.com//xray/latest/devguide/aws-xray.html).