Comment puis-je configurer la journalisation de débogage détaillée pour ma tâche AWS DMS ?

Date de la dernière mise à jour : 13/03/2020

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 ?

Résolution

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 de 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 Détails, développez la sous-section Paramètres de tâche (JSON), puis copiez et collez le contenu de la section 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 Journalisation. Si vous souhaitez modifier un autre paramètre, interrompez la tâche concernée avant de la modifier.

4.    Modifiez le paramètre Gravité de chaque composant de journal pour lequel vous souhaitez activer la journalisation de débogage détaillée 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 destinés uniquement aux tâches de chargement complet. « SOURCE_CAPTURE » et « TARGET_APPLY » sont destinés aux 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 version la plus récente de l'interface de ligne de commande AWS (CLI AWS).

7.    Exécutez la commande de l'interface de ligne de commande AWS modify-replication-task à l'aide de l'ARN de votre tâche et du chemin d'accès au fichier que vous avez enregistré à l'étape cinq.

Exemple 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 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 sélectionnez 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 (Détails de la vue d'ensemble. Pour plus d'informations, consultez la section Création d'un Amazon Resource Name (ARN) pour AWS DMS.

8.    Ouvrez la console AWS DMS, puis sélectionnez 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 (Détails de la vue d'ensemble) de votre tâche, sous Task Settings (Paramètres de la tâche), vérifiez que le paramètre 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és.