Trabajo con eventos y notificaciones de Amazon SNS en AWS Database Migration Service - AWS Database Migration Service

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.

Trabajo con eventos y notificaciones de Amazon SNS en AWS Database Migration Service

A partir de la versión de AWS DMS 3.4.5 y versiones más recientes, le recomendamos que utilice Amazon EventBridge para proporcionar notificaciones cuando se produzca un evento de AWS DMS. Para obtener más información acerca del uso de eventos de EventBridge con AWS DMS, consulte Trabajo con eventos y notificaciones de Amazon EventBridge en AWS Database Migration Service.

Traslado de las suscripciones de eventos a Amazon EventBridge

Puede usar el siguiente comando de la AWS CLI para migrar las suscripciones de eventos activas de DMS a Amazon EventBridge, hasta 10 a la vez.

update-subscriptions-to-event-bridge [--force-move | --no-force-move]

De forma predeterminada, AWS DMS solo migra las suscripciones de eventos activas cuando la instancia de replicación esté actualizada con la versión de AWS DMS 3.4.5 o superiores. Para invalidar este comportamiento predeterminado, utilice la opción --force-move. Sin embargo, es posible que algunos tipos de eventos no estén disponibles con Amazon EventBridge si las instancias de replicación no están actualizadas.

Para ejecutar el comando de la CLI update-subscriptions-to-event-bridge , un usuario de AWS Identity and Access Management (IAM) debe tener los siguientes permisos de política.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "SNS:GetTopicAttributes", "SNS:SetTopicAttributes", "events:PutTargets", "events:EnableRule", "events:PutRule" ], "Resource": "*" } ] }

Para obtener más información sobre cómo mover las suscripciones a EventBridge, consulte UpdateSubscriptionsToEventBridge en la Referencia de la API de AWS Database Migration Service.

Trabajo con eventos y notificaciones de Amazon SNS

Las versiones 3.4.5 y anteriores de AWS DMS permiten trabajar con eventos y notificaciones, tal y como se describe a continuación.

AWS Database Migration Service (AWS DMS) puede utilizar Amazon Simple Notification Service (Amazon SNS) para enviar notificaciones cuando se produzca un evento de AWS DMS, por ejemplo, la creación o eliminación de una instancia de replicación. Puede trabajar con estas notificaciones de cualquier forma que admita Amazon SNS para una región de AWS como, por ejemplo, un mensaje de correo electrónico, un mensaje de texto o una llamada a un punto de conexión HTTP.

AWS DMS agrupa los eventos en categorías a las que puede suscribirse para recibir una notificación cada vez que se produzca un evento en esa categoría. Por ejemplo, si se suscribe a la categoría de creación de una instancia de replicación determinada, recibirá una notificación cada vez que se produzca un evento relacionado con la creación y que afecte a su instancia de replicación. Si se suscribe a una categoría de cambios de configuración de una instancia de replicación, recibirá una notificación cada vez que cambie la configuración de la instancia de replicación. También recibirá una notificación cuando cambie una suscripción de notificación de eventos. Para obtener una lista de las categorías de evento proporcionada por AWS DMS, consulte Mensajes de categorías y eventos de AWS DMS para notificaciones de SNS más adelante.

AWS DMS envía notificaciones de eventos a las direcciones que proporcione al crear un evento de suscripción. Es posible que le interese crear diferentes suscripciones, como una suscripción que reciba todas las notificaciones de eventos y otra suscripción que incluya únicamente los eventos esenciales para sus recursos DMS de producción. Puede desactivar la notificación fácilmente sin eliminar una suscripción anulando la selección de la opción Habilitada en la consola de AWS DMS o estableciendo el parámetro Enabled en falso con la API de AWS DMS.

nota

Las notificaciones de eventos de AWS DMS que utilizan mensajes de texto SMS están disponibles actualmente para los recursos de AWS DMS en todas las regiones de AWS donde se admite Amazon SNS. Para ver una lista de regiones y países de AWS en los que Amazon SNS admite la mensajería SMS, consulte Regiones y países compatibles.

Para obtener más información sobre cómo utilizar mensajes de texto con SNS, consulte Envío y recepción de notificaciones por SMS con Amazon SNS.

Las notificaciones de eventos de AWS DMS difieren de los eventos de CloudTrail en CloudWatch o EventBridge. Las notificaciones de eventos de CloudTrail se pueden generar mediante cualquier invocación a la API. DMS envía una notificación solo cuando se produce un evento del DMS.

AWS DMS utiliza un identificador de suscripción para identificar cada suscripción. Puede tener varias suscripciones de eventos de AWS DMS publicadas en el mismo tema de Amazon SNS. Al utilizar la notificación de eventos, se aplican las tarifas de Amazon SNS. Para obtener más información sobre la facturación de Amazon SNS, consulte Precios de Amazon SNS.

Para suscribirse a eventos de AWS DMS con Amazon SNS, utilice el siguiente proceso:

  1. Cree un tema de Amazon SNS. En el tema, especifique el tipo de notificación que desea recibir y a qué dirección o número se envía la notificación.

  2. Cree una suscripción a notificaciones de eventos de AWS DMS mediante la AWS Management Console, AWS CLI o API de AWS DMS.

  3. AWS DMS envía un mensaje de correo electrónico o SMS de aprobación a las direcciones que envió con la suscripción. Para confirmar la suscripción, haga clic en el enlace del correo electrónico o mensaje SMS de aprobación.

  4. Cuando haya confirmado la suscripción, el estado de la suscripción se actualizará en la sección suscripciones de eventos de la consola de AWS DMS.

  5. Seguidamente, empezará a recibir notificaciones de eventos.

Para conocer la lista de categorías y eventos que puede recibir en las notificaciones, consulte la siguiente sección. Para obtener más información sobre cómo suscribirse y trabajar con las suscripciones a eventos de AWS DMS, consulte Suscripción a la notificación de eventos de AWS DMS mediante SNS.

Temas

    Mensajes de categorías y eventos de AWS DMS para notificaciones de SNS

    importante

    A partir de la versión de AWS DMS 3.4.5 y versiones más recientes, le recomendamos que utilice Amazon EventBridge para proporcionar notificaciones cuando se produzca un evento de AWS DMS. Para obtener más información acerca del uso de eventos de EventBridge con AWS DMS, consulte Trabajo con eventos y notificaciones de Amazon EventBridge en AWS Database Migration Service.

    AWS DMS genera un número significativo de eventos en categorías a las que puede suscribirse a través de la consola de AWS DMS o la API de AWS DMS. Cada categoría se aplica a un tipo de origen. Actualmente, AWS DMS es compatible con los tipos de origen de instancia de replicación y tarea de replicación.

    En la siguiente tabla se desglosan las posibles categorías y eventos del tipo de origen instancia de replicación.

    Categoría

    ID de evento de DMS

    Descripción

    Cambio de configuración DMS-EVENT-0012

    Se está cambiando la clase de instancia de replicación de esta instancia de replicación.

    Cambio de configuración DMS-EVENT-0014

    Se ha cambiado la clase de instancia de replicación de esta instancia de replicación.

    Cambio de configuración DMS-EVENT-0018

    Se está aumentando el almacenamiento de la instancia de replicación.

    Cambio de configuración DMS-EVENT-0017

    Se ha aumentado el almacenamiento de la instancia de replicación.

    Cambio de configuración DMS-EVENT-0024

    La instancia de replicación está pasando a una configuración Multi-AZ.

    Cambio de configuración DMS-EVENT-0025

    La instancia de replicación ha terminado de pasar a una configuración Multi-AZ.

    Cambio de configuración DMS-EVENT-0030

    La instancia de replicación está pasando a una configuración de Single-AZ.

    Cambio de configuración DMS-EVENT-0029

    La instancia de replicación ha terminado de pasar a una configuración Single-AZ.

    Creación DMS-EVENT-0067

    Se ha creado una instancia de replicación.

    Creación DMS-EVENT-0005

    Se ha creado una instancia de replicación.

    Eliminación DMS-EVENT-0066

    Se está eliminando la instancia de replicación.

    Eliminación DMS-EVENT-0003

    Se ha eliminado la instancia de replicación.

    Mantenimiento DMS-EVENT-0047 Se ha actualizado el software de administración de la instancia de replicación.
    Mantenimiento DMS-EVENT-0026 Se está realizando el mantenimiento sin conexión de la instancia de replicación. La instancia de replicación no está disponible en este momento.
    Mantenimiento DMS-EVENT-0027 Ha finalizado el mantenimiento sin conexión de la instancia de replicación. La instancia de replicación ya está disponible.
    Mantenimiento DMS-EVENT-0068 Una instancia de replicación se encuentra en un estado que no se puede actualizar.
    Poco almacenamiento disponible DMS-EVENT-0007 La instancia de replicación ha consumido más del 90 % del almacenamiento asignado. El espacio de almacenamiento de una instancia de replicación se puede monitorear con la métrica de espacio de almacenamiento libre.
    Conmutación por error DMS-EVENT-0013 Se ha iniciado la conmutación por error para una instancia de replicación de Multi-AZ.
    Conmutación por error DMS-EVENT-0049 La conmutación por error está completa para una instancia de replicación Multi-AZ.
    Conmutación por error DMS-EVENT-0015 La conmutación por error Multi-AZ al modo de espera está completa.
    Conmutación por error DMS-EVENT-0050 Ha comenzado la activación Multi-AZ.
    Conmutación por error DMS-EVENT-0051 Se ha completado la activación de Multi-AZ.
    Conmutación por error DMS-EVENT-0034 Si solicita la conmutación por error con demasiada frecuencia, este evento se produce en lugar de los eventos de conmutación por error habituales.
    Error DMS-EVENT-0031 Se ha producido un error de almacenamiento en la instancia de replicación.
    Error DMS-EVENT-0036 La instancia de replicación ha producido un error debido a una incompatibilidad de red.
    Error DMS-EVENT-0037 El servicio no puede acceder a la clave de AWS KMS utilizada para cifrar el volumen de datos.

    En la siguiente tabla se desglosan las posibles categorías y eventos del tipo de origen tarea de replicación.

    Categoría

    ID de evento de DMS

    Descripción

    Cambio de estado DMS-EVENT-0069

    Se ha iniciado la tarea de replicación.

    Cambio de estado DMS-EVENT-0081

    Se ha solicitado una recarga de los detalles de la tabla.

    Cambio de estado DMS-EVENT-0079

    Se ha detenido la tarea de replicación.

    Cambio de estado DMS-EVENT-0091 La lectura se ha detenido, se ha alcanzado el límite de archivos de intercambio.
    Cambio de estado DMS-EVENT-0092 La lectura se ha detenido, se ha alcanzado el límite de uso del disco.
    Cambio de estado DMS-EVENT-0093 Se ha reanudado la lectura.
    Error DMS-EVENT-0078

    Se ha producido un error en la tarea de replicación.

    Error DMS-EVENT-0082

    Una llamada para eliminar la tarea no ha podido limpiar los datos de la tarea.

    Cambio de configuración DMS-EVENT-0080 Se ha modificado la tarea de replicación.
    Eliminación DMS-EVENT-0073

    Se ha eliminado la tarea de replicación.

    Creación DMS-EVENT-0074 Se ha creado la tarea de replicación.

    El siguiente ejemplo muestra una suscripción a un evento de AWS DMS con la categoría Cambio de estado.

    Resources: DMSEvent: Type: AWS::DMS::EventSubscription Properties: Enabled: true EventCategories: State Change SnsTopicArn: arn:aws:sns:us-east-1:123456789:testSNS SourceIds: [] SourceType: replication-task

    Suscripción a la notificación de eventos de AWS DMS mediante SNS

    importante

    A partir de la versión de AWS DMS 3.4.5 y versiones más recientes, le recomendamos que utilice Amazon EventBridge para proporcionar notificaciones cuando se produzca un evento de AWS DMS. Para obtener más información acerca del uso de eventos de EventBridge con AWS DMS, consulte Trabajo con eventos y notificaciones de Amazon EventBridge en AWS Database Migration Service.

    Puede crear una suscripción de notificación de eventos de AWS DMS para recibir notificaciones cada vez que se produzca un evento de AWS DMS. La forma más sencilla de crear una suscripción es con la consola de AWS DMS. En una suscripción de notificaciones, se elige cómo y dónde enviar las notificaciones. Se especifica el tipo de origen sobre el que se desea recibir notificaciones; actualmente AWS DMS admite los tipos de origen de instancias y tareas de replicación. En función del tipo de origen que seleccione, elija las categorías de eventos e identifique el origen del que desea recibir notificaciones de eventos.

    Utilización de la AWS Management Console

    importante

    A partir de la versión de AWS DMS 3.4.5 y versiones más recientes, le recomendamos que utilice Amazon EventBridge para proporcionar notificaciones cuando se produzca un evento de AWS DMS. Para obtener más información acerca del uso de eventos de EventBridge con AWS DMS, consulte Trabajo con eventos y notificaciones de Amazon EventBridge en AWS Database Migration Service.

    Para suscribirse a la notificación de eventos de AWS DMS con Amazon SNS mediante la consola
    1. Inicie sesión en la AWS Management Console y abra la consola de AWS DMS en https://console.aws.amazon.com/dms/v2/.

      Si ha iniciado sesión como usuario de IAM, asegúrese de que dispone de los permisos adecuados para acceder a AWS DMS.

    2. En el panel de navegación seleccione Event Subscriptions (Suscripciones de eventos).

    3. En la página Suscripciones de eventos, elija Crear suscripción de eventos.

    4. En la página Crear suscripción de eventos, haga lo siguiente:

      1. En Detalles, para Nombre, ingrese un nombre para la suscripción de notificación de eventos.

      2. Elija Habilitado para habilitar la suscripción. Si desea crear la suscripción, pero que todavía no envíen notificaciones, no elija Habilitado.

      3. En Destino, elija Temas existentes, Crear nuevo tema de correo electrónico o Crear nuevo tema de SMS para enviar notificaciones. Asegúrese de disponer de un tema de Amazon SNS existente al que enviar avisos o en el que crear el tema. Si crea un tema, puede especificar una dirección de correo electrónico a la que se enviarán las notificaciones.

      4. En Origen del evento, para Tipo de origen, elija un tipo de origen. Las únicas opciones son instancia de replicación y tarea de replicación.

      5. En función del tipo de origen que haya seleccionado, seleccione las categorías y orígenes del evento de las que desea recibir notificaciones.

        Suscripción a eventos de creación de la consola
      6. Seleccione Crear suscripción de eventos.

    La consola de AWS DMS indica que se está creando la suscripción.

    nota

    También puede crear suscripciones a notificaciones de eventos de Amazon SNS mediante la API y la CLI de AWS DMS. Para obtener más información, consulte CreateEventSubscription en la documentación de la referencia de la API de AWS DMS y create-event-subscription en la referencia de la CLI de AWS DMS.

    Validación de la política de acceso del tema de SNS

    La política de acceso de SNS requiere permisos que permitan a AWS DMS publicar eventos en el tema de SNS. Puede validar y actualizar la política de acceso tal y como se describe en los siguientes procedimientos.

    Para validar la política de acceso
    1. Abra la consola de Amazon SNS.

    2. En el panel de navegación, elija Temas y seleccione el tema sobre el que desee recibir notificaciones de DMS.

    3. Seleccione la pestaña Política de acceso.

    Puede actualizar la política si la política de acceso a SNS no permite a AWS DMS publicar eventos en el tema de SNS.

    Para actualizar la política de acceso
    1. En la sección Detalles de la página del tema, elija Editar.

    2. Expanda la sección Política de acceso y adjunte la siguiente política al editor JSON.

      { "Sid": "dms-allow-publish", "Effect": "Allow", "Principal": { "Service": "dms.amazonaws.com" }, "Action": "sns:Publish", "Resource": "your-SNS-topic-ARN" }

      Le recomendamos que restrinja aún más el acceso al tema de SNS especificando la condición aws:SourceArn, que es el Arn de DMS EventSubscription que publica los eventos en el tema.

      ... "Resource": "your-SNS-topic-ARN" "Condition": { "StringEquals": { "aws:SourceArn": "arn:partition:dms:your-AWS-region:your-AWS-account-ID:es:your-dms-es-arn or *" }
    3. Elija Save changes (Guardar cambios).