Amazon SNS dan AWS X-Ray

Anda dapat menggunakan 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 berlangganan yang didukung SNS Anda. 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 untuk topik Amazon SNS dengan menggunakan konsol Amazon SNS, atau dengan menggunakan Amazon SNS API atau CLI. Lihat Instrumentasi aplikasi Anda untuk informasi selengkapnya tentang menginstrumentasi 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 SNS dan Contoh kasus untuk kontrol akses Amazon SNS 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 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 PutResourcePolicyuntuk mengonfigurasi X-Ray dengan kebijakan berbasis sumber daya yang diperlukan untuk memungkinkan Amazon SNS mengirim 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"
          }
        }
      }
    ]
  }

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" } } } ] }'

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.

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.

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.

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