View a markdown version of this page

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

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

Penggunaan AWS X-Ray untuk melacak permintaan di AWS AppSync

Anda dapat menggunakan AWS X-Ray untuk melacak permintaan saat dieksekusi AWS AppSync. Anda dapat menggunakan X-Ray AWS AppSync di semua AWS Wilayah X-Ray yang tersedia. X-Ray memberi Anda ikhtisar terperinci dari seluruh permintaan GraphQL. Ini memungkinkan Anda menganalisis latensi di API Anda dan resolver dan sumber data yang mendasarinya. Anda dapat menggunakan peta X-Ray layanan untuk melihat latensi permintaan, termasuk AWS layanan apa pun yang terintegrasi dengannya X-Ray. Anda juga dapat mengonfigurasi aturan pengambilan sampel untuk mengetahui permintaan X-Ray mana yang akan direkam, dan pada tingkat pengambilan sampel apa, sesuai dengan kriteria yang Anda tentukan.

Untuk informasi selengkapnya tentang pengambilan sampel di X-Ray, lihat Meng onfigurasi Aturan Sampel di AWS X-Ray Konsol.

Pengaturan dan Konfigurasi

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

  1. Masuk ke AWS AppSync konsol.

  2. Pilih Pengaturan dari panel navigasi.

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

  4. Pilih Simpan. X-Ray pelacakan sekarang diaktifkan untuk API Anda.

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

Saat X-Ray pelacakan diaktifkan untuk AWS AppSync API, AWS Identity and Access Management peran terkait layanan secara otomatis dibuat di akun Anda dengan izin yang sesuai. Ini memungkinkan AWS AppSync untuk mengirim jejak 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 rekam AWS AppSync, dan dapat mengubah perilaku pengambilan sampel dengan cepat tanpa memodifikasi atau menyebarkan ulang kode Anda. Misalnya, aturan ini mengambil sampel permintaan ke GraphQL API dengan ID 3n572shhcpfokwhdnq1ogu59v6 API.

  • Nama aturan — test-sample

  • Prioritas - 10

  • Ukuran waduk - 10

  • Tarif tetap - 10

  • Nama layanan — *

  • Jenis layanan - AWS::AppSync::GraphQLAPI

  • Metode HTTP - *

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

  • Tuan rumah - *

Memahami Jejak

Saat mengaktifkan pel X-Ray acakan untuk GraphQL API, Anda dapat menggunakan halaman detail pel X-Ray acakan untuk memeriksa informasi latensi terperinci tentang permintaan yang dibuat ke API Anda. Contoh berikut menunjukkan tampilan jejak bersama dengan peta layanan untuk permintaan khusus ini. Permintaan dibuat ke API yang 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
    }
}

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

Peta jejak yang menunjukkan aliran permintaan PostAPI dari klien melalui DynamoDB dengan detail waktu.

  • Pada gambar sebelumnya, /getPost mewakili jalur lengkap ke elemen yang sedang diselesaikan. Dalam hal ini, karena getPost merupakan 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 X-Ray, Anda bisa mendapatkan informasi kontekstual dan metadata tambahan tentang subsegmen di segmen dengan memilih subsegmen dan menjelajahi tampilan terperinci. AWS AppSync

Untuk kueri bersarang dalam atau kompleks tertentu, perhatikan bahwa segmen yang dikirimkan ke X-Ray by 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.