Pemantauan pengiriman SMS Amazon SNS dengan CloudWatch metrik dan log Amazon

Anda dapat menggunakan Amazon CloudWatch dan Amazon CloudWatch Logs untuk memantau pengiriman pesan SMS Anda.

Melihat CloudWatch metrik Amazon

Amazon SNS secara otomatis mengumpulkan metrik tentang pengiriman pesan SMS Anda dan mendorongnya ke Amazon. CloudWatch Anda dapat menggunakan CloudWatch untuk memantau metrik ini dan membuat alarm untuk mengingatkan Anda ketika metrik melewati ambang batas. Misalnya, Anda dapat memantau CloudWatch metrik untuk mempelajari tingkat pengiriman SMS dan biaya month-to-date SMS Anda.

Untuk informasi tentang CloudWatch metrik pemantauan, pengaturan CloudWatch alarm, dan jenis metrik yang tersedia, lihat. Memantau topik Amazon SNS menggunakan CloudWatch

Melihat CloudWatch Log

Anda dapat mengumpulkan informasi tentang pengiriman pesan SMS yang berhasil dan tidak berhasil dengan mengaktifkan Amazon SNS untuk menulis ke Amazon Logs. CloudWatch Untuk setiap pesan SMS yang Anda kirim, Amazon SNS menulis log yang mencakup harga pesan, status keberhasilan atau kegagalan, alasan kegagalan (jika pesan gagal), waktu tunggu pesan, dan informasi lainnya.

Untuk mengaktifkan dan melihat CloudWatch Log untuk pesan SMS Anda

1. Masuk ke konsol Amazon SNS.

2. Di menu konsol tersebut, atur pemilih wilayah ke wilayah yang mendukung olahpesan SMS.

3. Di panel navigasi, pilih Text messaging (SMS) (Olahpesan teks (SMS)).

4. Di halaman Mobile text messaging (SMS) (Olahpesan teks seluler (SMS)), di bagian Text messaging preferences(Preferensi pesan teks), pilih Edit.

5. Di halaman berikutnya, perluas bagian Delivery status logging (Pencatatan status pengiriman).

6. Untuk tingkat sampel Sukses, tentukan persentase pengiriman SMS yang berhasil di mana Amazon SNS akan menulis log CloudWatch di Log. Sebagai contoh:

   • Untuk menulis log hanya untuk pengiriman yang gagal, atur nilai ini ke 0.

   • Untuk menulis log untuk 10% dari pengiriman yang berhasil, atur nilai ke 10.

   Jika Anda tidak menentukan persentase, Amazon SNS menulis log untuk semua pengiriman yang berhasil.

7. Untuk memberikan izin yang diperlukan, lakukan salah satu hal berikut:

   • Untuk membuat peran layanan baru, pilih Create new service role (Buat peran layanan baru) dan kemudian Create new roles (Buat peran baru). Di halaman berikutnya, pilih Allow (Izinkan) untuk memberi Amazon SNS akses tulis ke sumber daya akun Anda.

   • Untuk menggunakan peran layanan yang ada, pilih Use existing service role (Gunakan peran layanan yang ada) lalu tempelkan nama ARN di kotak IAM role for successful and failed deliveries (Peran IAM untuk pengiriman yang berhasil dan gagal).

     Peran layanan yang Anda tentukan harus mengizinkan akses tulis ke sumber daya akun Anda. Untuk informasi selengkapnya tentang membuat peran IAM, lihat Membuat peran untuk AWS layanan di Panduan Pengguna IAM.

8. Pilih Simpan perubahan.

9. Kembali ke halaman Mobile text messaging (SMS) (Pesan teks seluler (SMS)), masuk ke bagian Delivery status logs (Log status pengiriman) untuk melihat log yang tersedia.

   catatan

   Tergantung pada operator nomor telepon tujuan, perlu waktu hingga 72 jam agar log pengiriman muncul di konsol Amazon SNS.

Contoh log untuk pengiriman SMS yang berhasil

Log status pengiriman untuk pengiriman SMS yang berhasil akan menyerupai contoh berikut:

{
    "notification": {
        "messageId": "34d9b400-c6dd-5444-820d-fbeb0f1f54cf",
        "timestamp": "2016-06-28 00:40:34.558"
    },
    "delivery": {
        "phoneCarrier": "My Phone Carrier",
        "mnc": 270,
        "numberOfMessageParts": 1,
        "destination": "+1XXX5550100",
        "priceInUSD": 0.00645,
        "smsType": "Transactional",
        "mcc": 310,
        "providerResponse": "Message has been accepted by phone carrier",
        "dwellTimeMs": 599,
        "dwellTimeMsUntilDeviceAck": 1344
    },
    "status": "SUCCESS"
}

Contoh log untuk pengiriman SMS yang gagal

Log status pengiriman untuk pengiriman SMS yang gagal akan menyerupai contoh berikut:

{
    "notification": {
        "messageId": "1077257a-92f3-5ca3-bc97-6a915b310625",
        "timestamp": "2016-06-28 00:40:34.559"
    },
    "delivery": {
        "mnc": 0,
        "numberOfMessageParts": 1,
        "destination": "+1XXX5550100",
        "priceInUSD": 0.00645,
        "smsType": "Transactional",
        "mcc": 0,
        "providerResponse": "Unknown error attempting to reach phone",
        "dwellTimeMs": 1420,
        "dwellTimeMsUntilDeviceAck": 1692
    },
    "status": "FAILURE"
}

Alasan kegagalan pengiriman SMS

Alasan kegagalan diberikan dengan atribut providerResponse. Pesan SMS mungkin gagal dikirim karena alasan-alasan berikut:

• Diblokir sebagai spam oleh operator telepon

• Tujuan ada di daftar yang diblokir

• Nomor telepon tidak valid

• Isi pesan tidak valid

• Operator telepon telah memblokir pesan ini

• Operator telepon saat ini tidak dapat dihubungi/tidak tersedia

• Telepon telah memblokir SMS

• Telepon ada dalam daftar yang diblokir

• Telepon saat ini tidak dapat dihubungi/tidak tersedia

• Nomor telepon memilih tidak menerima pesan

• Pengiriman ini akan melebihi harga maksimum

• Kesalahan tak diketahui yang mencoba menjangkau telepon