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

Lecture de 5 minute(s)
0

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 ?

Brève description

Il existe trois manières d'activer la journalisation détaillée des débogues pour une tâche AWS DMS :

  • Avec la console AWS DMS
  • Avec la console AWS DMS pour mettre à jour manuellement les paramètres dans l'éditeur JSON
  • Utilisation de l'interface de ligne de commande AWS (AWS CLI)

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

Solution

Utiliser l'assistant de console AWS

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.    Sous Réglage des tâches, pour le mode Édition, sélectionnez Assistant.

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

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

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

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

Utilisation de la console AWS pour mettre à jour manuellement les paramètres dans l'éditeur JSON

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 » (Détails de présentation) agrandissez la section « Task settings (JSON) » (Paramètres de tâche (JSON)). Copiez et collez ensuite la section Journalisation des paramètres des tâches dans un éditeur JSON.

4.     Modifiez le paramètre de gravité de chaque composant du journal pour lequel vous souhaitez activer la journalisation détaillée des débogues. Pour définir la gravité, remplacez LOGGER_SEVERITY_DEFAULT par LOGGER_SEVERITY_DETAILED_DEBUG.

Par exemple :

{
 "Logging": {
  "EnableLogging": true,
  "LogComponents": [{
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "TRANSFORMATION"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEBUG",
    "Id": "SOURCE_UNLOAD"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "IO"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "TARGET_LOAD"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "PERFORMANCE"
   },
   {
    "Severity": "LOGGER_SEVERITY_DETAILED_DEBUG",
    "Id": "SOURCE_CAPTURE"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "SORTER"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "REST_SERVER"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "VALIDATOR_EXT"
   },
   {
    "Severity": " LOGGER_SEVERITY_INFO",
    "Id": "TARGET_APPLY"
   },
   {
    "Severity": " LOGGER_SEVERITY_DEBUG",
    "Id": "TASK_MANAGER"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "TABLES_MANAGER"
   },
   {
    "Severity": "LOGGER_SEVERITY_DETAILED_DEBUG",
    "Id": "METADATA_MANAGER"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "FILE_FACTORY"
   },
   {
    "Severity": "LOGGER_SEVERITY_DETAILED_DEBUG ",
    "Id": "COMMON"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "ADDONS"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "DATA_STRUCTURE"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "COMMUNICATION"
   },
   {
    "Severity": "LOGGER_SEVERITY_DEFAULT",
    "Id": "FILE_TRANSFER"
   }
  ],
  "CloudWatchLogGroup": null,
  "CloudWatchLogStream": null
 }
}

5.     Choisissez Enregistrer.

Utilisation d’AWS CLI

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

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

3.    Sélectionnez votre tâche. Puis, choisissez l'onglet Overview (Aperçu).

4.    Copiez les paramètres de tâche (JSON) et enregistrez-les localement sous forme de fichier .json.

5.    Activez la journalisation CloudWatch.

6.    Exécutez la commande CLI AWS modify-replication-task en utilisant votre ARN de tâche et les paramètres JSON enregistrés à l'étape.

Remarque : Dans les exemples suivants, remplacez your-task-settings.json par le nom de votre fichier enregistré. 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.

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

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

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


Informations connexes

Affichage et gestion des journaux de tâches AWS DMS

AWS OFFICIEL
AWS OFFICIELA mis à jour il y a un an