Conecta Amazon Simple Notification Service (SNS) a Datadog para:
- Visualizar mensajes SNS como eventos en tu Explorador de eventos
- Enviar alertas y notificaciones de eventos a SNS
Configuración
Instalación
Si aún no lo has hecho, configura primero la integración de Amazon Web Services.
Recopilación de métricas
En la página de la integración de AWS, asegúrate de que SES está habilitado en la pestaña Metric Collection.
Añade los siguientes permisos a tu política de IAM de Datadog para poder recopilar métricas de Amazon SNS. Para obtener más información, consulta las Políticas de SNS en el sitio web de AWS.
| Permiso de AWS | Descripción |
|---|
sns:ListTopics | Se utiliza para enumerar los temas disponibles. |
sns:Publish | Se utiliza para publicar notificaciones (monitores o feed de eventos). |
Instala la integración de Datadog y Amazon SNS.
Recopilación de eventos
Recepción de mensajes SNS
Puedes recibir mensajes SNS en el Datadog Event Explorer a través de los protocolos HTTPS y Email. El uso del protocolo HTTPS permite confirmar automáticamente la suscripción con una URL de webhook.
El uso del protocolo Email requiere un paso de confirmación manual para la dirección de correo electrónico que Datadog genera automáticamente para este fin. Lee la guía Crear eventos de Datadog a partir de correos electrónicos de Amazon SNS para obtener más información.
Para recibir mensajes SNS en el Explorador de eventos de Datadog a través de HTTPS:
En la sección Temas de la consola de gestión de SNS, selecciona el tema deseado y haz clic en Create Subscription (Crear suscripción).
Selecciona HTTPS como protocolo e introduce la siguiente URL de webhook, sustituyendo <API_KEY> por el valor de cualquier clave de API Datadog válida:
## Datadog US site
https://app.datadoghq.com/intake/webhook/sns?api_key=<API_KEY>
## Datadog EU site
https://app.datadoghq.eu/intake/webhook/sns?api_key=<API_KEY>
Deja sin marcar la casilla Habilitar la entrega de mensajes sin procesar.
Haz clic en Create Subscription (Crear suscripción).
Envío de notificaciones SNS
Para enviar notificaciones SNS desde Datadog:
- Configura la cuenta AWS que está asociada a un servicio SNS en la página de la integración AWS.
- Instala la integración de SNS.
- A continuación, Datadog detecta los temas SNS configurados y habilita @notificaciones, por ejemplo:
@sns-topic-name.
Recopilación de logs
SNS no proporciona logs. Procesa los logs y los eventos que transitan por SNS.
Enviar logs a Datadog
- Configurar una nueva suscripción SNS.
- Selecciona el tema del que proceden los mensajes.
- Para el protocolo, selecciona AWS Lambda.
- Para el Endpoint, introduce el ARN de tu función Lambda del Datadog Forwarder.
Datos recopilados
Métricas
| |
|---|
aws.sns.dwell_time
(gauge) | Tiempo esperado por un mensaje antes de ser entregado.
Se muestra como milisegundo |
aws.sns.number_of_messages_published
(count) | Número de mensajes publicados.
Se muestra como mensaje |
aws.sns.number_of_notifications_delivered
(count) | Número de mensajes entregados con éxito.
Se muestra como mensaje |
aws.sns.number_of_notifications_failed
(count) | Número de mensajes que el SNS no ha podido entregar.
Se muestra como mensaje |
aws.sns.number_of_notifications_filtered_out
(count) | Número de mensajes rechazados por las políticas de filtrado de suscripciones. Una política de filtrado rechaza un mensaje cuando los atributos del mensaje no coinciden con los atributos de la política.
Se muestra como mensaje |
aws.sns.number_of_notifications_filtered_out_invalid_attributes
(count) | Número de mensajes rechazados por las políticas de filtrado de suscripciones porque los mensajes no tienen atributos.
Se muestra como mensaje |
aws.sns.number_of_notifications_filtered_out_no_message_attributes
(count) | Número de mensajes rechazados por las políticas de filtrado de suscripciones. Una política de filtrado rechaza un mensaje cuando los atributos del mensaje no coinciden con los atributos de la política.
Se muestra como mensaje |
aws.sns.publish_size
(gauge) | Tamaño de los mensajes publicados.
Se muestra como byte |
aws.sns.smssuccess_rate
(gauge) | El porcentaje de sms entregados con éxito.
Se muestra como porcentaje |
A cada una de las métricas recuperadas de AWS se le asignan las mismas etiquetas (tags) que aparecen en la consola de AWS, incluidos, entre otros, el nombre del host y los grupos de seguridad.
Eventos
La integración Amazon SNS incluye eventos para suscripciones a temas. Consulta el siguiente ejemplo de evento:
Checks de servicio
La integración Amazon SNS no incluye checks de servicios.
Solucionar problemas
Datadog no admite notificaciones SNS de Datadog a temas en China.
¿Necesitas ayuda? Ponte en contacto con el soporte de Datadog.
