View a markdown version of this page

Konfigurasikan fungsi Lambda yang tahan lama - AWS Lambda
Aktifkan eksekusi yang tahan lamaPraktik terbaik konfigurasi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Konfigurasikan fungsi Lambda yang tahan lama

Pengaturan eksekusi tahan lama mengontrol berapa lama AWS Lambda fungsi Anda dapat berjalan, berapa lama layanan mempertahankan riwayat eksekusi, dan AWS KMS kunci mana yang mengenkripsi data eksekusi Anda. Konfigurasikan pengaturan ini untuk mengaktifkan eksekusi yang 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, "KMSKeyArn": "arn:aws:kms:us-east-1:111122223333:key/key-id"}'
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
        KMSKeyArn: "arn:aws:kms:us-east-1:111122223333:key/key-id"

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.

  • KMSKeyArn – Opsional. ARN dari kunci yang dikelola pelanggan untuk mengenkripsi data eksekusi yang tahan lama. Untuk informasi selengkapnya, lihat Mengenkripsi data eksekusi tahan lama Lambda.

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.

  • Enkripsi dengan AWS KMS kunci Anda sendiri — Setel KMSKeyArn ke kunci yang dikelola pelanggan untuk mengontrol rotasi kunci, akses audit, dan memenuhi persyaratan kepatuhan. Lihat Mengenkripsi AWS Lambda data eksekusi tahan lama.

Contoh konfigurasi produksi:


{
  "ExecutionTimeout": 86400,
  "RetentionPeriodInDays": 7,
  "KMSKeyArn": "arn:aws:kms:us-east-1:111122223333:key/key-id"
}

Contoh ini menetapkan batas waktu eksekusi 24 jam (86.400 detik), periode retensi 7 hari, dan kunci yang dikelola pelanggan untuk enkripsi.