Comment configurer la journalisation du débogage détaillé pour ma tâche AWS DMS ?

Dernière mise à jour : 10/02/2021

Quels types de journalisation sont disponibles pour les tâches AWS Database Migration Service (AWS DMS) ? Comment activer la journalisation de débogage détaillée pour une tâche AWS DMS ?

Solution

Remarque : si vous recevez des erreurs lors de l'exécution de commandes depuis l'interface de ligne de commande (CLI) AWS, assurez-vous d'utiliser la version la plus récente de l’interface.

Activation du débogage pour une tâche AWS DMS

Remarque : vous pouvez désormais activer le débogage détaillé à l'aide de la console AWS DMS lorsque vous créez ou modifiez une tâche DMS. Pour ce faire, accédez à l'éditeur JSON dans vos paramètres de tâche. Pour LogComponents, modifiez la gravité, selon les besoins.

Pour surveiller votre tâche AWS DMS, vous pouvez modifier les paramètres de la tâche de journalisation pour spécifier les activités de composant et les valeurs de gravité qui sont consignées. L'exemple suivant utilise le niveau le plus détaillé de journalisation du débogage : LOGGER_SEVERITY_DETAILED_DEBUG. La journalisation de débogage détaillée nécessite une grande quantité d'espace de stockage. Si vous utilisez la réplication continue, également appelée capture des données modifiées (CDC), les entrées de journal peuvent consommer le reste de votre espace de stockage.

1.    Ouvrez la console AWS DMS, puis choisissez Database migration tasks (Tâches de migration de base de données) dans le volet de navigation.

2.    Sélectionnez votre tâche.

3.    Dans la section Overview details (Informations générales), développez la sous-section Task Settings (JSON) (Paramètres de tâche (JSON), puis copiez et collez le contenu de la section Logging (Journalisation) dans un éditeur JSON.

Remarque : si votre tâche AWS DMS est en cours d'exécution, vous ne pouvez modifier que le paramètre de tâche Logging (Journalisation). Si vous souhaitez modifier un autre paramètre, de tâche interrompez la tâche avant de la modifier.

4.    Modifiez le paramètre Severity (Gravité) de chaque composant du journal pour lequel vous souhaitez activer la journalisation du débogage détaillé en remplaçant LOGGER_SEVERITY_DEFAULT (ou tout autre paramètre) par LOGGER_SEVERITY_DETAILED_DEBUG. Les composants de journal SOURCE_UNLOAD et TARGET_LOAD sont utilisés uniquement pour les tâches de chargement complètes. SOURCE_CAPTURE et TARGET_APPLY sont utilisés pour les tâches de réplication continue (CDC).

Exemple

{
    "Logging": {
        "EnableLogging": true,
        "LogComponents": [{
                "Id": "SOURCE_UNLOAD",
                "Severity": "LOGGER_SEVERITY_DEFAULT"
            },
            {
                "Id": "TARGET_LOAD",
                "Severity": "LOGGER_SEVERITY_DEBUG"
            },
            {
                "Id": "SOURCE_CAPTURE",
                "Severity": "LOGGER_SEVERITY_DEFAULT"
            },
            {
                "Id": "TARGET_APPLY",
                "Severity": "LOGGER_SEVERITY_DETAILED_DEBUG"
            },
            {
                "Id": "TASK_MANAGER",
                "Severity": "LOGGER_SEVERITY_DEFAULT"
            }
        ],
        "CloudWatchLogGroup": "dms-tasks-xxxx",
        "CloudWatchLogStream": "dms-task-xxxxx"
    }
}

5.    Enregistrez le fichier JSON et notez l'ARN de la tâche, ainsi que le chemin d'accès au fichier en vue d'une utilisation ultérieure.

6.    Installez et configurez la dernière version de l'interface de ligne de commande (CLI) AWS.

7.    Exécutez la commande CLI AWS modify-replication-task en utilisant votre ARN de tâche et le chemin du fichier enregistré à l'étape cinq.

Exemple pour 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

Exemple pour 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"

Remarque : pour trouver l'ARN de votre tâche ouvrez la console AWS DMS, puis choisissez Database migration tasks (Tâches de migration de base de données) dans le volet de navigation. L'ARN de la tâche s'affiche dans la section Overview details (Informations générales). Pour plus d'informations, consultez Création d'un Amazon Resource Name (ARN) pour AWS DMS.

8.    Ouvrez la console d'AWS DMS, puis choisissez Database migration tasks (Tâches de migration de base de données) dans le volet de navigation.

9.    Vérifiez que le statut de la tâche est Modification.

10.    Dans la section Overview details (Informations générales) de votre tâche, sous Task Settings (Paramètres de la tâche), vérifiez que le paramètre Severity (Gravité) est LOGGER_SEVERITY_DETAILED_DEBUG pour chaque composant de journal que vous avez modifié.

La prochaine fois que vous exécuterez cette tâche, vous obtiendrez des journaux de débogage détaillé.

Modification d'une tâche existante pour activer le débogage

Vous pouvez également modifier une tâche existante pour activer le débogage détaillé.

1.    Modifiez la tâche AWS DMS.

2.    Vérifiez que la case Enable CloudWatch logs (Activer les journaux CloudWatch) est cochée.

3.    Modifiez la gravité des cinq enregistreurs standard dans la liste déroulante, selon les besoins.

Remarque : vous pouvez activer le débogage détaillé pour tous les enregistreurs AWS DMS, pas seulement pour les cinq enregistreurs standard disponibles dans la console AWS DMS. Pour ce faire, modifiez la tâche, puis à partir des paramètres de la tâche, dans l'éditeur JSON, pour LogComponents, modifiez la gravité selon vos besoins.


Cet article vous a-t-il été utile ?


Besoin d'aide pour une question technique ou de facturation ?