Memantau fungsi tahan lama - AWS Lambda

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

Memantau fungsi tahan lama

Anda dapat memantau fungsi tahan lama Anda menggunakan CloudWatch metrik, CloudWatch Log, dan penelusuran. Karena fungsi tahan lama dapat berjalan untuk waktu yang lama dan mencakup beberapa pemanggilan fungsi, pemantauannya memerlukan pemahaman pola eksekusi uniknya, termasuk pos pemeriksaan, transisi status, dan perilaku pemutaran ulang.

CloudWatch metrik

Lambda secara otomatis menerbitkan metrik tanpa CloudWatch biaya tambahan. Fungsi tahan lama menyediakan metrik tambahan di luar metrik Lambda standar untuk membantu Anda memantau alur kerja yang berjalan lama, manajemen status, dan pemanfaatan sumber daya.

Metrik eksekusi yang tahan lama

Lambda memancarkan metrik berikut untuk eksekusi yang tahan lama:

Metrik Deskripsi
ApproximateRunningDurableExecutions Jumlah eksekusi tahan lama dalam status RUNNING
ApproximateRunningDurableExecutionsUtilization Persentase kuota eksekusi tahan lama maksimum akun Anda yang sedang digunakan
DurableExecutionDuration Waktu jam dinding berlalu dalam milidetik sehingga eksekusi yang tahan lama tetap dalam status RUNNING
DurableExecutionStarted Jumlah eksekusi tahan lama yang dimulai
DurableExecutionStopped Jumlah eksekusi tahan lama yang berhenti menggunakan API StopDurableExecution
DurableExecutionSucceeded Jumlah eksekusi tahan lama yang berhasil diselesaikan
DurableExecutionFailed Jumlah eksekusi tahan lama yang diselesaikan dengan kegagalan
DurableExecutionTimedOut Jumlah eksekusi tahan lama yang melebihi batas waktu eksekusi yang dikonfigurasi
DurableExecutionOperations Jumlah kumulatif operasi yang dilakukan dalam eksekusi yang tahan lama (maks: 3.000)
DurableExecutionStorageWrittenBytes Jumlah kumulatif data dalam byte dipertahankan oleh eksekusi yang tahan lama (maks: 100 MB)

CloudWatch metrik

Lambda memancarkan metrik pemanggilan standar, kinerja, dan konkurensi untuk fungsi yang tahan lama. Karena eksekusi yang tahan lama dapat menjangkau beberapa pemanggilan fungsi saat berlangsung melalui pos pemeriksaan dan pemutaran ulang, metrik ini berperilaku berbeda dari fungsi standar:

  • Pemanggilan: Menghitung setiap pemanggilan fungsi, termasuk pemutaran ulang. Eksekusi tunggal yang tahan lama dapat menghasilkan beberapa titik data pemanggilan.

  • Durasi: Mengukur setiap pemanggilan fungsi secara terpisah. Gunakan DurableExecutionDuration untuk total waktu yang diambil oleh eksekusi tunggal yang tahan lama.

  • Kesalahan: Melacak kegagalan pemanggilan fungsi. Gunakan DurableExecutionFailed untuk kegagalan tingkat eksekusi.

Untuk daftar lengkap metrik Lambda standar, lihat Jenis metrik untuk fungsi Lambda.

Membuat CloudWatch alarm

Buat CloudWatch alarm untuk memberi tahu Anda saat metrik melebihi ambang batas. Alarm umum meliputi:

  • ApproximateRunningDurableExecutionsUtilizationmelebihi 80% dari kuota Anda

  • DurableExecutionFailedmeningkat di atas ambang batas

  • DurableExecutionTimedOutmenunjukkan eksekusi habis waktu

  • DurableExecutionStorageWrittenBytesmendekati batas penyimpanan

Untuk informasi selengkapnya, lihat Menggunakan CloudWatch alarm.

.

EventBridge acara

Lambda menerbitkan peristiwa perubahan status eksekusi tahan lama ke. EventBridge Anda dapat menggunakan peristiwa ini untuk memicu alur kerja, mengirim pemberitahuan, atau melacak perubahan siklus hidup eksekusi di seluruh fungsi tahan lama Anda.

Peristiwa perubahan status eksekusi yang tahan lama

Lambda memancarkan peristiwa ke EventBridge setiap kali eksekusi tahan lama mengubah status. Peristiwa ini memiliki karakteristik sebagai berikut:

  • Sumber: aws.lambda

  • Jenis detail: Durable Execution Status Change

Peristiwa perubahan status dipublikasikan untuk status eksekusi berikut:

  • RUNNING- Eksekusi dimulai

  • SUCCEEDED- Eksekusi berhasil diselesaikan

  • STOPPED- Eksekusi berhenti menggunakan StopDurableExecution API

  • FAILED- Eksekusi gagal dengan kesalahan

  • TIMED_OUT- Eksekusi melebihi batas waktu yang dikonfigurasi

Contoh berikut menunjukkan peristiwa perubahan status eksekusi tahan lama:

{ "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" } }

Untuk status terminal (SUCCEEDEDSTOPPED,FAILED,,TIMED_OUT), acara menyertakan endTimestamp bidang yang menunjukkan kapan eksekusi selesai.

Membuat EventBridge aturan

Buat aturan untuk merutekan peristiwa perubahan status eksekusi tahan lama ke target seperti Amazon Simple Notification Service, Amazon Simple Queue Service, atau fungsi Lambda lainnya.

Contoh berikut membuat aturan yang cocok dengan semua perubahan status eksekusi tahan lama:

{ "source": ["aws.lambda"], "detail-type": ["Durable Execution Status Change"] }

Contoh berikut membuat aturan yang hanya cocok dengan eksekusi yang gagal:

{ "source": ["aws.lambda"], "detail-type": ["Durable Execution Status Change"], "detail": { "status": ["FAILED"] } }

Contoh berikut membuat aturan yang cocok dengan perubahan status untuk fungsi tertentu:

{ "source": ["aws.lambda"], "detail-type": ["Durable Execution Status Change"], "detail": { "functionArn": [{ "prefix": "arn:aws:lambda:us-east-1:123456789012:function:my-function" }] } }

Untuk informasi selengkapnya tentang membuat aturan, lihat EventBridge tutorial Amazon di Panduan EventBridge Pengguna.

AWS X-Ray menelusuri

Anda dapat mengaktifkan penelusuran X-Ray pada fungsi tahan lama Anda. Lambda meneruskan header jejak X-Ray ke eksekusi yang tahan lama, memungkinkan Anda melacak permintaan di seluruh alur kerja Anda.

Untuk mengaktifkan X-Ray; melacak menggunakan konsol Lambda, pilih fungsi Anda, lalu pilih Alat Konfigurasi, Pemantauan dan operasi, dan aktifkan Penelusuran Aktif di bawah X-Ray.

Untuk mengaktifkan penelusuran X-Ray AWS CLI menggunakan:

aws lambda update-function-configuration \ --function-name my-durable-function \ --tracing-config Mode=Active

Untuk mengaktifkan AWS X-Ray penelusuran menggunakan AWS SAM:

Resources: MyDurableFunction: Type: AWS::Serverless::Function Properties: Tracing: Active DurableConfig: ExecutionTimeout: 3600

Untuk informasi selengkapnya tentang X-Ray, lihat Panduan AWS X-Ray Pengembang.