Como posso configurar o registro em log detalhado de depuração para minha tarefa do AWS DMS?

Breve descrição

Há três maneiras de ativar o registro em log detalhado de depuração para uma tarefa do AWS DMS:

• Usando o assistente do console do AWS DMS
• Usando o console do AWS DMS para atualizar manualmente as configurações no editor JSON
• Usando a AWS Command Line Interface (AWS CLI)

Observação: se você receber erros ao executar comandos da AWS CLI, certifique-se de estar usando a versão mais recente da AWS CLI.

Resolução

Use o assistente de console da AWS

1.    Abra o console do AWS DMS e escolha Database migration tasks (Tarefas de migração de banco de dados) no painel de navegação.

2.    Escolha sua tarefa.

3.    Em Task Setting (Configuração de tarefas), para o modo Editing (Edição), selecioneWizard (Assistente).

4.    Confirme se a caixa de seleção Enable CloudWatch logs(Ativar logs do CloudWatch) está marcada.

5.    Altere a Severity (Severidade) dos cinco registradores padrão na lista suspensa, conforme necessário.

Na próxima vez que você executar essa tarefa, você receberá logs de depuração detalhados.

Observação: além dos cinco registradores padrão disponíveis no console do AWS DMS, você pode ativar a depuração detalhada para todos os registradores do AWS DMS. Para fazer isso, modifique a tarefa. No editor JSON de configurações de tarefas, para LogComponents, altere a Severity (Severidade) conforme necessário.

Usando o console da AWS para atualizar manualmente as configurações no editor JSON

Observação: você pode ativar a depuração detalhada usando o console do AWS DMS ao criar ou modificar uma tarefa do DMS. Para fazer isso, acesse o editor JSON nas Task settings (Configurações de tarefas). Para LogComponents, altere a Severity (Severidade), conforme necessário.

Para monitorar sua tarefa do AWS DMS, você pode modificar as configurações da tarefa de registro em log e especificar quais atividades do componente e valores de severidade são registrados. O exemplo a seguir usa o nível mais detalhado de registro em log de depuração: LOGGER_SEVERITY_DETAILED_DEBUG. O registro em log detalhado de depuração requer uma grande quantidade de espaço de armazenamento. Se você estiver usando a replicação contínua, também conhecida como captura de dados de alteração (CDC), as entradas de log podem consumir o restante do seu espaço de armazenamento.

1.    Abra o console do AWS DMS e escolha Database migration tasks (Tarefas de migração de banco de dados) no painel de navegação.

2.    Escolha sua tarefa.

3.    Na seção Overview details (Detalhes da visão geral), expanda a seção Task Settings (JSON) (Configurações da tarefa (JSON)). Em seguida, copie e cole a seçãoLogging (Registro em log) das configurações da tarefa em um editor JSON.

4.     Edite a configuração deSeverity (Severidade) de cada componente de log que você deseja ativar o registro detalhado de depuração. Para definir a severidade, substitua LOGGER_SEVERITY_DEFAULT por LOGGER_SEVERITY_DETAILED_DEBUG.

Por exemplo:

{
 "Logging": {
  "EnableLogging": true,
  "LogComponents": [{
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "TRANSFORMATION"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEBUG",
    "Id": "SOURCE_UNLOAD"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "IO"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "TARGET_LOAD"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "PERFORMANCE"
   },
   {
    "Severity": "LOGGER_SEVERITY_DETAILED_DEBUG",
    "Id": "SOURCE_CAPTURE"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "SORTER"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "REST_SERVER"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "VALIDATOR_EXT"
   },
   {
    "Severity": " LOGGER_SEVERITY_INFO",
    "Id": "TARGET_APPLY"
   },
   {
    "Severity": " LOGGER_SEVERITY_DEBUG",
    "Id": "TASK_MANAGER"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "TABLES_MANAGER"
   },
   {
    "Severity": "LOGGER_SEVERITY_DETAILED_DEBUG",
    "Id": "METADATA_MANAGER"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "FILE_FACTORY"
   },
   {
    "Severity": "LOGGER_SEVERITY_DETAILED_DEBUG ",
    "Id": "COMMON"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "ADDONS"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "DATA_STRUCTURE"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "COMMUNICATION"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "FILE_TRANSFER"
   }
  ],
  "CloudWatchLogGroup": null,
  "CloudWatchLogStream": null
 }
}

5.     Escolha Save (Salvar).

Usando a AWS CLI

1.    Instale e configure a versão mais recente da AWS CLI.

2.    Abra o console do AWS DMS e escolha Database migration tasks (Tarefas de migração de banco de dados) no painel de navegação.

3.    Escolha sua tarefa. Escolha a guia Overview (Visão geral).

4.    Copie as Task Settings (JSON) (Configurações de tarefas (JSON)) e salve-as localmente como um arquivo .json.

5.    Ative o registro em log do CloudWatch.

6.    Execute o comando modify-replication-task da AWS CLI, usando seuTask ARN (ARN de tarefas) e as configurações de JSON que você salvou na etapa.

Observação: nos exemplos a seguir, substitua your-task-settings.json pelo nome do arquivo salvo. Exemplo de Linux:

aws dms modify-replication-task --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:2PVREMWNPGYJCVU2IBPTOYTIV4 --replication-task-settings file://your-task-settings.json

Exemplo do Windows:

aws dms modify-replication-task --replication-task-arn arn:aws:dms:us-east-1:123456789012:task:2PVREMWNPGYJCVU2IBPTOYTIV4 --replication-task-settings file://"c:\temp\your-task-settings.json"

Observação: Para encontrar seu Task ARN (ARN de tarefa), abra o console do AWS DMS e escolha Database migration tasks (Tarefas de migração de banco) de dados no painel de navegação. O Task ARN (ARN da tarefa) aparece na seção details (detalhes) da Overview (Visão geral). Para obter mais informações, consulte Constructing an Amazon Resource Name (ARN) for AWS DMS (Como criar um nome do recurso da Amazon (ARN) para o AWS DMS).

7.    Abra o console do AWS DMS e, no painel de navegação, escolha Database migration tasks (Tarefas de migração de banco de dados).

8.    Confirme se o status da tarefa é Modifying (Em modificação).

9.    Na seção Overview details (Detalhes da visão geral) da sua tarefa, em Task Settings (Configurações da tarefa), confirme se a configuração de Severity (Severidade) é LOGGER_SEVERITY_DETAILED_DEBUG para cada componente de registro que você modificou.

Na próxima vez que você executar essa tarefa, você receberá logs de depuração detalhados.

---

Informações relacionadas

Visualização e gerenciamento de registros de tarefas do AWS DMS