Visualisasikan pemanggilan fungsi Lambda menggunakan AWS X-Ray

Anda dapat menggunakannya AWS X-Ray untuk memvisualisasikan komponen aplikasi Anda, mengidentifikasi hambatan kinerja, dan memecahkan masalah permintaan yang mengakibatkan kesalahan. Fungsi Lambda Anda mengirim data jejak ke X-Ray, dan mem X-Ray proses data untuk menghasilkan peta layanan dan ringkasan jejak yang dapat dicari.

Lambda mendukung dua mode pelacakan untuk X-Ray: Active danPassThrough. Dengan pen Active elusuran, Lambda secara otomatis membuat segmen jejak untuk pemanggilan fungsi dan mengirimkannya ke. X-Ray PassThroughmode, di sisi lain, hanya menyebarkan konteks pelacakan ke layanan hilir.

Jika Anda telah mengaktifkan pel Active acakan untuk fungsi Anda, Lambda secara otomatis mengirimkan jejak ke X-Ray permintaan sampel. Biasanya, layanan upstream, seperti Amazon API Gateway atau aplikasi yang dihosting di Amazon EC2 yang diinstrumentasikan dengan X-Ray SDK, memutuskan apakah permintaan masuk harus dilacak, kemudian menambahkan keputusan pengambilan sampel tersebut sebagai header pelacakan. Lambda menggunakan header itu untuk memutuskan untuk mengirim jejak atau tidak. Jejak dari produsen pesan hulu, seperti Amazon SQS, secara otomatis ditautkan ke jejak dari fungsi Lambda hilir, menciptakan tampilan ujung ke ujung dari seluruh aplikasi. Untuk informasi selengkapnya, lihat Men elusuri aplikasi berbasis peristiwa di Panduan Peng AWS X-Ray embang.

Untuk mengaktifkan pelacakan aktif pada fungsi Lambda Anda dengan konsol, ikuti langkah-langkah berikut:

Fungsi Anda memerlukan izin untuk mengunggah data jejak ke X-Ray. Saat Anda mengaktifkan pelacakan di konsol Lambda, Lambda menambahkan izin yang diperlukan ke peran eksekusi fungsi Anda. Atau, tambahkan kebijakan AWSXRayDaemonWriteAccess ke peran eksekusi.

X-Ray tidak melacak semua permintaan ke aplikasi Anda. X-Ray menerapkan algoritma sampling untuk memastikan bahwa pelacakan efisien, sambil tetap memberikan sampel yang representatif dari semua permintaan. Tingkat pengambilan sampel adalah 1 permintaan per detik dan 5 persen dari permintaan tambahan. Anda tidak dapat mengonfigurasi la X-Ray ju pengambilan sampel untuk fungsi Anda.

Memahami X-Ray jejak

Dalam X-Ray, jejak mencatat informasi tentang permintaan yang diproses oleh satu atau lebih layanan. Lambda merekam 2 segmen per jejak, yang membuat dua node pada grafik layanan. Gambar berikut menyoroti dua node ini:

Node pertama di sebelah kiri mewakili layanan Lambda, yang menerima permintaan pemanggilan. Node kedua mewakili fungsi Lambda spesifik Anda.

Segmen yang direkam untuk layanan Lambda,AWS::Lambda, mencakup semua langkah yang diperlukan untuk mempersiapkan lingkungan eksekusi Lambda. Ini termasuk penjadwalan microVM, membuat atau membuka pembekuan lingkungan eksekusi dengan sumber daya yang telah Anda konfigurasikan, serta mengunduh kode fungsi Anda dan semua lapisan.

AWS::Lambda::FunctionSegmen ini untuk pekerjaan yang dilakukan oleh fungsi.

Old-style AWS X-Ray Struktur segmen lambda

X-Ray Struktur gaya lama untuk AWS::Lambda segmen terlihat seperti berikut:

Dalam format ini, segmen fungsi memiliki subsegmen untukInitialization,Invocation, danOverhead. Hanya SnapStart saja, ada juga Restore subsegmen (tidak ditunjukkan pada diagram ini).

Subsegmen Initialization merupakan fase init dari siklus hidup lingkungan eksekusi Lambda. Selama fase ini, Lambda menginisialisasi ekstensi, menginisialisasi runtime, dan 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.

(Hanya Lambda SnapStart ) Restore Subsegmen menunjukkan waktu yang dibutuhkan Lambda untuk memulihkan snapshot, memuat runtime, dan menjalankan kait runtime setelah pemulihan. Terapkan kode sebelum atau sesudah snapshot fungsi Lambda 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.

Untuk informasi selengkapnya tentang fase lingkungan eksekusi Lambda, lihatMemahami siklus hidup lingkungan pelaksanaan Lambda.

Contoh jejak menggunakan X-Ray struktur gaya lama ditunjukkan pada diagram berikut.

Perhatikan dua segmen dalam contoh. Keduanya dinamai fungsi saya, tetapi yang satu memiliki asal AWS::Lambda dan yang lainnya memiliki asal dari. AWS::Lambda::Function Jika AWS::Lambda segmen menunjukkan kesalahan, layanan Lambda mengalami masalah. Jika AWS::Lambda::Function segmen menunjukkan kesalahan, fungsi Anda mengalami masalah.

New-style AWS X-Ray Struktur segmen lambda

X-Ray Struktur gaya baru untuk AWS::Lambda segmen terlihat seperti berikut:

Dalam format baru ini, Init Subsegmen mewakili fase init dari siklus hidup lingkungan eksekusi Lambda seperti sebelumnya.

Tidak ada segmen pemanggilan dalam format baru. Sebaliknya, subsegmen pelanggan dilampirkan langsung ke AWS::Lambda::Function segmen. Segmen ini berisi metrik berikut sebagai anotasi:

Contoh jejak menggunakan X-Ray struktur gaya baru ditunjukkan pada diagram berikut.

Perhatikan dua segmen dalam contoh. Keduanya dinamai fungsi saya, tetapi yang satu memiliki asal AWS::Lambda dan yang lainnya memiliki asal dari. AWS::Lambda::Function Jika AWS::Lambda segmen menunjukkan kesalahan, layanan Lambda mengalami masalah. Jika AWS::Lambda::Function segmen menunjukkan kesalahan, fungsi Anda mengalami masalah.

Lihat topik berikut untuk pengantar khusus bahasa tertentu terkait pelacakan di Lambda:

Untuk daftar lengkap layanan yang mendukung instrumentasi aktif, lihat Di dukung Layanan AWS di Panduan Peng AWS X-Ray embang.

Perilaku penelusuran default di Lambda

Jika Anda tidak mengaktifkan pel Active acakan, Lambda akan menggunakan mode pel PassThrough acakan secara default.

Dalam PassThrough mode, Lambda meneruskan header pel X-Ray acakan ke layanan hilir, tetapi tidak mengirim jejak secara otomatis. Ini benar bahkan jika header pelacakan berisi keputusan untuk mengambil sampel permintaan. Jika layanan hulu tidak menyediakan header pel X-Ray acakan, Lambda menghasilkan header dan membuat keputusan untuk tidak mengambil sampel. Namun, Anda dapat mengirim jejak Anda sendiri dengan memanggil pustaka pelacakan dari kode fungsi Anda.

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 terkelola AWSXRayDaemonWriteAccess.

Mengaktifkan pel acakan Aktif dengan API Lambda

Untuk mengelola konfigurasi pelacakan dengan AWS CLI atau AWS SDK, gunakan operasi API berikut:

Per AWS CLI intah contoh berikut memungkinkan pelacakan aktif pada fungsi bernama my-function.

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

Mode pelacakan adalah bagian dari konfigurasi khusus versi saat Anda menerbitkan versi fungsi Anda. Anda tidak dapat mengubah mode pelacakan pada versi yang telah diterbitkan.

Mengaktifkan pen elusuran aktif dengan CloudFormation

Untuk mengaktifkan pelacakan pada AWS::Lambda::Function sumber daya dalam CloudFormation template, gunakan TracingConfig properti.

Resources:
  function:
    Type: AWS::Lambda::Function
    Properties:
      TracingConfig:
        Mode: Active
      ...

Untuk AWS::Serverless::Function sumber daya AWS Serverless Application Model (AWS SAM), gunakan Tracing properti.

Resources:
  function:
    Type: AWS::Serverless::Function
    Properties:
      Tracing: Active
      ...