¿Cómo configuro el registro detallado de depuración para mi tarea de AWS DMS?

Descripción breve

Hay tres maneras de activar el registro detallado de depuración para una tarea de AWS DMS:

• Usando el asistente de la consola de AWS DMS
• Usando la consola de AWS DMS para actualizar manualmente la configuración en el editor JSON
• Usando la interfaz de la línea de comandos de AWS (CLI de AWS)

Nota: Si recibe errores al ejecutar comandos de AWS CLI, asegúrese de que está utilizando la versión más reciente de AWS CLI.

Resolución

Uso del asistente de consola de AWS

1.    Abra la consola de AWS DMS y, a continuación, en el panel de navegación, elija Database migration tasks (Tareas de migración de bases de datos).

2.    Elija la tarea.

3.    En Task Setting (Configuración de tareas), para el modo Editing (Edición), seleccione Wizard (Asistente).

4.    Confirme que la casilla Enable CloudWatch logs (Activar registros de CloudWatch) esté seleccionada.

5.    Cambie la gravedad de los cinco registradores estándar en la lista desplegable, según sea necesario.

La próxima vez que ejecute esta tarea, obtendrá registros detallados de depuración.

Nota: Además de los cinco registradores estándar disponibles en la consola de AWS DMS, puede activar la depuración detallada para todos los registradores de AWS DMS. Para ello, modifique la tarea. En el editor JSON de configuración de tareas, para LogComponents, modifique la gravedad según sea necesario.

Uso de la consola de AWS para actualizar manualmente la configuración en el editor JSON

Nota: Puede activar la depuración detallada mediante la consola de AWS DMS al crear o modificar una tarea de DMS. Para ello, acceda al editor de JSON en Task settings (Configuración de tareas). En LogComponents, modifique la gravedad según sea necesario.

Para monitorear la tarea de AWS DMS, puede modificar la configuración de la tarea de registro y especificar qué actividades de los componentes y los valores de gravedad se registran. El siguiente ejemplo utiliza el nivel más detallado de registro de depuración: LOGGER_SEVERITY_DETAILED_DEBUG. El registro detallado de depuración requiere una gran cantidad de espacio de almacenamiento. Si está utilizando la replicación continua, también conocida como captura de datos de cambios (CDC), las entradas de registro podrían consumir el resto del espacio de almacenamiento.

1.    Abra la consola de AWS DMS y, a continuación, en el panel de navegación, elija Database migration tasks (Tareas de migración de bases de datos).

2.    Elija la tarea.

3.    En la sección Overview details (Detalles generales), amplíe la sección Task Settings (JSON) (Configuración de tareas [JSON]). A continuación, copie y pegue la sección Logging (Registro) de la configuración de tareas en un editor JSON.

4.     Edite la configuración de gravedad de cada componente de registro que desee activar el registro de depuración detallado. Para establecer la gravedad, sustituya LOGGER_SEVERITY_DEFAULT por LOGGER_SEVERITY_DETAILED_DEBUG.

Por ejemplo:

{
 "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.     Elija Save (Guardar).

Mediante AWS CLI

1.    Instale y configure la versión más reciente de la CLI de AWS.

2.    Abra la consola de AWS DMS y, a continuación, en el panel de navegación, elija Database migration tasks (Tareas de migración de bases de datos).

3.    Elija la tarea. Elija la pestaña Overview (Información general).

4.    Copie la configuración de tareas (JSON) y guárdela localmente como un archivo .json.

5.    Active el registro de CloudWatch.

6.    Ejecute el comando modifi-replication-task de la CLI de AWS utilizando el ARN de la tarea y la configuración de JSON que guardó paso a paso.

Nota: En los siguientes ejemplos, sustituya your-task-settings.json por el nombre del archivo guardado. Ejemplo 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

Ejemplo de 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"

Nota: Para encontrar el ARN de su tarea, abra la consola de AWS DMS y elija Database migration tasks (Tareas de migración de bases de datos) en el panel de navegación. El ARN de la tarea aparece en la sección Overview details (Detalles generales). Para obtener más información, consulte Constructing an Amazon Resource Name (ARN) for AWS DMS (Creación de un nombre de recurso de Amazon [ARN] para AWS DMS).

7.    Abra la consola de AWS DMS y, a continuación, en el panel de navegación, elija Database migration tasks (Tareas de migración de bases de datos).

8.    Confirme que el estado de la tarea es Modificando.

9.    En la sección Overview details (Detalles generales) de la tarea, en Task Settings (Configuración de tareas), confirme que la configuración de gravedad sea LOGGER_SEVERITY_DETAILED_DEBUG para cada componente de registro que haya modificado.

La próxima vez que ejecute esta tarea, obtendrá registros detallados de depuración.

---

Información relacionada

Viewing and managing AWS DMS task logs (Visualización y administración de registros de tareas de AWS DMS)