Movimentação de assinaturas de eventos para o Amazon EventBridge Como trabalhar com eventos e notificações do Amazon SNS Categorias de eventos do AWS DMS e mensagens de eventos para notificações do SNS Assinatura para notificação de eventos do AWS DMS utilizando o SNS

Como trabalhar com eventos e notificações do Amazon SNS no AWS Database Migration Service

A partir do lançamento do AWS DMS 3.4.5 e com versões posteriores, é recomendável utilizar o Amazon EventBridge para fornecer notificações quando ocorre um evento no AWS DMS. Para obter mais informações sobre como utilizar eventos do EventBridge com o AWS DMS, consulte Como trabalhar com eventos e notificações do Amazon EventBridge no AWS Database Migration Service.

Movimentação de assinaturas de eventos para o Amazon EventBridge

É possível utilizar o seguinte comando da AWS CLI para migrar assinaturas de eventos ativos do DMS para o Amazon EventBridge, até 10 por vez.

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

Por padrão, o AWS DMS só migra assinaturas de eventos ativos quando a instância de replicação está atualizada com o AWS DMS 3.4.5 ou superior. Para substituir esse comportamento padrão, utilize a opção --force-move. No entanto, alguns tipos de eventos podem não estar disponíveis ao utilizar o Amazon EventBridge se as instâncias de replicação não estiverem atualizadas.

Para executar o comando update-subscriptions-to-event-bridge da CLI, um usuário do AWS Identity and Access Management (IAM) deve ter as permissões de política a seguir.


{
  "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 mover assinaturas para o EventBridge, consulte UpdateSubscriptionsToEventBridge na Referência da API do AWS Database Migration Service.

Como trabalhar com eventos e notificações do Amazon SNS

As versões 3.4.5 e anteriores do AWS DMS são compatíveis com o trabalho com eventos e notificações conforme descrito a seguir.

O AWS Database Migration Service (AWS DMS) pode utilizar o Amazon Simple Notification Service (Amazon SNS) para fornecer notificações quando ocorre um evento do AWS DMS, por exemplo, a criação ou a exclusão de uma instância de replicação. É possível trabalhar com essas notificações em qualquer formato compatível com o Amazon SNS em uma região da AWS, como uma mensagem de e-mail, uma mensagem de texto ou uma chamada para um endpoint HTTP.

O AWS DMS agrupa os eventos em categorias que você pode assinar para receber notificações quando ocorrer um evento dessa categoria. Por exemplo, se você assinar a categoria Criação de uma instância de replicação específica, será notificado sempre que ocorrer um evento relacionado à criação que afete a 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 ver uma lista das categorias de eventos fornecidos pelo AWS DMS, consulte Categorias de eventos do AWS DMS e mensagens de eventos para notificações do SNS.

O AWS DMS envia notificações de eventos para os endereços fornecidos quando a assinatura do evento é criada. 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. As notificações podem ser facilmente desativadas sem excluir uma assinatura ao cancelar a seleção da opção Ativada, no console do AWS DMS, ou definindo o parâmetro Enabled como falso utilizando a API do AWS DMS.

nota

As notificações de eventos do AWS DMS utilizando mensagens de texto SMS estão disponíveis no momento para recursos do AWS DMS em todas as regiões da AWS em que o Amazon SNS é compatível. Para obter uma lista das regiões e países da AWS em que o Amazon SNS é compatível com mensagens SMS, consulte Regiões e países compatíveis.

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

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

O AWS DMS utiliza um identificador de assinatura para identificar cada assinatura. É possível ter várias assinaturas de eventos do AWS DMS publicadas no mesmo tópico do Amazon SNS. Taxas do Amazon SNS são aplicadas quando você utiliza a notificação de eventos. Para obter mais informações sobre o faturamento do Amazon SNS, consulte Preços do Amazon SNS.

Para assinar eventos do AWS DMS com o Amazon SNS utilize o seguinte processo:

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.
Crie uma assinatura de notificação de evento do AWS DMS utilizando o AWS Management Console, a AWS CLI ou a API do AWS DMS.
O AWS DMS envia um e-mail ou uma mensagem SMS de aprovação para os endereços submetidos com a assinatura. Para confirmar a assinatura, clique no link no e-mail ou mensagem SMS de aprovação.
Quando a assinatura é confirmada, o status da assinatura é atualizado na seção Assinaturas de eventos no console do AWS DMS.
E você começará a receber notificações de eventos.

Para obter uma lista das categorias e dos eventos sobre os quais você pode ser notificado, consulte a próxima seção. Para obter mais detalhes sobre como assinar e trabalhar com assinaturas de eventos no AWS DMS, consulte Assinatura para notificação de eventos do AWS DMS utilizando o SNS.

Tópicos

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

Importante

O AWS DMS gera um número significativo de eventos em categorias que você pode assinar utilizando o console do AWS DMS ou a API do AWS DMS. Cada categoria se aplica a um tipo de origem. No momento, o AWS DMS é compatível com os tipos de origem de instância de replicação e de tarefa de replicação.

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

Categoria	ID do evento no DMS	Descrição
Alteração na configuração	DMS-EVENT-0012	A classe dessa instância de replicação está sendo alterada.
Alteração na configuração	DMS-EVENT-0014	A classe dessa instância de replicação foi alterada.
Alteração na configuração	DMS-EVENT-0018	O armazenamento da instância de replicação está sendo aumentado.
Alteração na configuração	DMS-EVENT-0017	O armazenamento da instância de replicação foi aumentado.
Alteração na configuração	DMS-EVENT-0024	A instância de replicação está fazendo a transição para uma configuração multi-AZ.
Alteração na configuração	DMS-EVENT-0025	A instância de replicação concluiu a transição para uma configuração multi-AZ.
Alteração na configuração	DMS-EVENT-0030	A instância de replicação está fazendo a transição para uma configuração Single-AZ.
Alteração na configuração	DMS-EVENT-0029	A instância de replicação concluiu a transição para uma configuração Single-AZ.
Criação	DMS-EVENT-0067	A instância de replicação está sendo criada.
Criação	DMS-EVENT-0005	A instância de replicação está criada.
Exclusão	DMS-EVENT-0066	A instância de replicação está sendo excluída.
Exclusão	DMS-EVENT-0003	A instância de replicação está excluída.
Manutenção	DMS-EVENT-0047	O software de gerenciamento na instância de replicação foi atualizado.
Manutenção	DMS-EVENT-0026	Está ocorrendo a manutenção off-line da instância de replicação. A instância de replicação não está disponível no momento.
Manutenção	DMS-EVENT-0027	A manutenção off-line da instância de replicação está concluída. A instância de replicação agora está disponível.
Manutenção	DMS-EVENT-0068	A instância de replicação está em um estado que não pode ser atualizado.
LowStorage	DMS-EVENT-0007	A instância de replicação consumiu mais de 90% do armazenamento alocado. É possível monitorar o espaço de armazenamento de uma instância de replicação utilizando a métrica Espaço de armazenamento gratuito.
Failover	DMS-EVENT-0013	Failover iniciado para uma instância de replicação multi-AZ.
Failover	DMS-EVENT-0049	O failover está concluído para uma instância de replicação multi-AZ.
Failover	DMS-EVENT-0015	Failover de multi-AZ para o modo de espera concluído.
Failover	DMS-EVENT-0050	A ativação multi-AZ foi iniciada.
Failover	DMS-EVENT-0051	A ativação multi-AZ foi concluída.
Failover	DMS-EVENT-0034	Se você solicitar failover com muita frequência, ocorrerá esse evento em vez dos eventos normais de failover.
Falha	DMS-EVENT-0031	A instância de replicação entrou em falha de armazenamento.
Falha	DMS-EVENT-0036	Falha na instância de replicação devido a uma rede incompatível.
Falha	DMS-EVENT-0037	O serviço não pode acessar a chave do AWS KMS usada para criptografar o volume de dados.

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

Categoria	ID do evento no DMS	Descrição
Alteração de estado	DMS-EVENT-0069	A tarefa de replicação foi iniciada.
Alteração de estado	DMS-EVENT-0081	Foi solicitado o recarregamento dos detalhes da tabela.
Alteração de estado	DMS-EVENT-0079	A tarefa de replicação foi interrompida.
Alteração de estado	DMS-EVENT-0091	Leitura pausada, limite de arquivos de troca atingido.
Alteração de estado	DMS-EVENT-0092	Leitura pausada, limite de uso de disco atingido.
Alteração de estado	DMS-EVENT-0093	Leitura retomada.
Falha	DMS-EVENT-0078	Falha na tarefa de replicação.
Falha	DMS-EVENT-0082	Falha na limpeza dos dados da tarefa em uma chamada para excluir a tarefa.
Alteração na configuração	DMS-EVENT-0080	A tarefa de replicação está modificada.
Exclusão	DMS-EVENT-0073	A instância de replicação está excluída.
Criação	DMS-EVENT-0074	A instância de replicação está criada.

O exemplo a seguir mostra uma assinatura do AWS DMS evento com a categoria Alteração 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

Assinatura para notificação de eventos do AWS DMS utilizando o SNS

Importante

É possível criar uma assinatura de notificação de evento 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 notificações. Você especifica o tipo de origem sobre o qual deseja ser notificado. Atualmente, o AWS DMS é compatível com os tipos de origem de instância de replicação e de tarefa de replicação. Dependendo do tipo de origem selecionado, escolha as categorias e as origens de eventos e identifique a origem da qual deseja receber notificações de eventos.

Utilização do AWS Management Console

Importante

Como assinar uma notificação de eventos do AWS DMS com o Amazon SNS utilizando o console

Faça login no AWS Management Console e abra o console do AWS DMS em https://console.aws.amazon.com/dms/v2/.

Se estiver conectado como um usuário do IAM, verifique se você possui as permissões necessárias para acessar o AWS DMS.
No painel de navegação, escolha Assinaturas de eventos.
Na página Assinaturas de eventos, escolha Criar assinatura de evento.
Na página Criar assinatura de evento, faça o seguinte:
1. Em Detalhes, em Nome, insira um nome para a assinatura de notificação de evento.
2. Escolha Habilitada, para ativar a assinatura. Se quiser criar a assinatura, mas ainda não quiser receber notificações, não escolha Habilitada.
3. Em Destino, escolha Tópicos existentes, Criar novo tópico de e-mail ou Criar novo tópico de SMS para enviar notificações. Verifique se já existe um tópico do Amazon SNS para o qual enviar notificações, ou crie o tópico. Se escolher um tópico, poderá inserir um endereço de e-mail para receber as notificações.
4. Em Origem do evento, em Tipo de evento, escolha um tipo de origem. As únicas opções são replication-instance e replication-task.
5. Dependendo do tipo de origem selecionado, escolha as categorias de eventos e as origens das quais deseja receber notificações.
6. Selecione Criar assinatura de evento.

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

nota

Também é possível criar assinaturas de notificação de eventos do Amazon SNS utilizando a API do AWS DMS e a CLI. Para obter mais informações, consulte CreateEventSubscription na Referência da API do AWS DMS e create-event-subscription na documentação Referência da CLI do AWS DMS.

Validação da política de acesso do tópico do SNS

A política de acesso ao SNS exige permissões para que o AWS DMS publique eventos nó tópico do SNS. É possível validar e atualizar a política de acesso conforme descrito nos procedimentos a seguir.

Como validar a política de acesso

Abra o console do Amazon SNS.
No painel de navegação, escolha Tópicos e selecione o tópico sobre o qual você deseja receber notificações do DMS.
Selecione a guia Política de acesso.

Será possível atualizar a política se a política de acesso ao SNS não permitir que o AWS DMS publique eventos no tópico do SNS.

Como atualizar a política de acesso

Na seção Detalhes da página de tópicos, escolha Editar.

Expanda a seção Política de acesso e anexe a seguinte política ao editor JSON.


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

É recomendável restringir ainda mais o acesso ao tópico do SNS especificando a condição aws:SourceArn, que é o ARN de EventSubscription do DMS que publica eventos no tópico.


...
"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 *"
 }

Escolha Salvar alterações.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Como trabalhar com eventos do EventBridge

Validação de dados