View a markdown version of this page

AWSSupport-TroubleshootDMSTableErrors - AWS Systems Manager Référence du dossier d’exploitation Automation

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWSSupport-TroubleshootDMSTableErrors

Description

Le runbook AWS Systems Manager AWSSuport-TroubleshootDMSTableErrors d'automatisation vous aide à automatiser le processus de résolution des problèmes liés à la tâche de Table errors migration de base de données ou à la réplication sans serveur depuis. AWS Database Migration Service Ces erreurs se produisent lorsque les tables ne parviennent pas à migrer du point de terminaison source (base de données source) vers le point de terminaison cible (base de données cible) par la tâche de migration de base de données ou la réplication sans serveur créée en AWS DMS service. Ce runbook analyse les messages d'erreur de signature des CloudWatch journaux, en se concentrant en particulier sur les journaux de tâches pour les tâches de migration de base de données traditionnelles et les journaux sans serveur pour la réplication sans serveur. Il fournit également des suggestions ciblées et des étapes de correction pour les messages d'erreur courants rencontrés Table error lors des AWS DMS migrations.

Fonctionnement

Le runbook exécute les étapes suivantes :

  • Récupère des informations sur l' AWS DMS ARN fourni, qui peut être une tâche de migration de base de données ou une réplication sans serveur.

  • Vérifie si la AWS DMS ressource fournie a été démarrée au moins une fois en vérifiant la FreshStartDate valeur dans la réponse de l' DescribeReplicationTasks API (pour la tâche de migration de base de données) et de DescribeReplications l'API (pour la réplication sans serveur). Si la ressource n'a pas démarré, l'automatisation génère une erreur.

  • Si la ressource a démarré, l'automatisation vérifie la présence des tables dans les TableError états à l'aide TableStatistics des informations. Si aucune erreur n'est détectée, l'automatisation met fin au flux de travail après avoir affiché un message confirmant qu'aucune erreur de table n'a été trouvée dans la tâche de migration de base de données ou la réplication sans serveur spécifiée.

  • Si des tables contenant un TableError état sont trouvées, l'automatisation vérifie si la CloudWatch journalisation est activée pour la AWS DMS ressource spécifiée. Si la journalisation n'est pas activée, l'automatisation met fin au flux de travail après avoir affiché un message indiquant que la journalisation n'est pas activée.

    Remarque : la CloudWatch journalisation devrait être activée, car l'automatisation s'appuie sur ces journaux pour analyser et identifier les problèmes liés à l'TableErrorétat des tables.

  • Si la journalisation est activée, l'automatisation analyse les CloudWatch journaux et génère un rapport pour chaque table qui est en TableError état. Le rapport inclut des suggestions pour les messages d'erreur courants et fournit des journaux d'erreurs pertinents pour aider à identifier et à résoudre les problèmes empêchant la réussite de la migration des tables du point de terminaison AWS DMS source vers le point de terminaison AWS DMS cible.

Exécutez cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

/

Paramètres

  • AutomationAssumeRole

    Type : Chaîne

    Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook.

  • DSM SARN

    Type : Chaîne

    Description : ARN (obligatoire) de la tâche de migration de base de données ou de la réplication sans serveur

    Schéma autorisé : ^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

    Type : Chaîne

    Description : (Facultatif) Ce paramètre définit le début de la plage de temps pour l'analyse des CloudWatch journaux de la tâche de migration de base de données ou de la réplication sans serveur donnée. Lorsqu'ils sont fournis, seuls les journaux générés à partir de ce moment précis seront collectés et analysés. Veuillez noter qu'il est possible que le flux de travail expire si l'intervalle de temps entre le startDate et endDate est trop long. La valeur doit être fournie au format date/heure ISO 6081.

    Schéma autorisé : ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

  • EndTimeRange

    Type : Chaîne

    Description : (Facultatif) Ce paramètre définit la fin de la plage de temps pour l'analyse du CloudWatch journal de la tâche de migration de base de données ou de la réplication sans serveur donnée. Lorsqu'ils sont fournis, seuls les journaux générés jusqu'à ce moment précis seront collectés et analysés. Veuillez noter qu'il est possible que le flux de travail expire si l'intervalle de temps entre le startDate et endDate est trop long. La valeur doit être fournie au format date/heure ISO 6081.

    Schéma autorisé : ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

Autorisations IAM requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

  • dms:DescribeReplicationTasks

  • dms:DescribeReplications

  • dms:DescribeEndpoints

  • dms:DescribeReplicationConfigs

  • dms:DescribeTableStatistics

  • dms:DescribeReplicationTableStatistics

  • logs:FilterLogEvents

Exemple de politique IAM pour le rôle Automation Assume

JSON

            {
                "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": "*"
                    }
                ]
            }

Instructions

Pour configurer l'automatisation, procédez comme suit :

  1. Accédez à AWSSupport-TroubleshootDMSTableErrors la section Documents dans Systems Manager.

  2. Sélectionnez Execute automation (Exécuter l'automatisation).

  3. Pour les paramètres d'entrée, entrez les informations suivantes :

    • AutomationAssumeRole (Facultatif) :

      Le nom de ressource Amazon (ARN) du rôle AWS Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui démarre ce runbook.

    • DSM SARN

      ARN de la tâche de migration de base de données ou de la réplication sans serveur contenant des erreurs de table.

    • StartTimeRange

      (Facultatif) Format de date et d'heure ISO 6081 définissant le début de la plage horaire pour l'analyse des CloudWatch journaux de la tâche de migration de base de données ou de la réplication sans serveur donnée.

    • EndTimeRange

      (Facultatif) Format de date et d'heure ISO 6081 définissant la fin de la plage de temps pour l'analyse des CloudWatch journaux de la tâche de migration de base de données ou de la réplication sans serveur donnée.

  4. Sélectionnez le bouton Exécuter en bas de la page.

  5. L'automatisation démarre.

  6. Le document exécute les étapes suivantes :

    • valider DMSInputTypeAndGatherDetails

      Valide l'entrée AWS DMS ARN donnée et rassemble les informations de base relatives à la tâche de migration de base de données ou à la réplication sans serveur qui sont requises dans les étapes suivantes.

    • succursale OnTableErrors

      Branche le flux de travail en fonction du nombre d'erreurs de table détectées à l'étape ci-dessus. Si le nombre est supérieur à 0, passez à l'branchOnCWLoggingStatusétape -. Sinon, passez à l'outputNoTableErrorsétape -.

    • outputNoTableErrors

      Afficher un message indiquant que les erreurs de table ne sont pas détectées dans la tâche de migration de base de données ou la réplication sans serveur donnée.

    • succursale OnCWLoggingStatus

      Branche le flux de travail en fonction de l'état de CloudWatch journalisation indiqué à l'étape ci-dessus. Si cette option est activée, passez à l'gatherTableDetailsétape -. Sinon, passez à l'outputNoCWLoggingEnabledétape -.

    • outputNoCWLoggingEnabled

      Affiche un message indiquant que la CloudWatch journalisation n'est pas activée dans la tâche de migration de base de données ou la réplication sans serveur donnée.

    • rassembler TableDetails

      Rassemble les FullLoadEndTime horodatages des tables ayant échoué et calcule les valeurs des plages temporelles pour analyser les journaux. CloudWatch

    • analyser CloudWatchLogs

      Analyse les journaux trouvés dans le groupe de CloudWatch journaux en fonction des messages d'erreur de signature et renvoie le rapport à l'utilisateur.

  7. Une fois l'exécution terminée, consultez la section Sorties pour obtenir les résultats détaillés de l'exécution.

    • Sortie de Aucune erreur de table trouvée

      Si aucune erreur de table n'est détectée dans la tâche de migration de base de données ou la réplication sans serveur fournie, l'automatisation affiche la sortie indiquant la même chose.

    • Sortie de No CloudWatch loggin enabled

      Si la CloudWatch journalisation n'est pas activée dans la tâche de migration de base de données ou la réplication sans serveur fournie, l'automatisation affiche la même sortie et fournit les étapes pour activer la journalisation.

    • Rapport d'analyse des journaux

      Génère un rapport qui identifie les tables dont Table error l'état provient d'une tâche de migration de base de données fournie ou d'une réplication sans serveur, en différenciant les types d'erreur, en répertoriant les messages d'erreur rencontrés et en fournissant des étapes de correction ciblées et des suggestions pour chaque table identifiée.

Références

Systems Manager Automation