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

Menggunakan CloudWatch untuk memantau dan mencatat data GraphQL API

Anda dapat mencatat dan men-debug API GraphQL CloudWatch Anda menggunakan metrik dan log. CloudWatch Alat-alat ini memungkinkan pengembang untuk memantau kinerja, memecahkan masalah, dan mengoptimalkan operasi GraphQL mereka secara efektif.

CloudWatch metrik adalah alat yang menyediakan berbagai metrik untuk memantau API kinerja dan penggunaan. Metrik ini terbagi dalam dua kategori utama:

Panduan ini juga memperkenalkan Enhanced Metrics, yang menawarkan lebih banyak data terperinci tentang kinerja resolver, interaksi sumber data, dan operasi GraphQL individual. Metrik ini memberikan wawasan yang lebih dalam tetapi datang dengan biaya tambahan.

CloudWatch Log adalah alat yang memungkinkan kemampuan logging untuk GraphQL APIs Anda. Log dapat diatur pada dua tingkatAPI:

Anda dapat mengonfigurasi logging, menafsirkan entri log, dan menggunakan data log untuk pemecahan masalah dan pengoptimalan. AWS AppSync menyediakan berbagai jenis log yang mengungkapkan eksekusi, parsing, validasi, dan data resolusi bidang kueri Anda.

Penyiapan dan konfigurasi

Untuk mengaktifkan logging otomatis pada API GraphQL, gunakan konsol. AWS AppSync

Konfigurasi IAM peran manual

Jika Anda memilih untuk menggunakan IAM peran yang ada, peran tersebut harus memberikan AWS AppSync izin yang diperlukan untuk menulis log. CloudWatch Untuk mengonfigurasi ini secara manual, Anda harus menyediakan peran layanan ARN sehingga AWS AppSync dapat mengambil peran saat menulis log.

Di IAMkonsol, buat kebijakan baru dengan nama AWSAppSyncPushToCloudWatchLogsPolicy yang memiliki definisi berikut:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogGroup",
                "logs:CreateLogStream",
                "logs:PutLogEvents"
            ],
            "Resource": "*"
        }
    ]
}

Selanjutnya, buat peran baru dengan nama AWSAppSyncPushToCloudWatchLogsRole, dan lampirkan kebijakan yang baru dibuat ke peran tersebut. Edit hubungan kepercayaan untuk peran ini menjadi berikut:

{
    "Version": "2012-10-17",
    "Statement": [
        {
        "Effect": "Allow",
        "Principal": {
            "Service": "appsync.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
        }
    ]
}

Salin peran ARN dan gunakan saat menyiapkan logging untuk AWS AppSync GraphQLAPI.

CloudWatch metrik

Anda dapat menggunakan CloudWatch metrik untuk memantau dan memberikan peringatan tentang peristiwa tertentu yang dapat menghasilkan kode HTTP status atau dari latensi. Metrik berikut dipancarkan:

Langganan waktu nyata

Semua metrik dipancarkan dalam satu dimensi: G. raphQLAPIId Ini berarti bahwa semua metrik digabungkan dengan GraphQL. API IDs Metrik berikut terkait dengan langganan GraphQL di atas murni: WebSockets

Membandingkan pesan masuk dan keluar

Saat mutasi dijalankan, bidang langganan dengan direktif @aws_subscribe untuk mutasi tersebut dipanggil. Setiap pemanggilan langganan menghasilkan satu pesan masuk. Misalnya, jika dua bidang langganan menentukan mutasi yang sama di @aws_subscribe, maka dua pesan masuk dihasilkan saat mutasi itu dipanggil.

Satu pesan keluar sama dengan 5 kB data yang dikirimkan ke WebSocket klien. Misalnya, mengirim 15 kB data ke 10 klien menghasilkan 30 pesan keluar (15 kB* 10 klien/ 5 kB per pesan = 30 pesan).

Anda dapat meminta peningkatan kuota untuk pesan masuk atau keluar. Untuk informasi selengkapnya, lihat AWS AppSync titik akhir dan kuota dalam panduan Referensi AWS Umum dan petunjuk untuk Meminta peningkatan kuota dalam Panduan Pengguna Service Quotas.

Metrik yang disempurnakan

Metrik yang disempurnakan memancarkan data terperinci tentang API penggunaan dan kinerja seperti jumlah AWS AppSync permintaan dan kesalahan, latensi, dan hits/misses cache. Semua data metrik yang disempurnakan dikirim ke CloudWatch akun Anda, dan Anda dapat mengonfigurasi jenis data yang akan dikirim.

Metrik ini dapat ditemukan di berbagai halaman pengaturan di AWS AppSync konsol. Pada halaman API pengaturan, bagian Metrik yang Ditingkatkan memungkinkan Anda untuk mengaktifkan atau menonaktifkan item berikut:

Perilaku metrik penyelesai: Opsi ini mengontrol cara metrik tambahan untuk resolver dikumpulkan. Anda dapat memilih untuk mengaktifkan metrik resolver permintaan lengkap (metrik diaktifkan untuk semua resolver dalam permintaan) atau metrik per-resolver (metrik hanya diaktifkan untuk resolver yang konfigurasi disetel ke diaktifkan). Pilihan berikut tersedia:

Perilaku metrik sumber data: Opsi ini mengontrol cara metrik tambahan untuk sumber data dikumpulkan. Anda dapat memilih untuk mengaktifkan metrik sumber data permintaan lengkap (metrik diaktifkan untuk semua sumber data dalam permintaan) atau metrik sumber per data (metrik hanya diaktifkan untuk sumber data yang konfigurasi disetel ke diaktifkan). Pilihan berikut tersedia:

Metrik operasi: Mengaktifkan metrik tingkat operasi GraphQL.

CloudWatch log

Anda dapat mengonfigurasi dua jenis logging pada API GraphQL baru atau yang sudah ada: tingkat permintaan dan tingkat bidang.

Log tingkat permintaan

Ketika pencatatan tingkat permintaan (Sertakan konten verbose) dikonfigurasi, informasi berikut dicatat:

Log tingkat lapangan

Ketika logging tingkat lapangan dikonfigurasi, informasi berikut dicatat:

Jika Anda mengaktifkan logging, AWS AppSync mengelola CloudWatch Log. Prosesnya termasuk membuat grup log dan aliran log, dan melaporkan ke aliran log dengan log ini.

Saat Anda mengaktifkan logging pada API GraphQL dan membuat permintaan AWS AppSync , buat grup log dan aliran log di bawah grup log. Grup log diberi nama mengikuti /aws/appsync/apis/{graphql_api_id} format. Dalam setiap grup log, log dibagi lagi menjadi aliran log. Ini diurutkan berdasarkan Waktu Acara Terakhir karena data yang dicatat dilaporkan.

Setiap peristiwa log ditandai dengan x-amzn- RequestId dari permintaan itu. Ini membantu Anda memfilter peristiwa log CloudWatch untuk mendapatkan semua informasi yang dicatat tentang permintaan itu. Anda bisa mendapatkan dari header respons RequestId dari setiap permintaan GraphQL AWS AppSync .

Pencatatan tingkat bidang dikonfigurasi dengan level log berikut:

Manfaat pemantauan

Anda dapat menggunakan logging dan metrik untuk mengidentifikasi, memecahkan masalah, dan mengoptimalkan kueri GraphQL Anda. Misalnya, ini akan membantu Anda men-debug masalah latensi menggunakan informasi penelusuran yang dicatat untuk setiap bidang dalam kueri. Untuk mendemonstrasikan ini, misalkan Anda menggunakan satu atau lebih resolver yang bersarang dalam kueri GraphQL. Operasi bidang sampel di CloudWatch Log mungkin terlihat mirip dengan yang berikut ini:

{
    "path": [
        "singlePost",
        "authors",
        0,
        "name"
    ],
    "parentType": "Post",
    "returnType": "String!",
    "fieldName": "name",
    "startOffset": 416563350,
    "duration": 11247
}

Ini mungkin sesuai dengan skema GraphQL, mirip dengan yang berikut ini:

type Post {
  id: ID!
  name: String!
  authors: [Author]
}

type Author {
  id: ID!
  name: String!
}

type Query {
  singlePost(id:ID!): Post
}

Dalam hasil log sebelumnya, path menampilkan satu item dalam data Anda yang dikembalikan dari menjalankan kueri bernama. singlePost() Dalam contoh ini, ini mewakili bidang nama pada indeks pertama (0). startOffsetMemberikan offset dari awal operasi query GraphQL. Durasi adalah total waktu untuk menyelesaikan bidang. Nilai-nilai ini dapat berguna untuk memecahkan masalah mengapa data dari sumber data tertentu mungkin berjalan lebih lambat dari yang diharapkan, atau jika bidang tertentu memperlambat seluruh kueri. Misalnya, Anda dapat memilih untuk meningkatkan throughput yang disediakan untuk tabel Amazon DynamoDB, atau menghapus bidang tertentu dari kueri yang menyebabkan keseluruhan operasi berkinerja buruk.

Per 8 Mei 2019, AWS AppSync menghasilkan peristiwa log sebagai terstruktur sepenuhnyaJSON. Ini dapat membantu Anda menggunakan layanan analisis CloudWatch log seperti Wawasan Log dan OpenSearch Layanan Amazon untuk memahami kinerja permintaan GraphQL dan karakteristik penggunaan bidang skema Anda. Misalnya, Anda dapat dengan mudah mengidentifikasi resolver dengan latensi besar yang mungkin menjadi akar penyebab masalah kinerja. Anda juga dapat mengidentifikasi bidang yang paling sering dan paling jarang digunakan dalam skema Anda dan menilai dampak dari menghentikan bidang GraphQL.

Deteksi konflik dan pencatatan sinkronisasi

Jika CloudWatch log ke Log AWS AppSync API telah dikonfigurasi dengan tingkat log penyelesai bidang yang disetel ke Semua, maka akan AWS AppSync memancarkan deteksi konflik dan informasi resolusi ke grup log. Ini memberikan wawasan terperinci tentang bagaimana AWS AppSync API menanggapi konflik. Untuk membantu Anda menafsirkan respons, informasi berikut disediakan di log:

Menggunakan jumlah token untuk mengoptimalkan permintaan Anda

Permintaan yang mengkonsumsi kurang dari atau sama dengan 1.500 Kb-detik memori dan CPU waktu v dialokasikan satu token. Permintaan dengan konsumsi sumber daya lebih dari 1.500 Kb-detik menerima token tambahan. Misalnya, jika permintaan menghabiskan 3.350 KB-detik, AWS AppSync mengalokasikan tiga token (dibulatkan ke nilai integer berikutnya) ke permintaan. Secara default, AWS AppSync mengalokasikan maksimum 5.000 atau 10.000 token permintaan per detik ke akun Anda, tergantung pada AWS Wilayah di mana token tersebut digunakan. APIs Jika APIs masing-masing menggunakan rata-rata dua token per detik, Anda akan dibatasi hingga 2.500 atau 5.000 permintaan per detik, masing-masing. Jika Anda membutuhkan lebih banyak token per detik dari jumlah yang dialokasikan, Anda dapat mengajukan permintaan untuk meningkatkan kuota default untuk tarif token permintaan. Untuk informasi selengkapnya, lihat AWS AppSync titik akhir dan kuota dalam Referensi Umum AWS panduan dan Meminta peningkatan kuota dalam Panduan Pengguna Service Quotas.

Jumlah token per permintaan yang tinggi dapat menunjukkan bahwa ada peluang untuk mengoptimalkan permintaan Anda dan meningkatkan kinerja Anda. API Faktor-faktor yang dapat meningkatkan jumlah token per permintaan Anda meliputi:

Batas ukuran log

Secara default, jika logging telah diaktifkan, AWS AppSync akan mengirimkan hingga 1 MB log per permintaan. Log yang melebihi ukuran ini akan terpotong. Untuk mengurangi ukuran log, pilih tingkat ERROR logging untuk log tingkat bidang dan nonaktifkan VERBOSE logging, atau nonaktifkan log tingkat bidang sepenuhnya jika tidak diperlukan. Sebagai alternatif untuk tingkat ALL log, Anda dapat menggunakan Metrik yang Ditingkatkan untuk mendapatkan metrik pada resolver tertentu, sumber data, atau operasi GraphQL, atau memanfaatkan utilitas pencatatan yang disediakan oleh untuk mencatat hanya informasi yang diperlukan. AppSync

Referensi tipe log

RequestSummary

{
     "logType": "RequestSummary",
     "requestId": "dbe87af3-c114-4b32-ae79-8af11f3f96f1",
     "graphQLAPIId": "pmo28inf75eepg63qxq4ekoeg4",
     "statusCode": 200,
     "latency": 242000000
}

ExecutionSummary

{
    "duration": 217406145,
    "logType": "ExecutionSummary",
    "requestId": "dbe87af3-c114-4b32-ae79-8af11f3f96f1",
    "startTime": "2019-01-01T06:06:18.956Z",
    "endTime": "2019-01-01T06:06:19.174Z",
    "parsing": {
        "startOffset": 49033,
        "duration": 34784
    },
    "version": 1,
    "validation": {
        "startOffset": 129048,
        "duration": 69126
    },
    "graphQLAPIId": "pmo28inf75eepg63qxq4ekoeg4"
}

Pelacakan

{
    "duration": 216820346,
    "logType": "Tracing",
    "path": [
        "putItem"
    ],
    "fieldName": "putItem",
    "startOffset": 178156,
    "resolverArn": "arn:aws:appsync:us-east-1:111111111111:apis/pmo28inf75eepg63qxq4ekoeg4/types/Mutation/fields/putItem",
    "requestId": "dbe87af3-c114-4b32-ae79-8af11f3f96f1",
    "parentType": "Mutation",
    "returnType": "Item",
    "graphQLAPIId": "pmo28inf75eepg63qxq4ekoeg4"
}

Menganalisis log Anda dengan Wawasan CloudWatch Log

Berikut ini adalah contoh kueri yang dapat Anda jalankan untuk mendapatkan wawasan yang dapat ditindaklanjuti tentang kinerja dan kesehatan operasi GraphQL Anda. Contoh ini tersedia sebagai contoh kueri di konsol Wawasan CloudWatch Log. Di CloudWatchkonsol, pilih Wawasan Log, pilih grup AWS AppSync log untuk API GraphQL Anda, lalu AWS AppSync pilih kueri di bawah Kueri sampel.

Kueri berikut mengembalikan 10 permintaan GraphQL teratas dengan token maksimum yang dikonsumsi:

filter @message like "Tokens Consumed"
| parse @message "* Tokens Consumed: *" as requestId, tokens
| sort tokens desc
| display requestId, tokens
| limit 10

Kueri berikut mengembalikan 10 resolver teratas dengan latensi maksimum:

  fields resolverArn, duration
| filter logType = "Tracing"
| limit 10
| sort duration desc

Kueri berikut mengembalikan resolver yang paling sering dipanggil:

  fields ispresent(resolverArn) as isRes
| stats count() as invocationCount by resolverArn
| filter isRes and logType = "Tracing"
| limit 10
| sort invocationCount desc

Kueri berikut mengembalikan resolver dengan kesalahan terbanyak dalam template pemetaan:

  fields ispresent(resolverArn) as isRes
| stats count() as errorCount by resolverArn, logType
| filter isRes and (logType = "RequestMapping" or logType = "ResponseMapping") and fieldInError
| limit 10
| sort errorCount desc

Kueri berikut mengembalikan statistik latensi resolver:

  fields ispresent(resolverArn) as isRes
| stats min(duration), max(duration), avg(duration) as avg_dur by resolverArn
| filter isRes and logType = "Tracing"
| limit 10
| sort avg_dur desc

Kueri berikut mengembalikan statistik latensi bidang:

  stats min(duration), max(duration), avg(duration) as avg_dur
  by concat(parentType, '/', fieldName) as fieldKey
| filter logType = "Tracing"
| limit 10
| sort avg_dur desc

Hasil kueri Wawasan CloudWatch Log dapat diekspor ke dasbor. CloudWatch

Analisis log Anda dengan OpenSearch Layanan

Anda dapat mencari, menganalisis, dan memvisualisasikan AWS AppSync log Anda dengan Amazon OpenSearch Service untuk mengidentifikasi kemacetan kinerja dan akar penyebab masalah operasional. Anda dapat mengidentifikasi resolver dengan latensi dan kesalahan maksimum. Selain itu, Anda dapat menggunakan OpenSearch Dasbor untuk membuat dasbor dengan visualisasi yang kuat. OpenSearch Dasbor adalah alat visualisasi dan eksplorasi data sumber terbuka yang tersedia di Layanan. OpenSearch Menggunakan OpenSearch Dasbor, Anda dapat terus memantau kinerja dan kesehatan operasi GraphQL Anda. Misalnya, Anda dapat membuat dasbor untuk memvisualisasikan latensi P90 dari permintaan GraphQL Anda dan menelusuri latensi P90 dari setiap resolver.

Saat menggunakan OpenSearch Layanan, gunakan “cwl*” sebagai pola filter untuk mencari indeks. OpenSearch OpenSearch Layanan mengindeks log yang dialirkan dari CloudWatch Log dengan awalan “cwl -”. Untuk membedakan AWS AppSync API log dari CloudWatch log lain yang dikirim ke OpenSearch Layanan, sebaiknya tambahkan ekspresi filter tambahan graphQLAPIID.keyword=YourGraphQLAPIID ke penelusuran Anda.

Migrasi format log

Peristiwa log yang AWS AppSync dihasilkan pada atau setelah 8 Mei 2019 diformat sebagai terstruktur JSON sepenuhnya. Untuk menganalisis permintaan GraphQL sebelum 8 Mei 2019, Anda dapat memigrasikan log lama ke JSON terstruktur sepenuhnya menggunakan skrip yang tersedia di Sampel. GitHub Jika Anda perlu menggunakan format log sebelum 8 Mei 2019, buat tiket dukungan dengan pengaturan berikut: setel Jenis ke Manajemen Akun, lalu setel Kategori ke Pertanyaan Akun Umum.

Anda juga dapat menggunakan filter metrik CloudWatch untuk mengubah data log menjadi CloudWatch metrik numerik, sehingga Anda dapat membuat grafik atau mengatur alarm pada mereka.