View a markdown version of this page

Amazon SNS dan AWS X-Ray - AWS X-Ray

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

Amazon SNS dan AWS X-Ray

Anda dapat menggunakannya AWS X-Ray dengan Amazon Simple Notification Service (Amazon SNS) untuk melacak dan menganalisis permintaan saat mereka melakukan perjalanan melalui topik SNS Anda ke layanan SNS-supported berlangganan Anda. Gunakan X-Ray pelacakan dengan Amazon SNS untuk menganalisis latensi dalam pesan Anda dan layanan back-end mereka, seperti berapa lama permintaan dihabiskan dalam suatu topik, dan berapa lama waktu yang dibutuhkan untuk mengirimkan pesan ke setiap langganan topik. Amazon SNS mendukung pen X-Ray elusuran untuk topik standar dan FIFO.

Jika Anda mempublikasikan ke topik Amazon SNS dari layanan yang sudah diinstrumentasi X-Ray, Amazon SNS meneruskan konteks pelacakan dari penerbit ke pelanggan. Selain itu, Anda dapat mengaktifkan pelacakan aktif untuk mengirim data segmen tentang langganan Amazon SNS Anda ke X-Ray pesan yang diterbitkan dari klien SNS berinstrumen. Aktifkan pelac akan aktif untuk topik Amazon SNS menggunakan konsol Amazon SNS, atau dengan menggunakan Amazon SNS API atau CLI. Lihat Instrumentasi aplikasi Anda untuk informasi selengkapnya tentang instrumentasi klien SNS Anda.

Konfigurasikan pelacakan aktif Amazon SNS

Anda dapat menggunakan konsol Amazon SNS atau AWS CLI atau SDK untuk mengonfigurasi pelacakan aktif Amazon SNS.

Saat Anda menggunakan konsol Amazon SNS, Amazon SNS mencoba membuat izin yang diperlukan bagi SNS untuk menelepon. X-Ray Upaya dapat ditolak jika Anda tidak memiliki izin yang cukup untuk mengubah kebijakan X-Ray sumber daya. Untuk informasi selengkapnya tentang izin ini, lihat Identitas dan manajemen akses di Amazon SNS dan Contoh kasus untuk kontrol akses Amazon SNS di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon. Untuk informasi selengkapnya tentang mengaktifkan pelacakan aktif menggunakan konsol Amazon SNS, lihat Meng aktifkan pelacakan aktif pada topik Amazon SNS di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.

Saat menggunakan AWS CLI atau SDK untuk mengaktifkan pelacakan aktif, Anda harus mengonfigurasi izin secara manual menggunakan kebijakan berbasis sumber daya. Gunakan PutResourcePolicy untuk mengonfigurasi X-Ray dengan kebijakan berbasis sumber daya yang diperlukan agar Amazon SNS dapat mengirim jejak ke. X-Ray

contoh Contoh kebijakan X-Ray berbasis sumber daya untuk pelacakan aktif Amazon SNS

Contoh dokumen kebijakan ini menentukan izin yang dibutuhkan Amazon SNS untuk mengirim data pelacakan ke: X-Ray

{ Version: "2012-10-17", Statement: [ { Sid: "SNSAccess", Effect: Allow, Principal: { Service: "sns.amazonaws.com", }, Action: [ "xray:PutTraceSegments", "xray:GetSamplingRules", "xray:GetSamplingTargets" ], Resource: "*", Condition: { StringEquals: { "aws:SourceAccount": "account-id" }, StringLike: { "aws:SourceArn": "arn:partition:sns:region:account-id:topic-name" } } } ] }

Gunakan CLI untuk membuat kebijakan berbasis sumber daya yang memberikan izin Amazon SNS untuk mengirim data pelacakan ke: X-Ray

aws xray put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "SNSAccess", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": [ "xray:PutTraceSegments", "xray:GetSamplingRules", "xray:GetSamplingTargets" ], "Resource": "*", "Condition": { "StringEquals": { "aws:SourceAccount": "account-id" }, "StringLike": { "aws:SourceArn": "arn:partition:sns:region:account-id:topic-name" } } } ] }'

Untuk menggunakan contoh ini, gantipartition,, regionaccount-id, dan topic-name dengan AWS partisi, wilayah, ID akun, dan nama topik Amazon SNS spesifik Anda. Untuk memberikan izin kepada semua topik Amazon SNS untuk mengirim data pelac X-Ray akan, ganti nama topik dengan*.

Lihat jejak penerbit dan pelanggan Amazon SNS di konsol X-Ray

Gunakan X-Ray konsol untuk melihat peta jejak dan detail pelacakan yang menampilkan tampilan terhubung dari penerbit dan pelanggan Amazon SNS. Saat pelacakan aktif Amazon SNS diaktifkan untuk suatu topik, peta X-Ray jejak dan peta detail pelacakan menampilkan node yang terhubung untuk penerbit Amazon SNS, topik Amazon SNS, dan pelanggan hilir:

Peta jejak dengan penerbit dan pelanggan Amazon SNS

Setelah memilih jejak yang mencakup penerbit dan pelanggan Amazon SNS, halaman detail pelacakan menampilkan peta detail X-Ray jejak dan garis waktu segmen.

contoh Contoh timeline dengan penerbit dan pelanggan Amazon SNS

Contoh ini menunjukkan garis waktu yang menyertakan penerbit Amazon SNS yang mengirim pesan ke topik Amazon SNS, yang diproses oleh pelanggan Amazon SQS.

Garis waktu segmen untuk penerbit dan pelanggan Amazon SNS

Contoh garis waktu di atas memberikan detail tentang alur pesan Amazon SNS:

  • Segmen SNS mewakili durasi pulang-pergi panggilan Publish API dari klien.

  • Segmen MyTopic mewakili latensi respons Amazon SNS terhadap permintaan publikasi.

  • Subsegmen SQS mewakili waktu pulang-pergi yang dibutuhkan Amazon SNS untuk mempublikasikan pesan ke antrian Amazon SQS.

  • Waktu antara segmen MyTopic dan sub segmen SQS mewakili waktu yang dihabiskan pesan dalam sistem Amazon SNS.

contoh Contoh garis waktu dengan pesan Amazon SNS berkelompok

Jika beberapa pesan Amazon SNS dikelompokkan dalam satu jejak, garis waktu segmen menampilkan segmen yang mewakili setiap pesan yang diproses.

Garis waktu segmen untuk pesan batch Amazon SNS