Melihat AmazonCloudWatchmetrik dan log untuk pengiriman SMS

Anda dapat menggunakan AmazonCloudWatchdan AmazonCloudWatchLogs untuk memantau pengiriman pesan SMS Anda.

Melihat AmazonCloudWatchmetrik

Amazon SNS secara otomatis mengumpulkan metrik tentang pengiriman pesan SMS Anda dan mendorongnya ke AmazonCloudWatch. Anda dapat menggunakanCloudWatchuntuk memantau metrik ini dan membuat alarm untuk memberi tahu Anda bila metrik melintasi ambang batas. Misalnya, Anda dapat memantauCloudWatchmetrik untuk mempelajari tingkat pengiriman SMS Anda danmonth-to-dateBiaya SMS.

Untuk informasi tentang pemantauanCloudWatchmetrik, pengaturanCloudWatchalarm, dan jenis metrik yang tersedia, lihatMemantau topik Amazon SNS menggunakan CloudWatch.

MelihatCloudWatchBeberapa catatan

Anda dapat mengumpulkan informasi tentang pengiriman pesan SMS yang berhasil dengan mengaktifkan Amazon SNS ke AmazonCloudWatchLog. 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.

Cara mengaktifkan dan melihatCloudWatchLogs 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. UntukTingkat sampel keberhasilan, tentukan persentase pengiriman SMS yang berhasil yang akan ditulis Amazon SNSCloudWatchLog. Misalnya:

   • 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 cara membuat IAM role, lihat Membuat peran untuk layanan AWS dalam Panduan Pengguna IAM.

8. Pilih Save changes (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