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 LambdaSQS, dan langganan titik akhir HTTP/S.

Dengan X-Ray, Anda mendapatkan end-to-end tampilan dari setiap permintaan, memungkinkan Anda untuk:

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 API, Referensi CLI Layanan Pemberitahuan Sederhana Amazon, atau. AWS CloudFormation

Untuk mempelajari selengkapnya tentang menggunakan Amazon SNS dengan X-Ray, lihat Amazon SNS AWS X-Ray 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, silakan lihat Identity and access management di Amazon SNS dan Contoh kasus untuk pengendalian akses Amazon SNS.

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 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.

Setelah mengaktifkan X-Ray untuk topik Amazon SNS Anda, Anda dapat menggunakan peta layanan X-Ray untuk melihat end-to-end jejak dan peta 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 AWS CloudFormation

AWS 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.

Menguji penelusuran aktif