Menggunakan AWS X-Ray untuk melacak permintaan di AWS AppSync - AWS AppSync
Pengaturan dan KonfigurasiMenelusuri Anda API dengan X-Ray

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

Menggunakan AWS X-Ray untuk melacak permintaan di AWS AppSync

Anda dapat menggunakan AWS X-Rayuntuk melacak permintaan saat dieksekusi AWS AppSync. Anda dapat menggunakan X-Ray dengan AWS AppSync di semua AWS Wilayah di mana X-Ray tersedia. X-Ray memberi Anda gambaran rinci dari seluruh permintaan GraphQL. Ini memungkinkan Anda untuk menganalisis latensi dalam resolver APIs dan sumber data Anda dan mereka yang mendasarinya. Anda dapat menggunakan peta layanan X-Ray untuk melihat latensi permintaan, termasuk AWS layanan apa pun 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, lihat Mengonfigurasi Aturan Pengambilan Sampel di Konsol. AWS X-Ray

Pengaturan dan Konfigurasi

Anda dapat mengaktifkan penelusuran X-Ray untuk API GraphQL melalui konsol. AWS AppSync

  1. Masuk ke AWS AppSync konsol.

  2. Pilih Pengaturan dari panel navigasi.

  3. Di bawah X-Ray, nyalakan Aktifkan X-Ray.

  4. Pilih Simpan. Penelusuran X-Ray sekarang diaktifkan untuk AndaAPI.

Jika Anda menggunakan AWS CLI atau AWS CloudFormation, Anda juga dapat mengaktifkan penelusuran X-Ray saat membuat yang baru AWS AppSync API, atau memperbarui yang sudah ada AWS AppSync API, dengan menyetel xrayEnabled properti ketrue.

Saat penelusuran X-Ray diaktifkan AWS AppSync API, peran AWS Identity and Access Management terkait layanan akan dibuat secara otomatis di akun Anda dengan izin yang sesuai. Ini memungkinkan AWS AppSync untuk mengirim jejak ke X-Ray dengan cara yang aman.

Menelusuri Anda API dengan X-Ray

Pengambilan sampel

Dengan menggunakan aturan sampling, Anda dapat mengontrol jumlah data yang Anda rekam AWS AppSync, dan dapat mengubah perilaku pengambilan sampel dengan cepat tanpa memodifikasi atau menerapkan ulang kode Anda. Misalnya, aturan ini mengambil sampel permintaan ke API GraphQL dengan ID. API 3n572shhcpfokwhdnq1ogu59v6

  • Nama aturan - test-sample

  • Prioritas - 10

  • Ukuran reservoir — 10

  • Tarif tetap - 10

  • Nama layanan - *

  • Jenis layanan - AWS::AppSync::GraphQLAPI

  • HTTPmetode — *

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

  • Tuan rumah — *

Memahami Jejak

Saat Anda mengaktifkan penelusuran X-Ray untuk API GraphQL Anda, Anda dapat menggunakan halaman detail jejak X-Ray untuk memeriksa informasi latensi terperinci tentang permintaan yang dibuat untuk Anda. API Contoh berikut menunjukkan tampilan jejak bersama dengan peta layanan untuk permintaan khusus ini. Permintaan dibuat untuk API dipanggil postAPI dengan tipe Post, yang datanya terkandung dalam tabel Amazon DynamoDB yang disebut. PostTable-Example

Gambar jejak berikut sesuai dengan kueri GraphQL berikut:

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

Penyelesai untuk getPost kueri menggunakan sumber data DynamoDB yang mendasarinya. Tampilan jejak berikut menunjukkan panggilan ke DynamoDB, serta latensi berbagai bagian eksekusi kueri:

Trace view showing client request, postAPI, and DynamoDB with durations and request details.

  • Pada gambar sebelumnya, /getPost mewakili jalur lengkap ke elemen yang sedang diselesaikan. Dalam hal ini, karena getPost adalah bidang pada Query tipe root, itu muncul langsung setelah root jalur.

  • requestMappingTemplateEvaluationmewakili waktu yang dihabiskan dengan AWS AppSync mengevaluasi template pemetaan permintaan untuk elemen ini dalam kueri.

  • Query.getPostmewakili jenis dan bidang (dalam Type.field format). Ini dapat berisi beberapa subsegmen, tergantung pada struktur API dan permintaan yang dilacak.

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

    • responseMappingTemplateEvaluationmewakili waktu yang dihabiskan dengan AWS AppSync mengevaluasi template pemetaan respons untuk elemen ini dalam kueri.

Saat Anda melihat jejak di X-Ray, Anda bisa mendapatkan informasi kontekstual dan metadata tambahan tentang subsegmen di segmen dengan memilih AWS AppSync subsegmen dan menjelajahi tampilan detail.

Untuk kueri tertentu yang sangat bersarang atau kompleks, perhatikan bahwa segmen yang dikirim ke X-Ray oleh AWS AppSync dapat lebih besar dari ukuran maksimum yang diizinkan untuk dokumen segmen, seperti yang didefinisikan dalam Dokumen AWS X-Ray Segmen. X-Ray tidak menampilkan segmen yang melebihi batas.