AWSSupport-TroubleshootDMSTableErrors - AWS Systems Manager Referência do runbook de automação

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á.

AWSSupport-TroubleshootDMSTableErrors

Descrição

O runbook de AWS Systems Manager AWSSuport-TroubleshootDMSTabelErrors automação ajuda você a automatizar o processo de solução de problemas Table errors encontrado na tarefa de migração do banco de dados ou na replicação sem servidor do. AWS Database Migration Service Esses erros ocorrem quando as tabelas não conseguem migrar do endpoint de origem (banco de dados de origem) para o endpoint de destino (banco de dados de destino) pela tarefa de migração do banco de dados ou pela replicação sem servidor criada no serviço. AWS DMS Este runbook analisa as mensagens de erro de assinatura dos CloudWatch registros, focando especificamente nos registros de tarefas para tarefas tradicionais de migração de banco de dados e nos registros sem servidor para replicação sem servidor. Ele também fornece sugestões específicas e etapas de correção para mensagens de erro comuns encontradas Table error durante as AWS DMS migrações.

Como funciona?

O runbook executa as seguintes etapas:

  • Busca informações sobre o AWS DMS ARN fornecido, que pode ser uma tarefa de migração de banco de dados ou uma replicação sem servidor.

  • Verifica se o AWS DMS recurso fornecido foi iniciado pelo menos uma vez, verificando o FreshStartDate valor na resposta da DescribeReplicationTasks API (para tarefa de migração de banco de dados) e DescribeReplications da API (para replicação sem servidor). Se o recurso não tiver sido iniciado, a automação gerará um erro.

  • Se o recurso foi iniciado, a automação verifica as tabelas nos TableError estados usando TableStatistics informações. Se nenhum erro for encontrado, a automação encerrará o fluxo de trabalho após exibir uma mensagem confirmando que nenhum erro de tabela foi encontrado na tarefa de migração do banco de dados ou na replicação sem servidor especificada.

  • Se forem encontradas tabelas com TableError estado, a automação verificará se o CloudWatch registro está habilitado para o AWS DMS recurso especificado. Se o registro não estiver ativado, a automação encerrará o fluxo de trabalho após exibir uma mensagem indicando que o registro não está ativado.

    Observação: espera-se que o CloudWatch registro seja ativado, pois a automação depende desses registros para analisar e identificar os problemas com as tabelas em TableError estado.

  • Se o registro estiver ativado, a automação analisa os CloudWatch registros e gera um relatório para cada tabela que está em TableError estado. O relatório inclui sugestões para mensagens de erro comuns e fornece registros de erros relevantes para ajudar a identificar e resolver problemas que impedem a migração bem-sucedida da tabela do endpoint de AWS DMS origem para o endpoint de AWS DMS destino.

Executar esta automação (console)

Tipo de documento

Automação

Proprietário

Amazon

Plataformas

/

Parâmetros

  • AutomationAssumeRole

    Tipo: String

    Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.

  • DMSArn

    Tipo: String

    Descrição: (Obrigatório) ARN da tarefa de migração do banco de dados ou replicação sem servidor

    Allowed-pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):dms:[a-z0-9-]+:\d{12}:(task|replication-config):[a-zA-Z0-9-]+$

  • StartTimeRange

    Tipo: String

    Descrição: (Opcional) Esse parâmetro define o início do intervalo de tempo para análise de CloudWatch registros de determinada tarefa de migração de banco de dados ou replicação sem servidor. Quando fornecidos, somente os registros gerados a partir desse momento específico serão coletados e analisados. Observe que existe a possibilidade de o fluxo de trabalho atingir o tempo limite se o intervalo de tempo entre startDate e endDate for muito longo. O valor deve ser fornecido no formato de data e hora ISO 6081.

    Allowed-pattern: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

  • EndTimeRange

    Tipo: String

    Descrição: (Opcional) Esse parâmetro define o final do intervalo de tempo para análise de CloudWatch log da determinada tarefa de migração de banco de dados ou replicação sem servidor. Quando fornecidos, somente os registros gerados até esse momento específico serão coletados e analisados. Observe que existe a possibilidade de o fluxo de trabalho atingir o tempo limite se o intervalo de tempo entre startDate e endDate for muito longo. O valor deve ser fornecido no formato de data e hora ISO 6081.

    Allowed-pattern: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

Permissões obrigatórias do IAM

O parâmetro AutomationAssumeRole requer as seguintes ações para usar o runbook com êxito.

  • dms:DescribeReplicationTasks

  • dms:DescribeReplications

  • dms:DescribeEndpoints

  • dms:DescribeReplicationConfigs

  • dms:DescribeTableStatistics

  • dms:DescribeReplicationTableStatistics

  • logs:FilterLogEvents

Exemplo de política do IAM para a função Automation Assume 


            {
                "Version": "2012-10-17",
                "Statement": [
                    {
                        "Sid": "VisualEditor0",
                        "Effect": "Allow",
                        "Action": [
                            "dms:DescribeReplicationConfigs",
                            "dms:DescribeEndpoints",
                            "dms:DescribeReplicationTableStatistics",
                            "dms:DescribeTableStatistics",
                            "logs:FilterLogEvents",
                            "dms:DescribeReplicationTasks",
                            "dms:DescribeReplications"
                        ],
                        "Resource": "*"
                    }
                ]
            }

Instruções

Siga estas etapas para configurar a automação:

  1. Navegue até AWSSupport-TroubleshootDMSTableErrorsem Systems Manager em Documentos.

  2. Selecione Execute automation (Executar automação).

  3. Para os parâmetros de entrada, insira o seguinte:

    • AutomationAssumeRole (Opcional):

      O Amazon Resource Name (ARN) da função AWS AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation execute as ações em seu nome. Se nenhuma função for especificada, o Systems Manager Automation usa as permissões do usuário que inicia esse runbook.

    • DMSArn

      ARN da tarefa de migração do banco de dados ou replicação sem servidor que tem erros de tabela.

    • StartTimeRange

      (Opcional) Formato de data e hora ISO 6081 que define o início do intervalo de tempo para analisar CloudWatch os registros de determinada tarefa de migração de banco de dados ou replicação sem servidor.

    • EndTimeRange

      (Opcional) Formato de data e hora ISO 6081 que define o final do intervalo de tempo para analisar CloudWatch os registros da determinada tarefa de migração do banco de dados ou replicação sem servidor.

  4. Selecione o botão Executar na parte inferior da página.

  5. A automação é iniciada.

  6. O bucket realiza as seguintes etapas:

    • validar DMSInput TypeAndGatherDetails

      Valida a entrada AWS DMS ARN fornecida e reúne os detalhes básicos da tarefa de migração do banco de dados ou da replicação sem servidor, que são necessários nas próximas etapas.

    • branchOnTableErros

      Ramifica o fluxo de trabalho com base no número de erros de tabela encontrados na etapa acima. Se a contagem for maior que 0, vá para a branchOnCWLoggingStatus etapa -. Caso contrário, vá para a outputNoTableErrors etapa -.

    • outputNoTableErros

      Exiba uma mensagem informando que os erros da tabela não foram encontrados na tarefa de migração do banco de dados ou na replicação sem servidor especificada.

    • Status do BranchOn CWLogging

      Ramifica o fluxo de trabalho com base no status de CloudWatch registro encontrado na etapa acima. Se ativado, prossiga para a gatherTableDetails etapa -. Caso contrário, vá para a outputNoCWLoggingEnabled etapa -.

    • Saída: Não ativada CWLogging

      Produz uma mensagem informando que o CloudWatch registro não está habilitado na tarefa de migração do banco de dados ou na replicação sem servidor especificada.

    • gatherTableDetails

      Reúne os registros de FullLoadEndTime data e hora das tabelas com falha e calcula os valores do intervalo de tempo para analisar os registros. CloudWatch

    • analyzeCloudWatchLogs

      Analisa os registros encontrados no grupo de CloudWatch registros com base nas mensagens de erro da assinatura e retorna o relatório ao usuário.

  7. Após a conclusão da execução, revise a seção Saídas para obter os resultados detalhados da execução.

    • Saída de nenhum erro de tabela encontrado

      Se não houver erros de tabela encontrados na tarefa de migração do banco de dados fornecida ou na replicação sem servidor, a automação mostrará a saída informando o mesmo.

    • Saída de Sem CloudWatch login ativado

      Se o CloudWatch registro não estiver habilitado na tarefa de migração de banco de dados fornecida ou na replicação sem servidor, a automação mostrará a saída informando a mesma e fornecerá as etapas para habilitar o registro.

    • Relatório de análise de log

      Produz um relatório que identifica as tabelas no Table error estado da tarefa de migração do banco de dados fornecida ou da replicação sem servidor, diferenciando os tipos de erro, listando as mensagens de erro encontradas e fornecendo etapas e sugestões de remediação direcionadas para cada tabela identificada.

Referências

Automação do Systems Manager