Menelusuri denganAWS X-Ray

Anda dapat menggunakanAWS X-Rayuntuk melacak permintaan karena mereka dieksekusi diAWSAppSync. Anda dapat menggunakan X-Ray denganAWSAppSync di semuaAWSDaerah di mana X-Ray tersedia. X-Ray memberi Anda gambaran rinci tentang seluruh permintaan GraphQL. Hal ini memungkinkan Anda menganalisis latensi di API Anda dan resolver dan sumber data yang mendasarinya. Anda dapat menggunakan peta layanan X-Ray untuk melihat latensi permintaan, termasuk layanan AWS yang terintegrasi dengan X-Ray. Anda juga dapat mengonfigurasi aturan pengambilan sampel untuk memberi tahu X-Ray mengenai permintaan yang dicatat, tingkat pengambilan sampel, sesuai kriteria yang Anda tentukan.

Untuk informasi selengkapnya tentang pengambilan sampel di X-Ray, lihatMengkonfigurasi Aturan Sampling diAWS X-RayKonsol.

Penyiapan dan Konfigurasi

Anda dapat mengaktifkan penelusuran X-Ray untuk API GraphQL melaluiAWSKonsol AppSync.

1. Masuk keAWSKonsol AppSync.

2. PilihPengaturandari panel navigasi.

3. Di bawahX-Ray, nyalakanAktifkan X-Ray.

4. Pilih Save (Simpan). Pelacakan X-Ray sekarang diaktifkan untuk API Anda.

Jika Anda menggunakanAWS CLIatauAWS CloudFormation, Anda juga dapat mengaktifkan pelacakan X-Ray saat Anda membuat yang baruAWSAppSync API, atau memperbarui yang sudah adaAWSAppSync API, dengan menetapkanxrayEnabledproperti untuktrue.

Saat pelacakan X-Ray diaktifkan untukAWSAppSync API, sebuahAWS Identity and Access Management peran yang terhubung dengan layanandibuat secara otomatis di akun Anda dengan izin yang sesuai. Hal ini mengizinkan AppSync AWS untuk mengirim penelusuran ke X-Ray dengan cara yang aman.

Menelusuri API Anda dengan X-Ray

Pengambilan sampel

Dengan menggunakan aturan pengambilan sampel, Anda dapat mengontrol jumlah data yang Anda catatAWSAppSync, dan dapat mengubah perilaku pengambilan sampel dengan cepat tanpa mengubah atau men-deploy ulang kode Anda. Misalnya, contoh aturan ini meminta ke API GraphQL dengan ID API3n572shhcpfokwhdnq1ogu59v6.

• Nama aturan—test-sample

• Prioritas—10

• Ukuran reservoir—10

• Tingkat tetap—10

• Nama layanan—*

• Jenis layanan—AWS::AppSync::GraphQLAPI

• Metode HTTP—*

• Sumber daya ARN—arn:aws:appsync:us-west-2:123456789012:apis/3n572shhcpfokwhdnq1ogu59v6

• Host—*

Memahami Jejak

Bila Anda mengaktifkan pelacakan X-Ray untuk API GraphQL, Anda dapat menggunakan halaman detail pelacakan X-Ray untuk memeriksa informasi latensi terperinci tentang permintaan yang dibuat ke API Anda. Contoh berikut menunjukkan tampilan jejak bersama dengan peta layanan untuk permintaan spesifik ini. Permintaan dibuat ke API yang disebutpostAPIdengan tipe Post, yang datanya terkandung dalam tabel Amazon DynamoDB yang disebutPostTable-Example.

Gambar jejak berikut sesuai dengan query GraphQL berikut:

query getPost {
    getPost(id: "1") {
      id
      title
    }
}

Resolver untukgetPostquery menggunakan sumber data DynamoDB yang mendasari. Tampilan jejak berikut menunjukkan panggilan ke DynamoDB, serta latensi berbagai bagian eksekusi query:

• Pada gambar sebelumnya,/getPostmewakili path lengkap untuk elemen yang sedang diselesaikan. Dalam kasus ini, karenagetPostadalah bidang pada akarQueryketik, itu muncul langsung setelah akar jalan.

• requestMappingTemplateEvaluationmewakili waktu yang dihabiskan olehAWSAppSync mengevaluasi template pemetaan permintaan untuk elemen ini dalam kueri.

• Query.getPostmewakili jenis dan bidang (diType.fieldformat). Hal ini dapat berisi beberapa subsegment, tergantung pada struktur API dan permintaan yang ditelusuri.

  • DynamoDBmewakili sumber data yang melekat pada resolver ini. Ini berisi latensi untuk panggilan jaringan ke DynamoDB untuk menyelesaikan bidang.

  • responseMappingTemplateEvaluationmewakili waktu yang dihabiskan olehAWSAppSync mengevaluasi template pemetaan respon untuk elemen ini dalam kueri.

Bila Anda melihat jejak di X-Ray, Anda bisa mendapatkan informasi kontekstual dan metadata tambahan tentang subsegmen diAWSSegmen AppSync dengan memilih subsegment dan menjelajahi tampilan rinci.

Untuk kueri tertentu yang sangat bersarang atau kompleks, perhatikan bahwa segmen dikirim ke X-Ray olehAWSAppSync bisa lebih besar dari ukuran maksimum yang diizinkan untuk dokumen segmen, seperti yang didefinisikan dalamAWS X-RayDokumen segmen. X-Ray tidak menampilkan segmen yang melebihi batas.