Putar ulang pesan untuk pelanggan topik FIFO - Amazon Simple Notification Service

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

Putar ulang pesan untuk pelanggan topik FIFO

Pemutaran ulang Amazon SNS memungkinkan pelanggan topik mengambil pesan yang diarsipkan dari penyimpanan data topik dan mengirimkan ulang (atau memutar ulang) mereka ke titik akhir berlangganan. Pesan dapat diputar ulang segera setelah langganan dibuat. Pesan yang diputar ulang memiliki konten yang samaMessageId, dan Timestamp sebagai salinan asli, dan juga berisi atributReplayed, untuk membantu Anda mengidentifikasi bahwa itu adalah pesan yang diputar ulang. Untuk hanya memutar ulang pesan tertentu, Anda dapat menambahkan kebijakan filter ke langganan Anda. Untuk informasi lebih lanjut tentang memfilter pesan, lihatFilter pesan yang diputar ulang.

Membuat kebijakan pemutaran ulang pesan menggunakan AWS Management Console

Gunakan opsi ini untuk membuat kebijakan replay baru menggunakan. AWS Management Console

  1. Masuk ke Konsol Amazon SNS.

  2. Pilih langganan topik atau buat yang baru. Untuk mempelajari lebih lanjut tentang membuat langganan, lihatBerlangganan topik Amazon SNS.

  3. Untuk memulai pemutaran ulang pesan, buka drop-down Putar ulang dan pilih Mulai replay.

  4. Dari modal Replay timeframe, buat pilihan berikut:

    1. Pilih tanggal dan waktu mulai putar ulang - Pilih tanggal (format YYYY/MM/DD) dan waktu (format 24 jam jam: mm: ss) dari mana Anda ingin mulai memutar ulang pesan yang diarsipkan. Waktu mulai harus lebih lambat dari awal perkiraan waktu arsip.

    2. (Opsional) Pilih tanggal dan waktu akhir pemutaran ulang - Pilih tanggal (format YYYY/MM/DD) dan waktu (format 24 jam jam: mm: ss) saat Anda ingin berhenti memutar ulang pesan yang diarsipkan.

    3. Pilih Mulai putar ulang.

  5. (Opsional) Untuk menghentikan pemutaran ulang pesan, buka halaman Detail langganan dan pilih Hentikan pemutaran ulang dari tarik-turun Putar Ulang.

  6. (Opsional) Untuk memantau metrik pemutaran ulang pesan dari dalam alur kerja ini menggunakan CloudWatch, lihat. Pantau metrik pemutaran ulang pesan menggunakan Amazon CloudWatch

Untuk melihat dan mengedit kebijakan pemutaran ulang pesan

Anda dapat melakukan tindakan berikut dari halaman Detail langganan:

  • Untuk melihat status pemutaran ulang pesan, bidang status Putar ulang menampilkan nilai berikut:

    • Selesai — Putar ulang telah berhasil mengirim ulang semua pesan, dan sekarang mengirimkan pesan yang baru diterbitkan.

    • Sedang berlangsung - Putar ulang saat ini memutar ulang pesan yang dipilih.

    • Gagal - Pemutaran ulang tidak dapat diselesaikan.

    • Pending - Status default saat pemutaran ulang dimulai.

  • (Opsional) Untuk mengubah kebijakan pemutaran ulang pesan, buka halaman Detail langganan dan pilih Mulai memutar ulang dari tarik-turun Putar Ulang. Memulai replay akan menggantikan replay yang ada.

Menambahkan kebijakan pemutaran ulang ke langganan menggunakan API

Untuk memutar ulang pesan yang diarsipkan, gunakan atribut. ReplayPolicy ReplayPolicydapat digunakan dengan tindakan SetSubscriptionAttributes API Subscribe dan. Kebijakan ini memiliki nilai-nilai berikut:

  • StartingPoint(Wajib) — Sinyal dari mana harus mulai memutar ulang pesan.

  • EndingPoint(Opsional) — Sinyal kapan harus berhenti memutar ulang pesan. Jika EndingPoint dihilangkan, maka pemutaran ulang akan berlanjut hingga terjebak hingga waktu saat ini.

  • PointType(Wajib) - Mengatur jenis titik awal dan akhir. Saat ini, nilai yang didukung untuk PointType adalahTimestamp.

Misalnya, untuk memulihkan dari kegagalan hilir dan mengirim ulang semua pesan selama dua jam pada 1 Oktober 2023, gunakan tindakan SetSubscriptionAttributes API untuk menetapkan sebagai ReplayPolicy berikut:

{ "PointType":"Timestamp", "StartingPoint":"2023-10-01T10:00:00.000Z", "EndingPoint":"2023-10-01T12:00:00.000Z" }

Untuk memutar ulang semua pesan yang dikirim ke topik per 1 Oktober 2023, dan terus menerima semua pesan yang baru dipublikasikan ke topik Anda, gunakan tindakan SetSubscriptionAttributes API untuk menyetel langganan Anda sebagai berikut: ReplayPolicy

{ "PointType":"Timestamp", "StartingPoint":"2023-10-01T00:00:00.000Z" }

Untuk memverifikasi bahwa pesan telah diputar ulang, atribut boolean ditambahkan ke setiap pesan yang Replayed diputar ulang.

Menambahkan kebijakan pemutaran ulang ke langganan menggunakan SDK

Untuk menggunakan AWS SDK, Anda harus mengonfigurasinya dengan kredensil Anda. Untuk informasi selengkapnya, lihat Berbagi config dan credentials file di Panduan Referensi AWS SDK dan Alat.

Contoh kode berikut menunjukkan cara mengatur langganan untuk mengirim ulang pesan dari arsip topik Amazon SNS FIFO untuk jangka waktu 2 jam pada 1 Oktober 2023. ReplayPolicy

// Specify the ARN of the Amazon SNS subscription to initiate the ReplayPolicy on. String subscriptionArn = "arn:aws:sns:us-east-2:123456789012:MyArchiveTopic.fifo:1d2a3e9d-7f2f-447c-88ae-03f1c68294da"; // Set the ReplayPolicy to replay messages from the topic's archive // for a 2 hour time period on October 1st 2023 between 10am and 12pm UTC. String replayPolicy = "{\"PointType\":\"Timestamp\",\"StartingPoint\":\"2023-10-01T10:00:00.000Z\",\"EndingPoint\":\"2023-10-01T12:00:00.000Z\"}"; // Set the ArchivePolicy for the Amazon SNS topic SetSubscriptionAttributesRequest request = new SetSubscriptionAttributesRequest() .withSubscriptionArn(subscriptionArn) .withAttributeName("ReplayPolicy") .withAttributeValue(replayPolicy); sns.setSubscriptionAttributes(request);

Filter pesan yang diputar ulang

Pemfilteran pesan Amazon SNS memungkinkan Anda mengontrol pesan yang diputar ulang yang diputar ulang Amazon SNS ke titik akhir pelanggan Anda. Saat pemfilteran pesan dan pengarsipan pesan diaktifkan, Amazon SNS pertama-tama mengambil pesan dari penyimpanan data topik, lalu menerapkan pesan terhadap langganan. FilterPolicy Pesan dikirim ke titik akhir berlangganan saat ada kecocokan, jika tidak, pesan akan disaring. Untuk informasi selengkapnya, lihat Kebijakan filter langganan Amazon SNS.

Pantau metrik pemutaran ulang pesan menggunakan Amazon CloudWatch

Anda dapat memantau pesan pemutaran ulang menggunakan Amazon CloudWatch menggunakan metrik berikut. Agar diberi tahu tentang anomali pada beban kerja Anda dan membantu menghindari dampak, Anda dapat mengonfigurasi CloudWatch alarm Amazon pada metrik ini. Untuk detail selengkapnya, lihat Pencatatan dan Pemantauan di Amazon SNS.

Metrik Deskripsi

NumberOfReplayedNotificationsDelivered

Menyediakan pelanggan dengan jumlah agregat pesan yang diputar ulang dari arsip topik, pada resolusi 1 menit.

NumberOfReplayedNotificationsFailed

Menyediakan pelanggan dengan jumlah agregat pesan yang diputar ulang yang gagal disampaikan dari arsip topik, pada resolusi 1 menit.