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 menggunakan AWS X-Ray Amazon Simple Notification Service (Amazon SNS) untuk melacak dan menganalisis permintaan saat mereka melakukan perjalanan melalui topik SNS Anda ke layanan berlangganan yang didukung SNS Anda.](https://docs.aws.amazon.com/sns/latest/dg/sns-active-tracing.html) Gunakan penelusuran X-Ray 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 menyampaikan pesan ke setiap langganan topik. Amazon SNS mendukung penelusuran X-Ray untuk topik standar dan FIFO.
Jika Anda mempublikasikan ke topik Amazon SNS dari layanan yang sudah diinstrumentasi dengan X-Ray, Amazon SNS meneruskan konteks jejak dari penerbit ke pelanggan. Selain itu, Anda dapat mengaktifkan penelusuran aktif untuk mengirim data segmen tentang langganan Amazon SNS Anda ke X-Ray untuk pesan yang diterbitkan dari klien SNS yang diinstrumentasi. [Aktifkan penelusuran aktif](https://docs.aws.amazon.com/sns/latest/dg/sns-active-tracing.html) untuk topik Amazon SNS dengan menggunakan konsol Amazon SNS, atau dengan menggunakan Amazon SNS API atau CLI. Lihat [Instrumentasi aplikasi Anda](xray-instrumenting-your-app.md) untuk informasi selengkapnya tentang instrumentasi klien SNS Anda.
## Konfigurasikan penelusuran aktif Amazon SNS
Anda dapat menggunakan konsol Amazon SNS atau AWS CLI atau SDK untuk mengonfigurasi penelusuran aktif Amazon SNS.
Saat Anda menggunakan konsol Amazon SNS, Amazon SNS mencoba membuat izin yang diperlukan agar SNS memanggil X-Ray. Upaya dapat ditolak jika Anda tidak memiliki izin yang cukup untuk mengubah kebijakan sumber daya X-Ray. Untuk informasi selengkapnya tentang izin ini, lihat [Identitas dan manajemen akses di Amazon](https://docs.aws.amazon.com/sns/latest/dg/sns-authentication-and-access-control.html) SNS [dan Contoh kasus untuk kontrol akses Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html) di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon. Untuk informasi selengkapnya tentang mengaktifkan penelusuran aktif menggunakan konsol Amazon SNS, [lihat Mengaktifkan penelusuran aktif pada topik Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-active-tracing.html) di Panduan Pengembang Layanan Pemberitahuan Sederhana Amazon.
Saat menggunakan AWS CLI atau SDK untuk mengaktifkan penelusuran aktif, Anda harus mengonfigurasi izin secara manual menggunakan kebijakan berbasis sumber daya. Gunakan [https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html](https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html)untuk mengonfigurasi X-Ray dengan kebijakan berbasis sumber daya yang diperlukan untuk memungkinkan Amazon SNS mengirim jejak ke X-Ray.
**Example Contoh kebijakan berbasis sumber daya X-Ray untuk penelusuran aktif Amazon SNS**
Contoh dokumen kebijakan ini menentukan izin yang diperlukan Amazon SNS untuk mengirim data jejak 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 jejak 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, ganti{{`partition`}},{{`region`}},{{`account-id`}}, dan {{`topic-name`}} dengan AWS partisi tertentu, wilayah, ID akun, dan nama topik Amazon SNS. Untuk memberikan izin kepada semua topik Amazon SNS untuk mengirim data jejak ke X-Ray, ganti nama topik dengan. `*`
## Lihat jejak penerbit dan pelanggan Amazon SNS di konsol X-Ray
Gunakan konsol X-Ray untuk melihat peta jejak dan melacak detail yang menampilkan tampilan penayang dan pelanggan Amazon SNS yang terhubung. Saat penelusuran aktif Amazon SNS diaktifkan untuk suatu topik, peta jejak X-Ray dan peta detail jejak menampilkan node yang terhubung untuk penerbit Amazon SNS, topik Amazon SNS, dan pelanggan hilir:
Setelah memilih jejak yang mencakup penerbit dan pelanggan Amazon SNS, halaman detail jejak X-Ray menampilkan peta detail jejak dan garis waktu segmen.
**Example 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.
Contoh timeline 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 subsegmen **SQS** mewakili waktu yang dihabiskan pesan dalam sistem Amazon SNS.
**Example Contoh timeline dengan pesan Amazon SNS batch**
Jika beberapa pesan Amazon SNS dikumpulkan dalam satu jejak, timeline segmen akan menampilkan segmen yang mewakili setiap pesan yang diproses.
