AWSSupport-TroubleshootDMSTableErrors - AWS Systems Manager Referencia del manual de automatización

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWSSupport-TroubleshootDMSTableErrors

Descripción

El manual de AWS Systems Manager AWSSuport-TroubleshootDMSTabelErrors automatización le ayuda a automatizar el proceso de solución de problemas en las tareas de migración de Table errors bases de datos o en la replicación sin servidor desde. AWS Database Migration Service Estos errores se producen cuando las tablas no se migran del punto final de origen (base de datos de origen) al punto final de destino (base de datos de destino) debido a la tarea de migración de la base de datos o a la replicación sin servidor creada en el servicio. AWS DMS Este manual analiza los mensajes de error de firma de los registros y se centra específicamente en CloudWatch los registros de tareas para las tareas tradicionales de migración de bases de datos y en los registros sin servidor para la replicación sin servidor. También proporciona sugerencias específicas y medidas de corrección para los mensajes de error más comunes que aparecen durante las migraciones. Table error AWS DMS

¿Cómo funciona?

El manual de ejecución lleva a cabo los siguientes pasos:

  • Obtiene información sobre el AWS DMS ARN proporcionado, que puede ser una tarea de migración de base de datos o una replicación sin servidor.

  • Comprueba si el AWS DMS recurso proporcionado se ha iniciado al menos una vez comprobando el FreshStartDate valor en la respuesta de la DescribeReplicationTasks API (para la tarea de migración de la base de datos) y de la DescribeReplications API (para la replicación sin servidor). Si el recurso no se ha iniciado, la automatización genera un error.

  • Si el recurso se ha iniciado, la automatización comprueba las tablas de los TableError estados utilizando TableStatistics información. Si no se encuentra ningún error, la automatización finaliza el flujo de trabajo después de mostrar un mensaje que confirma que no se ha encontrado ningún error en la tabla en la tarea de migración de la base de datos especificada o en la replicación sin servidor.

  • Si se encuentran tablas con TableError estados, la automatización comprueba si el CloudWatch registro está habilitado para el AWS DMS recurso especificado. Si el registro no está habilitado, la automatización finaliza el flujo de trabajo después de mostrar un mensaje que indica que el registro no está habilitado.

    Nota: se espera que el CloudWatch registro esté habilitado, ya que la automatización se basa en estos registros para analizar e identificar los problemas relacionados con las tablas en TableError estado.

  • Si el registro está habilitado, la automatización analiza los CloudWatch registros y genera un informe para cada tabla que esté en TableError estado. El informe incluye sugerencias sobre los mensajes de error más comunes y proporciona los registros de errores pertinentes para ayudar a identificar y resolver los problemas que impiden la correcta migración de la tabla del punto final de AWS DMS origen al punto final de AWS DMS destino.

Ejecuta esta automatización (consola)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

/

Parámetros

  • AutomationAssumeRole

    Tipo: cadena

    Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.

  • DMSArn

    Tipo: cadena

    Descripción: (obligatorio) ARN de la tarea de migración de la base de datos o replicación sin servidor

    Valor permitido: ^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: cadena

    Descripción: (opcional) Este parámetro define el inicio del intervalo de tiempo para el análisis de los CloudWatch registros de la tarea de migración de la base de datos o la replicación sin servidor determinada. Si se proporciona, solo se recopilarán y analizarán los registros generados a partir de ese momento específico. Tenga en cuenta que existe la posibilidad de que se agote el tiempo de espera del flujo de trabajo si el intervalo de tiempo entre startDate y endDate es demasiado largo. El valor debe proporcionarse en formato de fecha y hora ISO 6081.

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

  • EndTimeRange

    Tipo: cadena

    Descripción: (opcional) Este parámetro establece el final del intervalo de tiempo para el análisis del CloudWatch registro de la tarea de migración de la base de datos determinada o la replicación sin servidor. Si se proporciona, solo se recopilarán y analizarán los registros generados hasta ese momento específico. Tenga en cuenta que existe la posibilidad de que se agote el tiempo de espera del flujo de trabajo si el intervalo de tiempo entre startDate y endDate es demasiado largo. El valor debe proporcionarse en formato de fecha y hora ISO 6081.

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

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

  • dms:DescribeReplicationTasks

  • dms:DescribeReplications

  • dms:DescribeEndpoints

  • dms:DescribeReplicationConfigs

  • dms:DescribeTableStatistics

  • dms:DescribeReplicationTableStatistics

  • logs:FilterLogEvents

Ejemplo de política de IAM para el rol 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": "*"
                    }
                ]
            }

Instrucciones

Siga estos pasos para configurar la automatización:

  1. Navegue hasta AWSSupport-TroubleshootDMSTableErrorsSystems Manager, en Documentos.

  2. Elija Execute automation (Ejecutar automatización).

  3. Para los parámetros de entrada, introduzca lo siguiente:

    • AutomationAssumeRole (Opcional):

      El nombre del recurso de Amazon (ARN) del rol AWS AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que inicia este runbook.

    • DMSArn

      ARN de la tarea de migración de la base de datos o la replicación sin servidor que tiene errores de tabla.

    • StartTimeRange

      (Opcional) Formato de fecha y hora ISO 6081 que define el inicio del intervalo de tiempo para analizar los CloudWatch registros de la tarea de migración de la base de datos determinada o la replicación sin servidor.

    • EndTimeRange

      (Opcional) Formato de fecha y hora ISO 6081 que define el final del intervalo de tiempo para analizar los CloudWatch registros de la tarea de migración de la base de datos en cuestión o de la replicación sin servidor.

  4. Seleccione el botón Ejecutar en la parte inferior de la página.

  5. Se inicia la automatización.

  6. Este documento realiza los siguientes pasos:

    • validar DMSInput TypeAndGatherDetails

      Valida la entrada del AWS DMS ARN dada y recopila los detalles básicos de la tarea de migración de la base de datos o la replicación sin servidor que se requieren en los siguientes pasos.

    • branchOnTableErrores

      Ramifica el flujo de trabajo en función del número de errores de tabla encontrados en el paso anterior. Si el recuento es superior a 0, continúe con el branchOnCWLoggingStatus paso -. De lo contrario, continúe con el outputNoTableErrors paso -.

    • outputNoTableErrores

      Muestra un mensaje que indica que los errores de la tabla no se encuentran en la tarea de migración de la base de datos determinada o en la replicación sin servidor.

    • Estado de BranchOn CWLogging

      Ramifica el flujo de trabajo en función del estado de CloudWatch registro que se encuentra en el paso anterior. Si está activado, continúe con el gatherTableDetails paso -. De lo contrario, continúe con el outputNoCWLoggingEnabled paso -.

    • Salida No habilitada CWLogging

      Muestra un mensaje que indica que el CloudWatch registro no está habilitado en la tarea de migración de la base de datos o en la replicación sin servidor en cuestión.

    • gatherTableDetails

      Recopila las FullLoadEndTime marcas temporales de las tablas fallidas y calcula los valores del intervalo de tiempo para analizar los registros. CloudWatch

    • analyzeCloudWatchRegistros

      Analiza los registros que se encuentran en el grupo de CloudWatch registros en función de los mensajes de error de firma y devuelve el informe al usuario.

  7. Una vez completada la ejecución, revise la sección de resultados para ver los resultados detallados de la ejecución.

    • Se encontraron errores en el resultado de No hay ninguna tabla

      Si no se encuentra ningún error de tabla en la tarea de migración de base de datos proporcionada o en la replicación sin servidor, la automatización muestra el resultado con el mismo mensaje.

    • Resultado de No se ha activado el inicio de CloudWatch sesión

      Si el CloudWatch registro no está habilitado en la tarea de migración de bases de datos proporcionada o en la replicación sin servidor, la automatización muestra el resultado que indica lo mismo y proporciona los pasos para habilitar el registro.

    • Informe de análisis de registros

      Genera un informe que identifica las tablas en Table error estado correspondientes a la tarea de migración de bases de datos proporcionada o a la replicación sin servidor, diferenciando los tipos de error, enumerando los mensajes de error encontrados y proporcionando sugerencias y pasos de corrección específicos para cada tabla identificada.

Referencias

Automatización de Systems Manager