Konfigurasikan fungsi Lambda yang tahan lama

Pengaturan eksekusi tahan lama mengontrol berapa lama fungsi Lambda Anda dapat berjalan dan berapa lama layanan mempertahankan riwayat eksekusi. Konfigurasikan pengaturan ini untuk mengaktifkan eksekusi tahan lama untuk fungsi Anda.

Aktifkan eksekusi yang tahan lama

Konfigurasikan DurableConfig objek saat membuat fungsi Anda untuk mengatur batas waktu eksekusi dan retensi riwayat. Anda hanya dapat mengaktifkan eksekusi yang tahan lama saat membuat fungsi. Anda tidak dapat mengaktifkannya pada fungsi yang ada.

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
          

Parameter konfigurasi:

• ExecutionTimeout— Waktu maksimum dalam hitungan detik eksekusi yang tahan lama dapat dijalankan sebelum Lambda menghentikan eksekusi. Batas waktu ini berlaku untuk seluruh eksekusi tahan lama, bukan pemanggilan fungsi individual. Kisaran yang valid: 1-31622400.

• RetentionPeriodInDays— Jumlah hari untuk mempertahankan riwayat eksekusi setelah eksekusi yang tahan lama selesai. Setelah periode ini, riwayat eksekusi tidak lagi tersedia melalui GetDurableExecutionHistory API. Rentang yang valid: 1—90.

Untuk referensi API selengkapnya, lihat DurableConfigdi Referensi API Lambda.

Praktik terbaik konfigurasi

Ikuti praktik terbaik ini saat mengonfigurasi fungsi tahan lama untuk penggunaan produksi:

• Tetapkan batas waktu eksekusi yang sesuai - Konfigurasikan ExecutionTimeout berdasarkan durasi maksimum yang diharapkan alur kerja Anda. Jangan menetapkan batas waktu lama yang tidak perlu karena mempengaruhi biaya dan alokasi sumber daya.

• Retensi saldo dengan biaya penyimpanan - Tetapkan RetentionPeriodInDays berdasarkan persyaratan debugging dan audit Anda. Periode retensi yang lebih lama meningkatkan biaya penyimpanan.

• Ukuran status monitor — Objek status besar meningkatkan biaya penyimpanan dan dapat memengaruhi kinerja. Jaga status minimal dan gunakan penyimpanan eksternal untuk data besar.

• Konfigurasikan logging yang sesuai — Aktifkan pencatatan terperinci untuk memecahkan masalah alur kerja yang berjalan lama, tetapi pertimbangkan dampaknya pada volume dan biaya log.

Contoh konfigurasi produksi:

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

Contoh ini menetapkan batas waktu eksekusi 24 jam (86.400 detik) dengan periode retensi 7 hari, yang menyeimbangkan visibilitas debugging dengan biaya penyimpanan untuk sebagian besar beban kerja produksi.