Monitoraggio della consegna degli SMS di Amazon SNS con CloudWatch parametri e log di Amazon

Puoi utilizzare Amazon CloudWatch e Amazon CloudWatch Logs per monitorare le consegne dei tuoi messaggi SMS.

Visualizzazione dei CloudWatch parametri di Amazon

Amazon SNS raccoglie automaticamente i parametri relativi alle consegne dei messaggi SMS e li invia ad Amazon. CloudWatch Puoi utilizzarlo CloudWatch per monitorare queste metriche e creare allarmi per avvisarti quando una metrica supera una soglia. Ad esempio, puoi monitorare le CloudWatch metriche per conoscere la tariffa di consegna degli SMS e i costi degli SMS. month-to-date

Per informazioni sul monitoraggio delle CloudWatch metriche, sull'impostazione degli CloudWatch allarmi e sui tipi di metriche disponibili, consulta. Monitoraggio degli argomenti di Amazon SNS tramite CloudWatch

Visualizzazione dei registri CloudWatch

Puoi raccogliere informazioni sulle consegne di messaggi SMS riuscite e non riuscite abilitando Amazon SNS alla scrittura su Amazon Logs. CloudWatch Per ogni SMS inviato, Amazon SNS creerà un log con il costo del messaggio, lo stato di consegna e la motivazione in caso di fallimento, il tempo di sosta e altre informazioni.

Per abilitare e visualizzare i CloudWatch log per i tuoi messaggi SMS

1. Accedi alla console Amazon SNS.

2. Nel menu della console, imposta lo strumento di selezione della regione su una regione che supporti la messaggistica SMS.

3. Nel riquadro di navigazione, selezionare Text messaging (SMS) (Messaggi di testo (SMS)).

4. Nella pagina Mobile text messaging (SMS) (Messaggi di testo mobili (SMS)), nella sezione Text messaging preferences (Preferenze per i messaggi di testo), scegliere Edit (Modifica).

5. Nella pagina successiva, espandere la sezione Delivery status logging (Registrazione dello stato di consegna).

6. Per la frequenza di campionamento Success, specifica la percentuale di consegne SMS riuscite per le quali Amazon SNS scriverà i log in CloudWatch Logs. Per esempio:

   • Per generare dei log unicamente per le consegne non riuscite, imposta questo valore su 0.

   • Per generare dei log per il 10% delle consegne riuscite, imposta 10.

   Se non specifichi una percentuale, Amazon SNS genera dei log per tutte le consegne riuscite.

7. Per fornire le autorizzazioni necessarie, eseguire una delle seguenti operazioni:

   • Per creare un nuovo ruolo del servizio, scegli Creazione di un nuovo ruolo del servizio e poi Creazione di nuovi ruoli. Nella pagina successiva, scegli Abilita per consentire ad Amazon SNS di accedere in scrittura alle risorse del tuo account.

   • Per utilizzare un ruolo del servizio esistente, scegli Utilizzare il ruolo del servizio esistente e quindi incollare il nome ARN nella casella Ruolo IAM per consegne riuscite e non riuscite.

     Il ruolo di servizio specificato deve consentire l'accesso in scrittura alle risorse dell'account. Per ulteriori informazioni sulla creazione di ruoli IAM, consulta Creating a role for an AWS service nella IAM User Guide.

8. Scegli Save changes (Salva modifiche).

9. Nella pagina Messaggi di testo per dispositivi mobili (SMS) vai alla pagina Registri dello stato di per visualizzare tutti i registri disponibili.

   Nota

   A seconda del corriere del numero di telefono di destinazione, possono essere necessarie fino a 72 ore affinché i log delle consegne vengano visualizzati nella console Amazon SNS.

Log di esempio per gli SMS inviati con successo

Il log dello stato di consegna per un SMS inviato con successo sarà simile al seguente esempio:

{
    "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"
}

Log di esempio per gli SMS falliti

Il log dello stato di consegna per un SMS fallito sarà simile al seguente esempio:

{
    "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"
}

Ragioni per un SMS fallito

La ragione per un SMS fallito viene fornita dall'attributo providerResponse. L'invio di un messaggio SMS potrebbe fallire per i seguenti motivi:

• Bloccato come spam dall'operatore telefonico

• La destinazione è in un elenco bloccato

• Il numero di telefono non è valido

• Il testo del messaggio non è valido

• L'operatore telefonico ha bloccato il messaggio

• L'operatore telefonico non è raggiungibile/disponibile

• Il telefono ha bloccato l'SMS

• Il telefono è in un elenco bloccato

• Il telefono non è raggiungibile/disponibile

• Il numero di telefono è stato escluso

• La consegna supera il costo massimo

• Errore sconosciuto nel tentativo di raggiungere il telefono