View a markdown version of this page

Configura le funzioni durevoli Lambda - AWS Lambda
Abilita un'esecuzione duraturaBest practice per la configurazione

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

Configura le funzioni durevoli Lambda

Le impostazioni di esecuzione durevoli controllano per quanto tempo può essere eseguita la funzione Lambda e per quanto tempo il servizio conserva la cronologia di esecuzione. Configura queste impostazioni per abilitare l'esecuzione duratura della tua funzione.

Abilita un'esecuzione duratura

Configura l'DurableConfigoggetto durante la creazione della funzione per impostare il timeout di esecuzione e la conservazione della cronologia. È possibile abilitare l'esecuzione duratura solo durante la creazione di una funzione. Non è possibile abilitarla su funzioni esistenti.

AWS CLI

aws lambda create-function \
  --function-name my-durable-function \
  --runtime nodejs24.x \
  --role arn:aws:iam::123456789012:role/my-durable-role \
  --handler index.handler \
  --zip-file fileb://function.zip \
  --durable-config '{"ExecutionTimeout": 3600, "RetentionPeriodInDays": 30}'
CloudFormation

Resources:
  MyDurableFunction:
    Type: AWS::Lambda::Function
    Properties:
      FunctionName: my-durable-function
      Runtime: nodejs24.x
      Handler: index.handler
      Code:
        ZipFile: |
          // Your durable function code
      DurableConfig:
        ExecutionTimeout: 3600
        RetentionPeriodInDays: 30

Parametri di configurazione:

  • ExecutionTimeout— Il tempo massimo, in secondi, di esecuzione di un'esecuzione durevole prima che Lambda interrompa l'esecuzione. Questo timeout si applica all'intera esecuzione duratura, non alle chiamate di singole funzioni. Intervallo valido: 1—31622400.

  • RetentionPeriodInDays— Il numero di giorni in cui conservare la cronologia di esecuzione dopo il completamento di un'esecuzione durevole. Dopo questo periodo, la cronologia delle esecuzioni non è più disponibile tramite l'GetDurableExecutionHistoryAPI. Intervallo valido: 1—90.

Per il riferimento completo all'API, consulta DurableConfigla sezione Lambda API Reference.

Best practice per la configurazione

Segui queste best practice per configurare funzioni durevoli per l'uso in produzione:

  • Imposta i timeout di esecuzione appropriati: configura ExecutionTimeout in base alla durata massima prevista del flusso di lavoro. Non impostate timeout inutilmente lunghi poiché influiscono sull'allocazione dei costi e delle risorse.

  • Bilanciate la conservazione con i costi di storage: impostate RetentionPeriodInDays in base ai requisiti di debug e audit. Periodi di conservazione più lunghi aumentano i costi di storage.

  • Monitora le dimensioni dello stato: gli oggetti a stato di grandi dimensioni aumentano i costi di storage e possono influire sulle prestazioni. Riduci al minimo lo stato e utilizza lo storage esterno per dati di grandi dimensioni.

  • Configura la registrazione appropriata: abilita la registrazione dettagliata per la risoluzione dei problemi dei flussi di lavoro a lunga durata, ma considera l'impatto sul volume e sui costi dei log.

Esempio di configurazione di produzione:


{
  "ExecutionTimeout": 86400,
  "RetentionPeriodInDays": 7
}

Questo esempio imposta un timeout di esecuzione di 24 ore (86.400 secondi) con un periodo di conservazione di 7 giorni, che bilancia la visibilità del debug con i costi di storage per la maggior parte dei carichi di lavoro di produzione.