Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Penelusuran aktif di Amazon SNS
Gunakan AWS X-Ray untuk melacak dan menganalisis permintaan pengguna saat mereka melewati topik Amazon SNS Anda ke Amazon Data [Firehose, Amazon [AWS Lambda](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-lambda.html)](sns-firehose-as-subscriber.md)SQS, dan langganan titik [akhir](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sqs.html). HTTP/S
Dengan X-Ray, Anda mendapatkan end-to-end tampilan dari setiap permintaan, memungkinkan Anda untuk:
+ Identifikasi apa yang memanggil topik Amazon SNS Anda dan layanan apa yang merupakan hilir langganannya.
+ Analisis latensi, seperti:
+ Waktu yang dihabiskan dalam topik Amazon SNS sebelum diproses.
+ Waktu pengiriman untuk setiap titik akhir berlangganan.
**penting**
Topik Amazon SNS dengan banyak langganan dapat mencapai batas ukuran dan tidak sepenuhnya dilacak. Untuk informasi tentang batas ukuran dokumen jejak, lihat [kuota layanan sinar-X](https://docs.aws.amazon.com/general/latest/gr/xray.html#limits_xray) di Referensi AWS Umum.
Jika Anda memanggil Amazon SNS API dari layanan yang sudah dilacak, Amazon SNS meneruskan jejak, bahkan jika penelusuran X-Ray tidak diaktifkan pada API.
Amazon SNS mendukung penelusuran X-Ray untuk topik standar dan FIFO. Anda dapat mengaktifkan X-Ray untuk topik Amazon SNS dengan menggunakan konsol Amazon SNS, [Amazon SNS `SetTopicAttributes`](https://console.aws.amazon.com/sns/v3/home) [API](https://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html), Referensi CLI [Layanan Pemberitahuan Sederhana Amazon](https://docs.aws.amazon.com/cli/latest/reference/sns/), atau. [CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html)
Untuk mempelajari selengkapnya tentang menggunakan Amazon SNS dengan X-Ray, lihat [Amazon SNS AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) dan di AWS X-Ray Panduan Pengembang.
## Izin penelusuran aktif
Saat menggunakan konsol Amazon SNS, Amazon SNS mencoba membuat izin yang diperlukan untuk topik Amazon SNS untuk memanggil X-Ray. Upaya dapat ditolak jika Anda tidak memiliki izin yang cukup untuk menggunakan konsol Amazon SNS. Untuk informasi selengkapnya, lihat [Identity and access management di Amazon SNS](security-iam.md) dan [Contoh kasus untuk pengendalian akses Amazon SNS](sns-access-policy-use-cases.md).
Saat menggunakan CLI, Anda harus mengonfigurasi izin secara manual. Izin tersebut dikonfigurasi menggunakan kebijakan sumber daya. Untuk informasi lebih lanjut tentang penggunaan izin yang diperlukan dalam X-Ray, lihat [Amazon SNS AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) dan.
## Mengaktifkan penelusuran aktif pada topik Amazon SNS menggunakan konsol AWS
Saat penelusuran aktif diaktifkan pada topik Amazon SNS, ia membaca ID jejak, mengirimkan data ke pelanggan berdasarkan ID jejak, dan menyebarkan ID jejak ke layanan hilir.
1. Masuk ke [Konsol Amazon SNS](https://console.aws.amazon.com/sns/home).
1. Pilih topik atau buat yang baru. Untuk detail selengkapnya tentang membuat topik, lihat [Membuat topik Amazon SNS](sns-create-topic.md).
1. Pada halaman **Buat topik**, di bagian **Detail**, pilih jenis topik: **FIFO** atau **Standar**.
1. Masukkan **Nama** untuk topik.
1. (Opsional) Masukkan **Nama tampilan** untuk topik.
1. Perluas **Penelusuran aktif**, dan pilih **Gunakan penelusuran aktif**.
Setelah mengaktifkan X-Ray untuk topik Amazon SNS Anda, Anda dapat menggunakan [peta layanan X-Ray untuk melihat end-to-end jejak dan peta](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) layanan untuk topik tersebut.
## Mengaktifkan penelusuran aktif pada topik Amazon SNS menggunakan SDK AWS
Contoh kode berikut menunjukkan cara mengaktifkan penelusuran aktif pada topik Amazon SNS dengan menggunakan AWS SDK for Java.
```
public static void enableActiveTracing(SnsClient snsClient, String topicArn) {
try {
SetTopicAttributesRequest request = SetTopicAttributesRequest.builder()
.attributeName("TracingConfig")
.attributeValue("Active")
.topicArn(topicArn)
.build();
SetTopicAttributesResponse result = snsClient.setTopicAttributes(request);
System.out.println("\n\nStatus was " + result.sdkHttpResponse().statusCode() + "\n\nTopic " + request.topicArn()
+ " updated " + request.attributeName() + " to " + request.attributeValue());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
}
}
```
## Mengaktifkan penelusuran aktif pada topik Amazon SNS menggunakan CLI AWS
Contoh kode berikut menunjukkan cara mengaktifkan penelusuran aktif pada topik Amazon SNS dengan menggunakan CLI. AWS
```
aws sns set-topic-attributes \
--topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--attribute-name TracingConfig \
--attribute-value Active
```
## Mengaktifkan penelusuran aktif pada topik Amazon SNS menggunakan CloudFormation
CloudFormation Tumpukan berikut menunjukkan cara mengaktifkan penelusuran aktif pada topik Amazon SNS.
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
MyTopicResource:
Type: 'AWS::SNS::Topic'
Properties:
TopicName: 'MyTopic'
TracingConfig: 'Active'
```
## Memverifikasi penelusuran aktif diaktifkan untuk topik Anda
Anda dapat menggunakan konsol Amazon SNS untuk memverifikasi apakah penelusuran aktif diaktifkan untuk topik Anda, atau bila kebijakan sumber daya gagal ditambahkan.
1. Masuk ke [konsol Amazon SNS](https://console.aws.amazon.com/sns/home).
1. Di panel navigasi kiri, pilih **Topics (Topik)**.
1. Pada halaman **Topik**, pilih topik.
1. Pilih tab **Integrasi**.
Saat penelusuran aktif diaktifkan, ikon **Aktif** berwarna hijau ditampilkan.
1. Jika Anda telah mengaktifkan penelusuran aktif dan Anda tidak melihat bahwa kebijakan sumber daya telah ditambahkan, pilih **Buat kebijakan** untuk menambahkan izin tambahan yang diperlukan.
![\[Screen shot menampilkan detail topik Amazon SNS bernama SampleTopic "" di. Konsol Manajemen AWS Ini menunjukkan bahwa penelusuran AWS X-Ray aktif diaktifkan untuk topik ini, tetapi kebijakan sumber daya yang memungkinkan Amazon SNS mengirim data jejak tidak ada. Tombol “Buat kebijakan” disediakan untuk mengatasi masalah ini.\]](http://docs.aws.amazon.com/id_id/sns/latest/dg/images/xray.png)
## Menguji penelusuran aktif
1. Masuk ke [Konsol Amazon SNS](https://console.aws.amazon.com/sns/home).
1. Buat topik Amazon SNS. Untuk detail tentang cara melakukannya, lihat [Untuk membuat topik menggunakan Konsol Manajemen AWS](sns-create-topic.md#create-topic-aws-console).
1. Perluas **Penelusuran aktif**, dan pilih **Gunakan penelusuran aktif**.
1. Publikasikan pesan ke topik Amazon SNS. Untuk detail tentang cara melakukannya, lihat [Untuk mempublikasikan pesan ke topik Amazon SNS menggunakan Konsol Manajemen AWS](sns-publishing.md#sns-publishing-messages).
1. Gunakan [peta layanan X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) untuk melihat end-to-end jejak dan peta layanan untuk topik tersebut.
![\[Menampilkan peta AWS X-Ray layanan yang menunjukkan penelusuran permintaan yang mengalir dari klien ke topik Amazon SNS bernama xray-topic ".” Dari sana, pesan didistribusikan ke berbagai layanan hilir, termasuk antrian Amazon SQS, fungsi Lambda, firehose Kinesis, dan layanan jarak jauh. Setiap koneksi menampilkan metrik seperti latensi dalam milidetik (ms) dan tingkat transaksi per menit (t/menit), membantu menganalisis kinerja dan mengidentifikasi masalah latensi dalam proses pengiriman pesan.\]](http://docs.aws.amazon.com/id_id/sns/latest/dg/images/xray-troubleshooting.png)