

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Supervisión de la entrega de SMS de Amazon SNS con CloudWatch métricas y registros de Amazon
<a name="sms_stats_cloudwatch"></a>

Puedes usar Amazon CloudWatch y Amazon CloudWatch Logs para supervisar la entrega de tus mensajes SMS.

## Ver las CloudWatch métricas de Amazon
<a name="sms_stats_cloudwatch_metrics"></a>

Amazon SNS recopila automáticamente las estadísticas sobre la entrega de sus mensajes SMS y las envía a Amazon. CloudWatch Puede utilizarlas CloudWatch para supervisar estas métricas y crear alarmas que le avisen cuando una métrica supere un umbral. Por ejemplo, puedes monitorear CloudWatch las métricas para conocer tu tarifa de envío de SMS y tus cargos por month-to-date SMS.

Para obtener información sobre la supervisión de CloudWatch las métricas, la configuración de CloudWatch alarmas y los tipos de métricas disponibles, consulte[Supervisión de temas de Amazon SNS mediante CloudWatch](sns-monitoring-using-cloudwatch.md).

## Visualización CloudWatch de registros
<a name="sns-viewing-cloudwatch-logs"></a>

Puede recopilar información sobre las entregas de mensajes SMS realizadas correctamente y sin éxito si permite que Amazon SNS 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.

**Para habilitar y ver CloudWatch los registros de sus mensajes SMS**

1. Inicie sesión en la [consola de Amazon SNS](https://console.aws.amazon.com/sns/home).

1. En el menú de la consola, establezca el selector de regiones en una [región que admita la mensajería SMS](https://docs.aws.amazon.com/general/latest/gr/end-user-messaging.html).

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

1. 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**.

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

1. En **Frecuencia de muestreo** correcta, especifique el porcentaje de envíos de SMS correctos para los que Amazon SNS escribirá registros en CloudWatch los registros. 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.

1. 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 funciones de IAM, consulte [Creación de una función para un AWS servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html#roles-creatingrole-service-console) en la Guía del usuario de *IAM*. 

1. Seleccione **Save changes (Guardar cambios)**.

1. 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
<a name="example-log-successful-sms-delivery"></a>

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
<a name="example-log-failed-sms-delivery"></a>

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
<a name="sms_stats_delivery_fail_reasons"></a>

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