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:

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:

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

Creazione di allarmi CloudWatch

Crea CloudWatch allarmi per notificarti quando le metriche superano le soglie. Gli allarmi comuni includono:

Per ulteriori informazioni, vedere Utilizzo degli CloudWatch allarmi.

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:

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

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 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 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:

Per informazioni sulla configurazione di un DLQ sulla tua funzione, vedi queues. Dead-letter

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 AWS X-Ray sviluppatori.