Trabalhando com eventos e notificações do Amazon SNS emAWS Database Migration Service - AWS Database Migration Service

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalhando com eventos e notificações do Amazon SNS emAWS Database Migration Service

Começando com o lançamento doAWS DMS3.4.6 e com versões posteriores, recomendamos o uso da Amazon EventBridge para fornecer notificações quando umAWS DMSevento ocorre. Para obter mais informações sobre o uso de EventBridge eventos comAWS DMS, ConsulteTrabalhar com a Amazon EventBridge eventos e notificações emAWS Database Migration Service.

Transferência de assinaturas de eventos para a Amazon EventBridge

É possível usar o seguinteAWS CLIcomando para migrar assinaturas de eventos ativos do DMS para a Amazon EventBridge, até 10 de cada vez.

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

Por padrão,AWS DMSsó migra assinaturas de eventos ativos quando sua instância de replicação está atualizada comAWS DMS3.4.6 e posterior. Para ignorar esse comportamento padrão, use o--force-moveopção. No entanto, alguns tipos de eventos podem não estar disponíveis usando a Amazon EventBridge se suas instâncias de replicação não forem atualizadas.

Para executar oupdate-subscriptions-to-event-bridgeComando da CLI,AWS Identity and Access ManagementO usuário do (IAM) deve ter as seguintes permissões de política.

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

Para obter mais informações sobre como transferir assinaturas para o EventBridge, ConsulteUpdateSubscriptionsToEventBridgenaAWS Database Migration ServiceReferência de API.

Trabalhando com eventos e notificações do Amazon SNS

AWS DMSas versões 3.4.5 e anteriores oferecem suporte ao trabalho com eventos e notificações conforme descrito a seguir.

AWSDatabase Migration ServiceAWSO DMS) pode usar o Amazon Simple Notification Service (Amazon SNS) para fornecer notificações quando umAWSO evento DMS ocorre, por exemplo, a criação ou exclusão de uma instância de replicação. Você pode trabalhar com essas notificações de qualquer forma suportada pelo Amazon SNS para umaAWSRegião, como uma mensagem de e-mail, uma mensagem de texto ou uma chamada para um endpoint HTTP.

AWSO DMS agrupa eventos em categorias nas quais você pode inscrever-se, para receber notificações quando se verificar um evento dessa categoria. Por exemplo, se você fizer uma assinatura na categoria de criação de uma instância de replicação específica, será notificado sempre que ocorrer um evento relacionado à criação que afete sua instância de replicação. Se fizer uma assinatura na categoria de alteração de configuração em uma instância de replicação, será notificado quando a configuração da instância de replicação for alterada. Você também recebe uma notificação quando uma assinatura de notificação de evento é alterada. Para obter uma lista das categorias de eventos fornecidas peloAWSDMS, consulteAWSCategorias de eventos e mensagens de eventos do DMS para notificações do SNS, seguindo.

AWSO DMS envia notificações de eventos aos endereços que você fornece ao criar uma assinatura de evento. Pode ser interessante para você criar várias assinaturas diferentes, como por exemplo uma assinatura para receber todas as notificações de eventos e outra que inclua somente eventos críticos para os seus recursos de produção do DMS. Você pode desativar facilmente a notificação sem excluir uma assinatura desmarcando aAtivadoopção noAWSConsole DMS ou configurando oEnabledparâmetro parafalsousar oAWSAPI DMS.

nota

AWSNotificações de eventos do DMS usando mensagens de texto SMS estão atualmente disponíveis paraAWSRecursos do DMS em todosAWSRegiões nas quais o Amazon SNS é suportado. Para obter uma lista deAWSRegiões e países em que o Amazon SNS é compatível com mensagens SMS, consulteRegiões e países do com suporte.

Para obter mais informações sobre o uso de mensagens de texto com SNS, consulte Envio e recebimento de notificações por SMS usando Amazon SNS.

AWS DMSnotificações de eventos CloudTrail eventos em CloudWatch ou EventBridge. CloudTrail as notificações de eventos podem ser geradas por qualquer invocação de API. O DMS envia uma notificação somente quando ocorre um evento do DMS.

AWSO DMS usa um identificador de assinatura para identificar cada assinatura. Você pode ter váriosAWSAssinaturas de eventos do DMS publicadas no mesmo tópico do Amazon SNS. Quando você usa as notificações de eventos, as taxas do Amazon SNS se aplicam. Para obter mais informações sobre o faturamento do Amazon SNS, consulteDefinição de preço do Amazon SNS.

Para assinar oAWSEventos do DMS com o Amazon SNS, use o seguinte processo:

  1. Crie um tópico do Amazon SNS. Neste tópico, especifique o tipo de notificação que deseja receber e para qual endereço ou número a notificação deve ir.

  2. Criar um .AWSAssinatura de notificação de eventos do DMS usando oAWS Management Console,AWS CLI, ouAWSAPI DMS.

  3. AWSO DMS envia um e-mail ou mensagem SMS de aprovação para os endereços que você submeteu com a assinatura. Para confirmar a assinatura, clique no link no e-mail ou mensagem SMS de aprovação.

  4. Quando a assinatura é confirmada, o status da assinatura é atualizado noAWSConsole DMSAssinaturas de eventosSeção.

  5. Em seguida, você começará a receber notificações de eventos.

Para uma lista de categorias e eventos sobre os quais você pode ser notificado, consulte a próxima seção. Para obter mais detalhes sobre como assinar e trabalhar com oAWSAssinaturas de eventos do DMS, consulteAssinarAWSNotificação de eventos do DMS usando o SNS.

Tópicos

    AWSCategorias de eventos e mensagens de eventos do DMS para notificações do SNS

    Importante

    Começando com o lançamento doAWS DMS3.4.6 e com versões posteriores, recomendamos o uso da Amazon EventBridge para fornecer notificações quando umAWS DMSevento ocorre. Para obter mais informações sobre o uso de EventBridge eventos comAWS DMS, ConsulteTrabalhar com a Amazon EventBridge eventos e notificações emAWS Database Migration Service.

    AWSO DMS gera um número significativo de eventos em categorias nas quais você pode inscrever-se usando oAWSConsole DMS ou oAWSAPI DMS. Cada categoria se aplica a um tipo de origem. No momentoAWSO DMS oferece suporte aos tipos de origem de instância e tarefa de replicação.

    A tabela a seguir mostra as categorias e eventos existentes para o tipo de origem instância de replicação.

    Categoria

    ID do evento no DMS

    Descrição

    Alteração de configuração EVENTO DMS-0012

    A classe da instância de replicação dessa instância de replicação está sendo alterada.

    Alteração de configuração EVENTO DMS-0014

    A classe de instância de replicação para essa instância de replicação foi alterada.

    Alteração de configuração EVENTO DMS-0018

    O armazenamento da instância de replicação está sendo aumentado.

    Alteração de configuração EVENTO DMS-0017

    O armazenamento da instância de replicação foi aumentado.

    Alteração de configuração EVENTO DMS-0024

    A instância de replicação está em transição para uma configuração Multi-AZ.

    Alteração de configuração EVENTO DMS-0025

    A instância de replicação concluiu a transição para uma configuração Multi-AZ.

    Alteração de configuração EVENTO DMS-0030

    A instância de replicação está em transição para uma configuração Single-AZ.

    Alteração de configuração EVENTO DMS-0029

    A instância de replicação concluiu a transição para uma configuração Single-AZ.

    Criação EVENTO DMS-0067

    Uma instância de replicação está sendo criada.

    Criação EVENTO DMS-0005

    Uma instância de replicação é criada.

    Exclusão EVENTO DMS-0066

    A instância de replicação está sendo excluída.

    Exclusão EVENTO DMS-0003

    A instância de replicação é excluída.

    Manutenção EVENTO DMS-0047 O software de gerenciamento na instância de replicação foi atualizado.
    Manutenção EVENTO DMS-0026 Está ocorrendo a manutenção offline da instância de replicação. A instância de replicação não está disponível no momento.
    Manutenção EVENTO DMS-0027 A manutenção offline da instância de replicação está completa. A instância de replicação está disponível agora.
    Manutenção EVENTO DMS-0068 Uma instância de replicação está em um estado que não pode ser atualizado.
    LowStorage EVENTOS DMS-0007 A instância de replicação consumiu mais de 90% do armazenamento alocado. Você pode monitorar o espaço de armazenamento para uma instância de replicação usando a métrica Free Storage Space.
    Failover EVENTO DMS-0013 O failover foi iniciado para uma instância de replicação Multi-AZ.
    Failover EVENTO DMS-0049 O failover está completo para uma instância de replicação Multi-AZ.
    Failover EVENTO DMS-0015 O failover de Multi-AZ para o modo de espera está completo.
    Failover EVENTO DMS-0050 Foi iniciada a ativação Multi-AZ.
    Failover EVENTO DMS-0051 A ativação Multi-AZ foi concluída.
    Failover EVENTO DMS-0034 Se você solicitar failover com muita frequência, esse evento ocorrerá em vez dos eventos de failover regulares.
    Falha EVENTO DMS-0031 A instância de replicação entrou em falha de armazenamento.
    Falha EVENTO DMS-0036 Houve falha na instância de replicação devido a uma rede incompatível.
    Falha EVENTO DMS-0037 O serviço não pode acessar oAWS KMSchave usada para criptografar o volume de dados.

    A tabela a seguir mostra as categorias e eventos possíveis para o tipo de origem da tarefa de replicação.

    Categoria

    ID do evento no DMS

    Descrição

    Alteração do estado EVENTO DMS-0069

    A tarefa de replicação foi iniciada.

    Alteração do estado EVENTO DMS-0081

    Uma recarga dos detalhes da tabela foi solicitada.

    Alteração do estado EVENTO DMS-0079

    A tarefa de replicação foi interrompida.

    Alteração do estado EVENTO DMS-0091 Leitura pausada, limite de arquivos de troca atingido.
    Alteração do estado EVENTO DMS-0092 Leitura pausada, limite de uso do disco atingido.
    Alteração do estado EVENTO DMS-0093 A leitura foi retomada.
    Falha EVENTO DMS-0078

    Houve falha na tarefa de replicação.

    Falha EVENTO DMS-0082

    Uma chamada para excluir a tarefa não conseguiu limpar os dados da tarefa.

    Alteração de configuração EVENTO DMS-0080 A tarefa de replicação é modificada.
    Exclusão EVENTO DMS-0073

    A tarefa de replicação é excluída.

    Criação EVENTO DMS-0074 A tarefa de replicação é criada.

    O exemplo a seguir mostra umAWS DMSassinatura de evento com a categoria State Change.

    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

    AssinarAWSNotificação de eventos do DMS usando o SNS

    Importante

    Começando com o lançamento doAWS DMS3.4.6 e com versões posteriores, recomendamos o uso da Amazon EventBridge para fornecer notificações quando umAWS DMSevento ocorre. Para obter mais informações sobre o uso de EventBridge eventos comAWS DMS, ConsulteTrabalhar com a Amazon EventBridge eventos e notificações emAWS Database Migration Service.

    Você pode fazer uma assinatura de notificação de eventos do AWS DMS a fim de ser notificado quando ocorrer um evento no AWS DMS. A forma mais fácil de criar uma assinatura é com o console do AWS DMS. Em uma assinatura de notificação, você escolhe como e para onde enviar as notificações. Você especifica o tipo de origem sobre o qual deseja ser notificado. No momentoAWS DMSoferece suporte aos tipos de origem de instância e tarefa de replicação. E, dependendo do tipo de origem que você seleciona, você escolhe as categorias de eventos e identifica a origem para a qual deseja receber notificações de eventos.

    Como usar a AWS Management Console

    Importante

    Começando com o lançamento doAWS DMS3.4.6 e com versões posteriores, recomendamos o uso da Amazon EventBridge para fornecer notificações quando umAWS DMSevento ocorre. Para obter mais informações sobre o uso de EventBridge eventos comAWS DMS, ConsulteTrabalhar com a Amazon EventBridge eventos e notificações emAWS Database Migration Service.

    Para assinar oAWSNotificação de eventos do DMS com o Amazon SNS usando o console

    1. Faça login noAWS Management Consolee abra oAWS DMSConsole dohttps://console.aws.amazon.com/dms/v2/.

      Se você estiver conectado a um usuário do IAM, verifique se tem as permissões apropriadas para acessarAWS DMS.

    2. No painel de navegação, escolha Event subscriptions (Assinaturas de eventos).

    3. Sobre oAssinaturas de eventospágina, escolhaCriar assinatura de evento.

    4. Sobre oCriar assinatura de eventopágina, faça o seguinte:

      1. DebaixoDetalhes, paraName (Nome), insira um nome para a assinatura de notificação de eventos.

      2. EscolhaAtivadopara habilitar a assinatura. Se você quiser criar a assinatura, mas não tiver notificações enviadas, não escolhaAtivado.

      3. DebaixoDestino, escolha qualquer umTópicos existentes,Crie um novo tópico de e-mailouCrie um novo tópico de SMSpara enviar notificações. Certifique-se de que você tenha um tópico existente do Amazon SNS para enviar avisos ou crie o tópico. Se você criar um tópico, poderá inserir um endereço de e-mail para o qual as notificações serão enviadas.

      4. DebaixoOrigem do evento, paraTipo de origem, escolha um tipo de fonte. As únicas opções sãoinstância de replicaçãoetarefa de replicação.

      5. Dependendo do tipo de origem selecionado, escolha as categorias de eventos e as origens para as quais deseja receber notificações.

        
                                    Console de criação de assinatura
      6. SelectCriar assinatura de evento.

    OAWSO console do DMS indica que a assinatura está sendo criada.

    nota

    Você também pode criar assinaturas de notificação de eventos do Amazon SNS usando oAWS DMSAPI e CLI. Para obter mais informações, consulte o .CreateEventSubscriptionnaAWS DMSReferência de APIecreate-event-subscriptionnaAWS DMSReferência da CLIdocumentação.

    Validando a política de acesso do seu tópico do SNS

    Sua política de acesso do SNS exige permissões que permitamAWS DMSpara publicar eventos em seu tópico do SNS. Você pode validar e atualizar sua política de acesso conforme descrito nos procedimentos a seguir.

    Para validar sua política de acesso

    1. Abra o console do Amazon SNS.

    2. No painel de navegação, escolhaTópicose selecione o tópico sobre o qual você deseja receber notificações do DMS.

    3. Selecione oPolítica de acessoGuia.

    Você pode atualizar sua política se sua política de acesso do SNS não permitirAWS DMSpara publicar eventos em seu tópico do SNS.

    Para atualizar sua política de acesso

    1. DoDetalhesseção da sua página de tópico, escolhaEditar.

    2. ExpandaPolítica de acessoe anexe a política a seguir no editor de JSON.

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

      Recomendamos que você restrinja ainda mais o acesso ao seu tópico do SNS especificando oaws:SourceArncondição, que é o DMS EventSubscription Arn que publica eventos sobre o assunto.

      ... "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. Escolha Save changes (Salvar alterações).