Visualización de métricas y registros de Amazon CloudWatch para entregas de SMS

Puede utilizar Amazon CloudWatch y Amazon CloudWatch Logs para monitorear las entregas de mensajes SMS.

Visualización de métricas de Amazon CloudWatch

Amazon SNS recopila de manera automática las métricas de las entregas de mensajes SMS y las inserta en Amazon CloudWatch. Puede utilizar CloudWatch para monitorear estas métricas y crear alarmas para recibir una alerta cuando una métrica traspase un umbral. Por ejemplo, puede monitorear las métricas de CloudWatch para informarse de su tasa de entrega de SMS y sus cargos por SMS del mes hasta la fecha.

Para obtener más información sobre el monitoreo de métricas de CloudWatch, la configuración de alarmas de CloudWatch y los tipos de métricas disponibles, consulte Supervisión de temas de Amazon SNS mediante CloudWatch.

Visualización de CloudWatch Logs

Puede recopilar información sobre las entregas exitosas y no exitosas de mensajes SMS al habilitar a Amazon SNS para que escriba en Amazon CloudWatch Logs. Por cada mensaje SMS que envíe, Amazon SNS escribirá un registro en el que se incluya el precio del mensaje, su estado (correcto o error), el motivo del error (si el mensaje generó un error), el tiempo de permanencia del mensaje y otra información.

Si quiere habilitar y ver los CloudWatch Logs para sus mensajes SMS, siga estos pasos:

1. Inicie sesión en la consola de Amazon SNS.

2. En el menú de la consola, establezca el selector de regiones en una región que admita la mensajería SMS.

3. En el panel de navegación, elija Text messaging (SMS) (Mensajería de texto (SMS)).

4. En la página Mensajería de texto a través del móvil (SMS), en la sección Preferencias de mensajería de texto, elija Editar.

5. En la siguiente página, expanda la sección Registro de estado de entrega.

6. En Tasa de muestreo correcto, especifique el porcentaje de entregas de SMS correctas para las que Amazon SNS escribirá registros en CloudWatch Logs. Por ejemplo:

   • Por ejemplo, para escribir registros únicamente para las entregas erróneas, establezca este valor en 0.

   • Para escribir logs para el 10% de las entregas de correctas, establézcalo en 10.

   Si no especifica ningún porcentaje, Amazon SNS escribirá registros para todas las entregas correctas.

7. Para proporcionar los permisos obligatorios, realice una de las siguientes acciones:

   • Para crear un nuevo rol de servicio, elija Crear nueva función de servicio y, a continuación, Crear nuevos roles. En la página siguiente, elija Permitir para dar acceso de escritura a Amazon SNS a los recursos de su cuenta.

   • Para utilizar una función de servicio existente, haga clic en Usar función de servicio existente y, a continuación, pegue el nombre de ARN en el cuadro Rol de IAM para entregas exitosas y fallidas.

     Mediante la función de servicio que especifique, se debe permitir el acceso de escritura a los recursos de su cuenta. Para obtener más información sobre la creación de roles de IAM, consulte Creación de un rol para un servicio de AWS (consola) en la Guía del usuario de IAM.

8. Elija Save changes.

9. De vuelta en la página Mensajería de texto móvil (SMS)), vaya a la sección Registros de estado de entrega para ver los registros disponibles.

   nota

   Según el operador del número de teléfono de destino, los registros de entrega pueden tardar hasta 72 horas en aparecer en la consola de Amazon SNS.

Registro de ejemplo para una entrega de SMS correcta

El log de estado de una entrega de SMS correcta será similar al ejemplo siguiente:

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

Registro de ejemplo para una entrega de SMS errónea

El log de estado de una entrega de SMS errónea será similar al ejemplo siguiente:

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

Motivos de error de entrega de SMS

El motivo de un error se proporciona con el atributo providerResponse. Es posible que los mensajes SMS no se puedan entregar por los motivos siguientes:

• El operador de telefonía lo bloquea por considerarlo spam.

• El destino está en una lista bloqueada

• Número de teléfono no válido.

• Cuerpo de mensaje no válido.

• El operador de telefonía ha bloqueado este mensaje.

• El operador de telefonía no está disponible o no es posible ponerse en contacto con él.

• El teléfono ha bloqueado los SMS.

• El teléfono está en una lista bloqueada

• El teléfono no está disponible o no es posible ponerse en contacto con él.

• Se ha cancelado la suscripción del número de teléfono.

• Esta entrega superaría el precio máximo.

• Error desconocido al intentar ponerse en contacto con el teléfono