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.
# Registro y monitoreo en Amazon SNS
Amazon SNS le permite realizar un seguimiento y supervisar la actividad de mensajería mediante el registro de las llamadas a la API CloudTrail y la supervisión de los temas con. CloudWatch Estas herramientas le ayudan a obtener información sobre la entrega de mensajes, solucionar problemas y garantizar el buen estado de sus flujos de trabajo de mensajería. Este tema cubre lo siguiente:
+ [Registro de llamadas a la API de AWS SNS mediante AWS CloudTrail](logging-using-cloudtrail.md). Este registro le permite realizar un seguimiento de las acciones realizadas en sus temas de Amazon SNS, como la creación de temas, la administración de suscripciones y la publicación de mensajes. Al analizar CloudTrail los registros, puede identificar quién realizó solicitudes de API específicas y cuándo se hicieron esas solicitudes, lo que le ayuda a auditar y solucionar problemas de uso de Amazon SNS.
+ [Supervisión de temas de Amazon SNS mediante CloudWatch](sns-monitoring-using-cloudwatch.md). CloudWatch proporciona métricas que le permiten observar el rendimiento y el estado de sus temas de Amazon SNS en tiempo real. Configure alarmas en función de estas métricas, lo que le permitirá responder con prontitud a cualquier anomalía, como errores en la entrega o una latencia elevada de los mensajes. Esta capacidad de supervisión garantiza que pueda mantener la fiabilidad de su sistema de mensajería basado en el SNS al abordar de forma proactiva los posibles problemas.
# Registro de llamadas a la API de AWS SNS mediante AWS CloudTrail
AWS SNS está integrado con [AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)un servicio que proporciona un registro de las acciones realizadas por un usuario, rol o un. Servicio de AWS CloudTrail captura todas las llamadas a la API de SNS como eventos. Las llamadas capturadas incluyen llamadas desde la consola de SNS y las llamadas de código a las operaciones de la API de SNS. Con la información recopilada CloudTrail, puede determinar la solicitud que se realizó a SNS, la dirección IP desde la que se realizó la solicitud, cuándo se realizó y detalles adicionales.
Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad del usuario le ayuda a determinar lo siguiente:
+ Si la solicitud se realizó con las credenciales del usuario raíz o del usuario.
+ Si la solicitud se realizó en nombre de un usuario de IAM Identity Center.
+ Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado.
+ Si la solicitud la realizó otro Servicio de AWS.
CloudTrail está activa en tu cuenta Cuenta de AWS cuando creas la cuenta y tienes acceso automáticamente al **historial de CloudTrail eventos**. El **historial de CloudTrail eventos** proporciona un registro visible, consultable, descargable e inmutable de los últimos 90 días de eventos de gestión registrados en un. Región de AWS*Para obtener más información, consulte [Uso del historial de CloudTrail eventos en la Guía del usuario](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).AWS CloudTrail * La visualización del **historial de eventos** no conlleva ningún CloudTrail cargo.
Para tener un registro continuo de los eventos de Cuenta de AWS los últimos 90 días, crea un almacén de datos de eventos de senderos o [CloudTraillagos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html).
**CloudTrail senderos**
Un *rastro* permite CloudTrail entregar archivos de registro a un bucket de Amazon S3. Todos los senderos creados con él Consola de administración de AWS son multirregionales. Puede crear un registro de seguimiento de una sola región o multirregionales mediante la AWS CLI. Se recomienda crear un sendero multirregional, ya que puedes capturar toda la actividad de tu Regiones de AWS cuenta. Si crea un registro de seguimiento de una sola región, solo podrá ver los eventos registrados en la Región de AWS del registro de seguimiento. Para obtener más información acerca de los registros de seguimiento, consulte [Creación de un registro de seguimiento para su Cuenta de AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) y [Creación de un registro de seguimiento para una organización](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-trail-organization.html) en la *Guía del usuario de AWS CloudTrail *.
Puede enviar una copia de sus eventos de administración en curso a su bucket de Amazon S3 sin coste alguno CloudTrail mediante la creación de una ruta; sin embargo, hay cargos por almacenamiento en Amazon S3. Para obtener más información sobre CloudTrail los precios, consulte [AWS CloudTrail Precios](https://aws.amazon.com/cloudtrail/pricing/). Para obtener información acerca de los precios de Amazon S3, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).
**CloudTrail Almacenes de datos de eventos en Lake**
*CloudTrail Lake* le permite ejecutar consultas basadas en SQL en sus eventos. CloudTrail Lake convierte los eventos existentes en formato JSON basado en filas al formato [Apache](https://orc.apache.org/) ORC. ORC es un formato de almacenamiento en columnas optimizado para una recuperación rápida de datos. Los eventos se agregan en *almacenes de datos de eventos*, que son recopilaciones inmutables de eventos en función de criterios que se seleccionan aplicando [selectores de eventos avanzados](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors). Los selectores que se aplican a un almacén de datos de eventos controlan los eventos que perduran y están disponibles para la consulta. Para obtener más información sobre CloudTrail Lake, consulte Cómo [trabajar con AWS CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) en la Guía del *AWS CloudTrail usuario*.
CloudTrail Los almacenes de datos y las consultas sobre eventos de Lake conllevan costes. Cuando crea un almacén de datos de eventos, debe elegir la [opción de precios](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option) que desee utilizar para él. La opción de precios determina el costo de la incorporación y el almacenamiento de los eventos, así como el período de retención predeterminado y máximo del almacén de datos de eventos. Para obtener más información sobre CloudTrail los precios, consulte [AWS CloudTrail Precios](https://aws.amazon.com/cloudtrail/pricing/).
## Eventos de datos de SNS en CloudTrail
Los [eventos de datos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events) proporcionan información sobre las operaciones de recursos realizadas en o dentro de un recurso (por ejemplo, leer o escribir en un objeto de Amazon S3). Se denominan también operaciones del plano de datos. Los eventos de datos suelen ser actividades de gran volumen. De forma predeterminada, CloudTrail no registra los eventos de datos. El **historial de CloudTrail eventos** no registra los eventos de datos.
Se aplican cargos adicionales a los eventos de datos. Para obtener más información sobre CloudTrail los precios, consulta [AWS CloudTrail Precios](https://aws.amazon.com/cloudtrail/pricing/).
Puede registrar eventos de datos para los tipos de recursos de SNS mediante la CloudTrail consola o las operaciones de la CloudTrail API. AWS CLI Para obtener más información sobre cómo registrar los eventos de datos, consulte [Registro de eventos de datos con la Consola de administración de AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console) y [Registro de eventos de datos con la AWS Command Line Interface](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI) en la *Guía del usuario de AWS CloudTrail *.
En la siguiente tabla se muestran los tipos de recursos de SNS para los que puede registrar eventos de datos. La columna **Tipo de evento de datos (consola)** muestra el valor que se puede elegir en la lista de **tipos de eventos de datos** de la CloudTrail consola. La columna de **valores resources.type** muestra el `resources.type` valor que se debe especificar al configurar los selectores de eventos avanzados mediante o. AWS CLI CloudTrail APIs La CloudTrail columna **Datos APIs registrados muestra las llamadas a** la API registradas CloudTrail para el tipo de recurso.
| Tipo de evento de datos (consola) | resources.type value | Datos APIs registrados en CloudTrail |
| --- | --- | --- |
| Tema de SNS | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sns/latest/dg/logging-using-cloudtrail.html) |
| Punto de conexión de la plataforma de SNS | AWS::SNS::PlatformEndpoint | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sns/latest/dg/logging-using-cloudtrail.html) |
**nota**
El tipo de recurso SNS no `AWS::SNS::PhoneNumber` está registrado por CloudTrail.
Puede configurar selectores de eventos avanzados para filtrar según los campos `eventName`, `readOnly` y `resources.ARN` y así registrar solo los eventos que son importantes para usted. Para obtener más información acerca de estos campos, consulte [https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html) en la *Referencia de la API de AWS CloudTrail *.
Para obtener información sobre el registro de eventos de datos, consulte Registrar eventos de datos con el Consola de administración de AWS y Registrar eventos de datos con el AWS CLI en la Guía del CloudTrail usuario.
## Eventos de administración de SNS en CloudTrail
[Los eventos de administración](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) proporcionan información sobre las operaciones de administración que se realizan en los recursos de su Cuenta de AWS empresa. Se denominan también operaciones del plano de control. De forma predeterminada, CloudTrail registra los eventos de administración.
AWS El SNS registra las siguientes operaciones del plano de control del SNS CloudTrail como eventos *de administración*.
+ `[AddPermission](https://docs.aws.amazon.com/sns/latest/api/API_AddPermission.html)`
+ `[CheckIfPhoneNumberIsOptedOut](https://docs.aws.amazon.com/sns/latest/api/API_CheckIfPhoneNumberIsOptedOut.html)`
+ `[ConfirmSubscription](https://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)`
+ `[CreatePlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)`
+ `[CreatePlatformEndpoint](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)`
+ `[CreateSMSSandboxPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_CreateSMSSandboxPhoneNumber.html)`
+ `[CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)`
+ `[DeleteEndpoint](https://docs.aws.amazon.com/sns/latest/api/API_DeleteEndpoint.html)`
+ `[DeletePlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_DeletePlatformApplication.html)`
+ `[DeleteSMSSandboxPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_DeleteSMSSandboxPhoneNumber.html)`
+ `[DeleteTopic](https://docs.aws.amazon.com/sns/latest/api/API_DeleteTopic.html)`
+ `[GetDataProtectionPolicy](https://docs.aws.amazon.com/sns/latest/api/API_GetDataProtectionPolicy.html)`
+ `[GetEndpointAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetEndpointAttributes.html)`
+ `[GetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)`
+ `[GetSMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSMSAttributes.html)`
+ `[GetSMSSandboxAccountStatus](https://docs.aws.amazon.com/sns/latest/api/API_GetSMSSandboxAccountStatus.html)`
+ `[GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)`
+ `[GetTopicAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetTopicAttributes.html)`
+ `[ListEndpointsByPlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)`
+ `[ListOriginationNumbers](https://docs.aws.amazon.com/sns/latest/api/API_ListOriginationNumbers.html)`
+ `[ListPhoneNumbersOptedOut](https://docs.aws.amazon.com/sns/latest/api/API_ListPhoneNumbersOptedOut.html)`
+ `[ListPlatformApplications](https://docs.aws.amazon.com/sns/latest/api/API_ListPlatformApplications.html)`
+ `[ListSMSSandboxPhoneNumbers](https://docs.aws.amazon.com/sns/latest/api/API_ListSMSSandboxPhoneNumbers.html)`
+ `[ListSubscriptions](https://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptions.html)`
+ `[ListSubscriptionsByTopic](https://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptionsByTopic.html)`
+ `[ListTagsForResource](https://docs.aws.amazon.com/sns/latest/api/API_ListTagsForResource.html)`
+ `[ListTopics](https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html)`
+ `[OptInPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_OptInPhoneNumber.html)`
+ `[PutDataProtectionPolicy](https://docs.aws.amazon.com/sns/latest/api/API_PutDataProtectionPolicy.html)`
+ `[RemovePermission](https://docs.aws.amazon.com/sns/latest/api/API_RemovePermission.html)`
+ `[SetEndpointAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetEndpointAttributes.html)`
+ `[SetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)`
+ `[SetSMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSMSAttributes.html)`
+ `[SetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSubscriptionAttributes.html)`
+ `[SetTopicAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html)`
+ `[Subscribe](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)`
+ `[TagResource](https://docs.aws.amazon.com/sns/latest/api/API_TagResource.html)`
+ `[Unsubscribe](https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)`
+ `[UntagResource](https://docs.aws.amazon.com/sns/latest/api/API_UntagResource.html)`
+ `[VerifySMSSandboxPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_VerifySMSSandboxPhoneNumber.html)`
**nota**
Si no ha iniciado sesión en Amazon Web Services (modo no autenticado) y se invocan [https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html](https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)las acciones [https://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html](https://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)o, no se iniciará sesión en ellas. CloudTrail Por ejemplo, al elegir el vínculo proporcionado en una notificación por correo electrónico para confirmar la suscripción pendiente en un tema, se invoca la acción `ConfirmSubscription` en modo sin autenticar. En este ejemplo, no se registraría la `ConfirmSubscription` acción. CloudTrail
## Ejemplos de eventos de SNS
Un evento representa una solicitud única de cualquier fuente e incluye información sobre la operación de API solicitada, la fecha y la hora de la operación, los parámetros de la solicitud, etc. CloudTrail Los archivos de registro no son un registro ordenado de las llamadas a la API pública, por lo que los eventos no aparecen en ningún orden específico.
El siguiente ejemplo muestra un CloudTrail evento que demuestra **`ListTopics`**`CreateTopic`las `DeleteTopic` acciones y.
```
{
"Records": [
{
"eventVersion": "1.02",
"userIdentity": {
"type": "IAMUser",
"userName": "Bob",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE"
},
"eventTime": "2014-09-30T00:00:00Z",
"eventSource": "sns.amazonaws.com",
"eventName": "ListTopics",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version",
"requestParameters": {
"nextToken": "ABCDEF1234567890EXAMPLE=="
},
"responseElements": null,
"requestID": "example1-b9bb-50fa-abdb-80f274981d60",
"eventID": "example0-09a3-47d6-a810-c5f9fd2534fe",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
},
{
"eventVersion": "1.02",
"userIdentity": {
"type": "IAMUser",
"userName": "Bob",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE"
},
"eventTime": "2014-09-30T00:00:00Z",
"eventSource": "sns.amazonaws.com",
"eventName": "CreateTopic",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version",
"requestParameters": {
"name": "hello"
},
"responseElements": {
"topicArn": "arn:aws:sns:us-west-2:123456789012:hello-topic"
},
"requestID": "example7-5cd3-5323-8a00-f1889011fee9",
"eventID": "examplec-4f2f-4625-8378-130ac89660b1",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
},
{
"eventVersion": "1.02",
"userIdentity": {
"type": "IAMUser",
"userName": "Bob",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE"
},
"eventTime": "2014-09-30T00:00:00Z",
"eventSource": "sns.amazonaws.com",
"eventName": "DeleteTopic",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version",
"requestParameters": {
"topicArn": "arn:aws:sns:us-west-2:123456789012:hello-topic"
},
"responseElements": null,
"requestID": "example5-4faa-51d5-aab2-803a8294388d",
"eventID": "example8-6443-4b4d-abfd-1b867280d964",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
}
]
}
```
El siguiente ejemplo muestra un CloudTrail evento que demuestra la `Publish` acción.
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AKIAIOSFODNN7EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "ExampleUser"
},
"attributes": {
"creationDate": "2023-08-21T16:44:05Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2023-08-21T16:48:37Z",
"eventSource": "sns.amazonaws.com",
"eventName": "Publish",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
"requestParameters": {
"topicArn": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic",
"message": "HIDDEN_DUE_TO_SECURITY_REASONS",
"subject": "HIDDEN_DUE_TO_SECURITY_REASONS",
"messageStructure": "json",
"messageAttributes": "HIDDEN_DUE_TO_SECURITY_REASONS"
},
"responseElements": {
"messageId": "0787cd1e-d92b-521c-a8b4-90434e8ef840"
},
"requestID": "0a8ab208-11bf-5e01-bd2d-ef55861b545d",
"eventID": "bb3496d4-5252-4660-9c28-3c6aebdb21c0",
"readOnly": false,
"resources": [
{
"accountId": "123456789012",
"type": "AWS::SNS::Topic",
"ARN": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic"
}
],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "123456789012",
"eventCategory": "Data",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"clientProvidedHostHeader": "sns.us-east-1.amazonaws.com"
}
}
```
El siguiente ejemplo muestra un CloudTrail evento que demuestra la `PublishBatch` acción.
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AKIAIOSFODNN7EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "ExampleUser"
},
"attributes": {
"creationDate": "2023-08-21T19:20:49Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2023-08-21T19:22:01Z",
"eventSource": "sns.amazonaws.com",
"eventName": "PublishBatch",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
"requestParameters": {
"topicArn": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic",
"publishBatchRequestEntries": [
{
"id": "1",
"message": "HIDDEN_DUE_TO_SECURITY_REASONS"
},
{
"id": "2",
"message": "HIDDEN_DUE_TO_SECURITY_REASONS"
}
]
},
"responseElements": {
"successful": [
{
"id": "1",
"messageId": "30d68101-a64a-5573-9e10-dc5c1dd3af2f"
},
{
"id": "2",
"messageId": "c0aa0c5c-561d-5455-b6c4-5101ed84de09"
}
],
"failed": []
},
"requestID": "e2cdf7f3-1b35-58ad-ac9e-aaaea0ace2f1",
"eventID": "10da9a14-0154-4ab6-b3a5-1825b229a7ed",
"readOnly": false,
"resources": [
{
"accountId": "123456789012",
"type": "AWS::SNS::Topic",
"ARN": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic"
}
],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "123456789012",
"eventCategory": "Data",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"clientProvidedHostHeader": "sns.us-east-1.amazonaws.com"
}
}
```
Para obtener información sobre el contenido de los CloudTrail registros, consulte el [contenido de los CloudTrail registros](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html) en la *Guía del AWS CloudTrail usuario*.
# Supervisión de temas de Amazon SNS mediante CloudWatch
Amazon SNS y Amazon CloudWatch están integrados para que pueda recopilar, ver y analizar las métricas de cada notificación de Amazon SNS activa. Una vez que haya configurado CloudWatch Amazon SNS, podrá obtener una mejor visión del rendimiento de los temas, las notificaciones push y las entregas de SMS de Amazon SNS. Por ejemplo, puede configurar una alarma que le envíe una notificación por correo electrónico si se llega a un umbral especificado en una métrica de Amazon SNS, como `NumberOfNotificationsFailed`. Para obtener una lista de todas las métricas a las que envía Amazon SNS CloudWatch, consulte. [Métricas de Amazon SNS](#sns-metrics) Para obtener más información sobre las notificaciones push de Amazon SNS, consulte [Envío de notificaciones push para móvil con Amazon SNS](sns-mobile-application-as-subscriber.md).
**nota**
Las métricas que configure CloudWatch para sus temas de Amazon SNS se recopilan y actualizan automáticamente a CloudWatch intervalos de *1* minuto. Estas métricas se recopilan sobre todos los temas que cumplen con las CloudWatch pautas para mantenerse activo. Un tema se considera activo hasta seis horas después de la última actividad (es decir, cualquier llamada a la API) sobre el tema. CloudWatch
Las métricas de Amazon SNS incluidas en las que se informa son gratuitas CloudWatch; se proporcionan como parte del servicio Amazon SNS.
## Ver CloudWatch las métricas de Amazon SNS
Puede supervisar las métricas de Amazon SNS mediante la CloudWatch consola, la propia interfaz CloudWatch de línea de comandos (CLI) o mediante programación mediante la API. CloudWatch Los procedimientos siguientes muestran cómo aceptar las métricas mediante la Consola de administración de AWS.
**Para ver las métricas mediante la consola CloudWatch**
1. Inicie sesión en la [consola de CloudWatch](https://console.aws.amazon.com/cloudwatch).
1. En el panel de navegación, elija **Metrics**.
1. En la pestaña **All metrics (Todas las métricas)**, elija **SNS** y, a continuación, elija una de las dimensiones siguientes:
+ **Country, SMS Type (País, tipo de SMS)**
+ **PhoneNumber**
+ **Topic Metrics (Métricas del tema)**
+ **Metrics with no dimensions (Métricas sin dimensiones)**
1. Para ver más detalles, elija un elemento específico. Por ejemplo, si elige **Métricas de tema** y, a continuación **NumberOfMessagesPublished**, elige, se mostrará el número medio de mensajes de Amazon SNS publicados durante un período de 1 minuto en un intervalo de tiempo de 6 horas.
1. Para ver las métricas de uso de Amazon SNS, en la pestaña **All metrics** (Todas las métricas), elija **Usage** (Uso) y seleccione una opción en **Target Amazon SNS usage metric** (Métrica de uso de Amazon SNS de destino) (por ejemplo, `NumberOfMessagesPublishedPerAccount`).
## Configurar CloudWatch alarmas para las métricas de Amazon SNS
CloudWatch también permite configurar alarmas cuando se alcanza un umbral para una métrica. Por ejemplo, puede configurar una alarma para la métrica **NumberOfNotificationsFailed**, de modo que, cuando se alcance el umbral especificado dentro del período de muestreo, se le envíe una notificación por correo electrónico para informarle del evento.
**Para configurar las alarmas mediante la CloudWatch consola**
1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Elija **Alarms (Alarmas)** y, a continuación, seleccione el botón **Create Alarm (Crear alarma)**. Esto lanzará el asistente **Create Alarm (Crear alarma)**.
1. Desplácese por las métricas de Amazon SNS para localizar la métrica en la que desea colocar una alarma. Seleccione la métrica para crear una alarma y elija **Continue (Continuar)**.
1. Rellene los valores **Name (Nombre)**, **Description (Descripción)**, **Threshold (Umbral)** y **Time (Fecha y hora)** de la métrica y elija **Continue (Continuar)**.
1. Elija **Alarm (Alarma)** como estado de alarma. Si CloudWatch quieres enviarte un correo electrónico cuando se alcance el estado de alarma, selecciona un tema existente de Amazon SNS o selecciona **Crear nuevo tema de correo electrónico**. Si elige **Create New Email Topic (Crear nuevo tema de correo electrónico)**, puede definir el nombre y las direcciones de correo electrónico de un tema nuevo. Esta lista se guardará y aparecerá en el cuadro desplegable para futuras alarmas. Elija **Continuar**.
**nota**
Si utiliza **Crear nuevo tema de correo electrónico** para crear un tema nuevo de Amazon SNS, deberá verificar las direcciones de correo electrónico para que puedan recibir las notificaciones. Los correos electrónicos solo se envían cuando la alarma entra en estado de alarma. Si este cambio en el estado de la alarma se produce antes de que se verifiquen las direcciones de correo electrónico, no recibirá una notificación.
1. En este momento, el asistente **Create Alarm (Crear alarma)** le da la oportunidad de revisar la alarma que está a punto de crear. Si necesita hacer algún cambio, puede utilizar los enlaces **Edit (Editar)** de la derecha. Cuando esté satisfecho, elija **Create Alarm (Crear alarma)**.
Para obtener más información sobre el uso CloudWatch y las alarmas, consulte la [CloudWatchdocumentación](https://aws.amazon.com/documentation/cloudwatch).
## Métricas de Amazon SNS
Amazon SNS envía las siguientes métricas a. CloudWatch
| Namespace | Métrica | Description (Descripción) |
| --- | --- | --- |
| AWS/SNS | NumberOfMessagesPublished | La cantidad de mensajes publicados en los temas de Amazon SNS. **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum |
| AWS/SNS | NumberOfNotificationsDelivered | La cantidad de mensajes entregados de forma correcta desde los temas de Amazon SNS a los puntos de enlace suscritos. Para que un intento de entrega se lleve a cabo correctamente, la suscripción del punto de enlace debe aceptar el mensaje. En una suscripción, se acepta un mensaje si a.) carece de una política de filtro o b.) su política de filtro incluye atributos que coinciden con los asignados al mensaje. Si la suscripción rechaza el mensaje, el intento de entrega no se tiene en cuenta para esta métrica. **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum |
| AWS/SNS | NumberOfNotificationsFailed | La cantidad mensajes que Amazon SNS no pudo entregar. En el caso de Amazon SQS, correo electrónico, SMS o puntos de enlace push móviles, la métrica aumenta en 1 cuando Amazon SNS deja de intentar la entrega de mensajes. En los puntos de enlace HTTP o HTTPS, la métrica incluye todos los intentos de entrega erróneos, incluidos los intentos repetidos que siguen al intento inicial. Para todos los demás puntos de enlace, el recuento aumenta en 1 cuando no se logra entregar el mensaje (independientemente del número de intentos). Esta métrica no incluye los mensajes que han rechazado las políticas de filtro de suscripciones. Puede controlar el número de reintentos para los puntos de enlace HTTP. Para obtener más información, consulte [Reintento de entrega de mensajes de Amazon SNS](sns-message-delivery-retries.md). **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum, Average |
| AWS/SNS | NumberOfNotificationsFilteredOut | El número de mensajes que han rechazado las políticas de filtro de suscripciones. Una política de filtro rechaza un mensaje si los atributos de este no coinciden con los atributos de la política. **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum, Average |
| AWS/SNS | NumberOfNotificationsFilteredOut-MessageAttributes | El número de mensajes rechazados por las políticas de filtrado de suscripciones para el filtrado basado en atributos. **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum, Average |
| AWS/SNS | NumberOfNotificationsFilteredOut-MessageBody | El número de mensajes rechazados por las políticas de filtrado de suscripciones para el filtrado basado en cargas. **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum, Average |
| AWS/SNS | NumberOfNotificationsFilteredOut-InvalidAttributes | La cantidad de mensajes que han rechazado las políticas de filtro de suscripciones debido a que los atributos de los mensajes no son válidos, por ejemplo, porque el atributo JSON tiene un formato incorrecto. **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum, Average |
| AWS/SNS | NumberOfNotificationsFilteredOut-NoMessageAttributes | El número de mensajes que han rechazado las políticas de filtro de suscripciones debido a que los mensajes no tienen atributos. **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum, Average |
| AWS/SNS | NumberOfNotificationsFilteredOut-InvalidMessageBody | La cantidad de mensajes que han rechazado las políticas de filtro de suscripciones debido a que el cuerpo del mensaje no es válido para el filtro, por ejemplo, cuerpo del mensaje JSON no válido. **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum, Average |
| AWS/SNS | NumberOfNotificationsRedrivenToDlq | Número de mensajes que se han movido a una cola de mensajes fallidos. **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum, Average |
| AWS/SNS | NumberOfNotificationsFailedToRedriveToDlq | Número de mensajes que no se pudieron mover a una cola de mensajes fallidos. **Unidades**: recuento **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Sum, Average |
| AWS/SNS | PublishSize | El tamaño de los mensajes publicados. **Unidades:** Bytes **Dimensiones válidas:** aplicación PhoneNumber, plataforma y TopicName **Estadísticas válidas:** Minimum, Maximum, Average y Count |
| AWS/SNS | SMSMonthToDateSpentUSD | Los cargos que se han acumulado desde el principio del mes actual por enviar mensajes SMS. Puedes configurar una alarma para esta métrica para saber si tus month-to-date cargos se acercan a la cuota mensual de gastos de SMS de tu cuenta. Cuando Amazon SNS determina que el envío de un mensaje SMS generaría un costo que supera esta cuota, deja de publicar mensajes SMS en cuestión de minutos. Para obtener información acerca de la configuración de su cuota de gasto mensual de SMS o acerca de cómo solicitar un aumento de la cuota de gasto en AWS, consulte [Configuración de las preferencias de mensajería SMS en Amazon SNS](sms_preferences.md). **Unidades:** USD **Dimensiones válidas:** None **Estadísticas válidas:** Sum |
| AWS/SNS | SMSSuccessRate | El número de entregas de mensajes SMS realizadas correctamente. **Unidades**: recuento **Dimensiones válidas:** PhoneNumber **Estadísticas válidas:** Sum, Average, Data Samples |
## Dimensiones de las métricas de Amazon SNS
Amazon Simple Notification Service envía las siguientes dimensiones a CloudWatch.
| Dimensión | Description (Descripción) |
| --- | --- |
| Application | Filtra los objetos de la aplicación, que representan una aplicación y un dispositivo registrados en uno de los servicios de notificaciones push compatibles, como APNs FCM. |
| Application,Platform | Filtra los objetos de aplicación y plataforma, donde los objetos de plataforma son para los servicios de notificaciones push compatibles, como APNs FCM. |
| Country | Filtra por el país o la región de destino de un mensaje SMS. El país o la región se representa mediante su código alpha-2 ISO 3166-1. |
| PhoneNumber | Filtra el número de teléfono cuando publica SMS de forma directa en un número de teléfono (sin tema). |
| Platform | Filtra los objetos de plataforma para los servicios de notificaciones push, como APNs FCM. |
| TopicName | Filtra por nombres de temas de Amazon SNS. |
| SMSType | Filtra por el tipo de mensaje de un mensaje SMS. Puede ser *promotional* o *transactional*. |
## Métricas de uso de Amazon SNS
Amazon Simple Notification Service envía las siguientes métricas de uso a CloudWatch.
| Namespace | Servicio | Métrica | Recurso | Tipo | Description (Descripción) |
| --- | --- | --- | --- | --- | --- |
| AWS/Uso | SNS | ResourceCount | NumberOfMessagesPublishedPerAccount | Recurso | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Uso | SNS | ResourceCount | ApproximateNumberOfTopics | Recurso | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Uso | SNS | ResourceCount | ApproximateNumberOfFilterPolicies | Recurso | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Uso | SNS | ResourceCount | ApproximateNumberOfPendingSubscriptions | Recurso | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Uso | SNS | CallCount | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sns/latest/dg/sns-monitoring-using-cloudwatch.html) | API | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |