Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Visualisasikan pemanggilan fungsi Lambda menggunakan AWS X-Ray
Anda dapat menggunakan AWS X-Ray untuk memvisualisasikan komponen aplikasi Anda, mengidentifikasi kemacetan kinerja, dan memecahkan masalah permintaan yang mengakibatkan kesalahan. Fungsi Lambda Anda mengirimkan data jejak ke X-Ray, dan X-Ray memproses data untuk membuat peta layanan dan rangkuman jejak yang dapat dicari.
Jika Anda mengaktifkan pelacakan X-Ray di layanan yang memanggil fungsi Anda, Lambda mengirim jejak ke X-Ray secara otomatis. Layanan hulu, seperti Amazon API Gateway, atau aplikasi yang dihosting di Amazon EC2 yang diinstrumentasikan dengan SDK X-Ray, membuat sampel permintaan yang masuk dan menambahkan header pelacakan yang memberi tahu Lambda apakah perlu mengirim jejak atau tidak. Jejak dari produsen pesan hulu, seperti Amazon SQS, secara otomatis ditautkan ke jejak dari fungsi Lambda hilir, menciptakan tampilan seluruh end-to-end aplikasi. Untuk informasi selengkapnya, lihat Menelusuri aplikasi berbasis peristiwa di Panduan Pengembang.AWS X-Ray
catatan
Penelusuran X-Ray saat ini tidak didukung untuk fungsi Lambda dengan Amazon Managed Streaming for Apache Kafka (Amazon MSK), Apache Kafka yang dikelola sendiri, Amazon MQ dengan ActiveMQ dan RabbitMQ, atau pemetaan sumber acara Amazon DocumentDB.
Untuk mengaktifkan penelusuran aktif pada fungsi Lambda Anda dengan konsol, ikuti langkah-langkah berikut:
Untuk mengaktifkan penelusuran aktif
Buka halaman Fungsi
di konsol Lambda. -
Pilih fungsi.
Pilih Konfigurasi dan kemudian pilih Alat Pemantauan dan operasi.
Pilih Edit.
-
Di bawah X-Ray, aktifkan penelusuran Aktif.
-
Pilih Simpan.
Harga
Anda dapat menggunakan penelusuran X-Ray secara gratis setiap bulan hingga batas tertentu sebagai bagian dari Tingkat AWS Gratis. Di luar ambang batas itu, X-Ray mengenakan biaya untuk penyimpanan dan pengambilan jejak. Untuk informasi selengkapnya, lihat harga AWS X-Ray
Fungsi Anda memerlukan izin untuk mengunggah data jejak ke X-Ray. Saat Anda mengaktifkan penelusuran di konsol Lambda, Lambda menambahkan izin yang diperlukan ke peran eksekusi fungsi Anda. Jika tidak, tambahkan AWSXRayDaemonWriteAccess
X-Ray tidak melacak semua permintaan ke aplikasi Anda. X-Ray menerapkan algoritma pengambilan sampel untuk memastikan bahwa penelusuran efisien, sambil tetap memberikan sampel yang representatif dari semua permintaan. Tingkat pengambilan sampel adalah 1 permintaan per detik dan 5 persen dari permintaan tambahan.
catatan
Anda tidak dapat mengonfigurasi laju pengambilan sampel X-Ray untuk fungsi Anda.
Di X-Ray, jejak merekam informasi tentang permintaan yang diproses oleh satu atau beberapa layanan. Lambda mencatat 2 segmen per jejak, yang menciptakan dua node pada grafik layanan. Gambar berikut menyoroti dua node ini:
![Peta layanan X-Ray dengan satu fungsi.](images/xray-servicemap-function.png)
Node pertama di sebelah kiri mewakili layanan Lambda, yang menerima permintaan pemanggilan. Node kedua mewakili fungsi Lambda spesifik Anda. Contoh berikut menunjukkan jejak dengan dua segmen ini. Keduanya bernama fungsi saya, tetapi yang satu memiliki asal AWS::Lambda
dan yang lainnya memiliki asal usul. AWS::Lambda::Function
Jika AWS::Lambda
segmen menunjukkan kesalahan, layanan Lambda mengalami masalah. Jika AWS::Lambda::Function
segmen menunjukkan kesalahan, fungsi Anda mengalami masalah.
![Jejak X-Ray yang menunjukkan latensi di setiap subsegmen dari pemanggilan Lambda tertentu.](images/nodejs-xray-timeline.png)
Segmen fungsi (AWS::Lambda::Function
) dilengkapi dengan subsegmen untukInitialization
,Invocation
, Restore
(Lambda SnapStarthanya), danOverhead
. Untuk informasi selengkapnya, lihat Siklus hidup lingkungan eksekusi Lambda.
catatan
X-Ray memperlakukan pengecualian yang tidak tertangani dalam fungsi Lambda Anda sebagai status. Error
X-Ray merekam Fault
status hanya ketika Lambda mengalami kesalahan server internal. Untuk informasi selengkapnya, lihat Kesalahan, kesalahan, dan pengecualian di Panduan Pengembang X-Ray.
Subsegmen Initialization
merupakan fase init dari siklus hidup lingkungan eksekusi Lambda. Dalam fase ini, Lambda membuat atau membatalkan pembekuan lingkungan eksekusi dengan sumber daya yang Anda konfigurasi, mengunduh kode dan semua lapisan, menginisialisasi ekstensi, menginisialisasi runtime, lalu menjalankan kode inisialisasi fungsi.
Subsegmen Invocation
merupakan fase invokasi tempat Lambda memanggil handler fungsi. Ini dimulai dengan pendaftaran runtime dan ekstensi serta berakhir ketika runtime siap untuk mengirim respon.
(Lambda SnapStarthanya) Restore Subsegmen menunjukkan waktu yang diperlukan Lambda untuk memulihkan snapshot, memuat runtime (JVM), dan menjalankan kait runtime apa pun. afterRestore Proses memulihkan snapshot dapat mencakup waktu yang dihabiskan untuk aktivitas di luar microVM. Kali ini dilaporkan di Restore
subsegmen. Anda tidak dikenakan biaya untuk waktu yang dihabiskan di luar microVM untuk memulihkan snapshot.
Subsegmen Overhead
merupakan fase yang terjadi antara waktu ketika runtime mengirimkan respon dan sinyal untuk invokasi berikutnya. Selama waktu ini, runtime menyelesaikan semua tugas yang terkait dengan invokasi dan mempersiapkan untuk membekukan sandbox.
catatan
Kadang-kadang, Anda mungkin melihat kesenjangan besar antara inisialisasi fungsi dan fase pemanggilan dalam jejak X-Ray Anda. Untuk fungsi yang menggunakan konkurensi yang disediakan, ini karena Lambda menginisialisasi instance fungsi Anda jauh sebelum pemanggilan. Untuk fungsi yang menggunakan konkurensi tanpa syarat (sesuai permintaan), Lambda dapat secara proaktif menginisialisasi instance fungsi, meskipun tidak ada pemanggilan. Secara visual, kedua kasus ini muncul sebagai celah waktu antara fase inisialisasi dan pemanggilan.
penting
Di Lambda, Anda dapat menggunakan SDK X-Ray untuk memperluas subsegmen Invocation
dengan subsegmen tambahan untuk panggilan hilir, anotasi, dan metadata. Anda tidak dapat mengakses segmen fungsi secara langsung atau merekam pekerjaan yang dilakukan di luar lingkup invokasi handler.
Lihat topik berikut untuk pengantar khusus bahasa tertentu terkait pelacakan di Lambda:
Untuk daftar lengkap layanan yang mendukung instrumentasi aktif, lihat AWS Layanan yang didukung di Panduan AWS X-Ray Pengembang.
Bagian-bagian
Izin peran eksekusi
Lambda memerlukan izin berikut untuk mengirim data jejak ke X-Ray. Tambahkan izin ke peran eksekusi fungsi Anda.
Izin ini disertakan dalam kebijakan AWSXRayDaemonWriteAccess
AWS X-Ray Daemon
Alih-alih mengirim data jejak langsung ke API X-Ray, SDK X-Ray menggunakan proses daemon. Daemon AWS X-Ray adalah aplikasi yang berjalan di lingkungan Lambda dan mendengarkan lalu lintas UDP yang berisi segmen dan subsegmen. Ini menyangga data masuk dan menuliskannya ke X-Ray dalam batch sehingga mengurangi pemrosesan dan overhead memori yang diperlukan untuk melacak invokasi.
Runtime Lambda memungkinkan daemon hingga 3 persen memori fungsi yang dikonfigurasi atau 16 MB, mana pun yang lebih besar. Jika fungsi Anda kehabisan memori selama invokasi, runtime mengakhiri proses daemon terlebih dahulu untuk mengosongkan memori.
Proses daemon dikelola penuh oleh Lambda dan tidak dapat dikonfigurasi oleh pengguna. Semua segmen yang dihasilkan oleh invokasi fungsi direkam dalam akun yang sama dengan fungsi Lambda. Daemon tidak dapat dikonfigurasi untuk mengalihkannya ke akun lain.
Untuk informasi lebih lanjut, lihat Daemon X-Ray dalam Panduan Developer X-Ray.
Mengaktifkan pelacakan aktif dengan API Lambda
Untuk mengelola konfigurasi penelusuran dengan AWS CLI atau AWS SDK, gunakan operasi API berikut:
Contoh AWS CLI perintah berikut memungkinkan penelusuran aktif pada fungsi bernama my-function.
aws lambda update-function-configuration \ --function-name my-function \ --tracing-config Mode=Active
Mode penelusuran adalah bagian dari konfigurasi khusus versi saat Anda memublikasikan versi fungsi Anda. Anda tidak dapat mengubah mode pelacakan pada versi yang telah diterbitkan.
Mengaktifkan penelusuran aktif dengan AWS CloudFormation
Untuk mengaktifkan penelusuran pada AWS::Lambda::Function
sumber daya dalam AWS CloudFormation templat, gunakan TracingConfig
properti.
contoh function-inline.yml – Konfigurasi pelacakan
Resources: function: Type: AWS::Lambda::Function Properties:
TracingConfig: Mode: Active
...
Untuk sumber AWS::Serverless::Function
daya AWS Serverless Application Model (AWS SAM), gunakan Tracing
properti.
contoh template.yml – Konfigurasi pelacakan
Resources: function: Type: AWS::Serverless::Function Properties:
Tracing: Active
...