AWSSupport-TroubleshootDMSTableErrors - AWS Systems Manager Guide de référence du manuel d'automatisation

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 manuel AWS Systems Manager AWSSuport-TroubleshootDMSTabelErrors d'automatisation vous aide à automatiser le processus de résolution des problèmes liés à la tâche de migration Table errors de base de données ou à la réplication sans serveur à partir de. 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 le biais de la tâche de migration de base de données ou de la réplication sans serveur créée en AWS DMS service. Ce manuel analyse les messages d'erreur de signature provenant des CloudWatch journaux, en se concentrant spécifiquement sur les journaux des tâches pour les tâches de migration de base de données traditionnelles et sur 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.

Comment fonctionne-t-il ?

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é détectée dans la tâche de migration de base de données ou de réplication sans serveur spécifiée.

  • Si des tables avec 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 aux tables en TableError état.

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

Exécuter cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

/

Paramètres

  • AutomationAssumeRole

    Type : String

    Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle AWS Identity and Access Management (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 lance ce runbook.

  • DMSArn

    Type : String

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

    Modèle 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 : String

    Description : (Facultatif) Ce paramètre définit le début de la plage horaire pour l'analyse des CloudWatch journaux d'une tâche de migration de base de données ou d'une 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 startDate et endDate est trop long. La valeur doit être fournie au format de date et d'heure ISO 6081.

    Modèle autorisé : ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

  • EndTimeRange

    Type : String

    Description : (Facultatif) Ce paramètre définit 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 réplication sans serveur donnée. Lorsqu'ils sont fournis, seuls les journaux générés jusqu'à cette heure précise seront collectés et analysés. Veuillez noter qu'il est possible que le flux de travail expire si l'intervalle de temps entre startDate et endDate est trop long. La valeur doit être fournie au format de date et d'heure ISO 6081.

    Modèle 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 


            {
                "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à Systems Manager sous Documents.

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

  3. Pour les paramètres d'entrée, entrez ce qui suit :

    • AutomationAssumeRole (Facultatif) :

      Amazon Resource Name (ARN) du rôle AWS AWS Identity and Access Management (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 lance ce runbook.

    • DMSArn

      ARN de la tâche de migration de base de données ou de 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 d'une tâche de migration de base de données ou d'une réplication sans serveur donnée.

    • EndTimeRange

      (Facultatif) Format de date et d'heure ISO 6081 définissant la fin de la plage horaire pour l'analyse des CloudWatch journaux d'une tâche de migration de base de données ou d'une 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 DMSInput TypeAndGatherDetails

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

    • branchOnTableErreurs

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

    • outputNoTableErreurs

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

    • État de BranchOn CWLogging

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

    • Sortie non activée CWLogging

      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 de réplication sans serveur donnée.

    • gatherTableDetails

      Recueille les FullLoadEndTime horodatages des tables défaillantes et calcule les valeurs temporelles pour analyser les journaux. CloudWatch

    • analyzeCloudWatchJournaux

      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 connaître les résultats détaillés de l'exécution.

    • Sortie d'aucune erreur de table détectée

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

    • Sortie indiquant « Aucune CloudWatch connexion activée »

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

    • Rapport d'analyse du journal

      Produit un rapport qui identifie les tables en Table error état à partir de la tâche de migration de base de données ou de la réplication sans serveur fournie, 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