Paramètres de la tâche de journalisation

La journalisation utilise Amazon CloudWatch pour enregistrer les informations pendant le processus de migration. Les paramètres de tâche de journalisation vous permettent de spécifier les activités de composant qui sont consignées et la quantité d'informations écrites dans le journal. Les paramètres de tâche de journalisation sont écrits dans un fichier JSON. Pour en savoir plus sur l’utilisation d’un fichier de configuration de tâche pour définir les paramètres d’une tâche, consultez Exemple de paramètres de tâche.

Vous pouvez activer la CloudWatch journalisation de différentes manières. Vous pouvez sélectionner l'EnableLoggingoption AWS Management Console lorsque vous créez une tâche de migration. Vous pouvez également définir l'EnableLoggingoption sur true lorsque vous créez une tâche à l'aide de l' AWS DMS API. Vous pouvez également spécifier "EnableLogging": true dans le code JSON de la section de journalisation des paramètres de la tâche.

Lorsque vous définissez surtrue, EnableLogging AWS DMS assignez le nom du CloudWatch groupe et le nom du flux comme suit. Vous ne pouvez pas définir ces valeurs directement.

• CloudWatchLogGroup: dms-tasks-<REPLICATION_INSTANCE_IDENTIFIER>

• CloudWatchLogStream: dms-task-<REPLICATION_TASK_EXTERNAL_RESOURCE_ID>

<REPLICATION_INSTANCE_IDENTIFIER> est l’identifiant de l’instance de réplication. <REPLICATION_TASK_EXTERNAL_RESOURCE_ID> est la valeur de la section <resourcename> de l’ARN de tâche. Pour plus d'informations sur le mode AWS DMS de génération des ARN de ressources, consultezCréation d'un nom de ressource Amazon (ARN) pour AWS DMS.

CloudWatch s'intègre à AWS Identity and Access Management (IAM), et vous pouvez spécifier CloudWatch les actions qu'un utilisateur de votre AWS compte peut effectuer. Pour plus d'informations sur l'utilisation d'IAM dans CloudWatch, consultez Gestion des identités et des accès pour Amazon CloudWatch et Journalisation des appels d' CloudWatch API Amazon dans le guide de l' CloudWatch utilisateur Amazon.

Pour supprimer les journaux d'une tâche, vous pouvez définir DeleteTaskLogs sur true dans le code JSON de la section de journalisation des paramètres de la tâche.

Vous pouvez spécifier la journalisation pour les types d’événements suivants :

• FILE_FACTORY : la fabrique de fichiers gère les fichiers utilisés pour l’application et le chargement par lots, et gère les points de terminaison Amazon S3.

• METADATA_MANAGER : le gestionnaire de métadonnées gère les métadonnées sources et cibles, le partitionnement et l’état des tables pendant la réplication.

• SORTER : SORTER reçoit les événements entrants du processus SOURCE_CAPTURE. Les événements sont regroupés dans des transactions et transmis au composant de service TARGET_APPLY. Si le processus SOURCE_CAPTURE produit des événements plus rapidement que le composant TARGET_APPLY ne peut les consommer, le composant SORTER met en cache les événements en attente sur le disque ou dans un fichier d’échange. Les événements mis en cache sont une cause fréquente de manque d’espace de stockage dans les instances de réplication.

  Le composant de service SORTER gère les événements mis en cache, collecte les statistiques de CDC et signale le temps de latence des tâches.

• SOURCE_CAPTURE : les données de réplication continue (CDC) sont capturées à partir de la base de données ou du service source et sont transmises au composant de service SORTER.

• SOURCE_UNLOAD : les données sont déchargées de la base de données ou du service source pendant le chargement complet.

• TABLES_MANAGER : le gestionnaire de tables suit les tables capturées, gère l’ordre de migration des tables et collecte les statistiques des tables.

• TARGET_APPLY : les données et les instructions DDL sont appliquées à la base de données cible.

• TARGET_LOAD : les données sont chargées dans la base de données cible.

• TASK_MANAGER : le gestionnaire de tâches gère les tâches en cours et les décompose en sous-tâches pour le traitement parallèle des données.

• TRANSFORMATION : événements de transformation liés au mappage de table. Pour plus d’informations, consultez Utilisation du mappage de table pour spécifier des paramètres de tâche.

• VALIDATOR/ VALIDATOR_EXT : le composant de service VALIDATOR vérifie que les données ont été migrées correctement de la source vers la cible. Pour plus d’informations, consultez Validation des données.

Les composants de journalisation suivants génèrent un grand nombre de journaux lorsque le niveau de gravité des journaux LOGGER_SEVERITY_DETAILED_DEBUG est utilisé :

• COMMON

• ADDONS

• DATA_STRUCTURE

• COMMUNICATION

• FILE_TRANSFER

• FILE_FACTORY

Les niveaux de journalisation autres que DEFAULT sont rarement nécessaires pour ces composants lors du dépannage. Nous ne recommandons pas de modifier le niveau de journalisation DEFAULT pour ces composants, sauf demande spécifique du AWS Support.

Après avoir spécifié l'une des actions précédentes, vous pouvez spécifier la quantité d'informations consignées, comme indiqué dans la liste suivante.

Les niveaux de gravité sont dans l'ordre du plus bas au plus haut niveau d'information. Les niveaux supérieurs englobent toujours les informations des niveaux inférieurs.

• LOGGER_SEVERITY_ERROR : les messages d’erreur sont écrits dans le journal.

• LOGGER_SEVERITY_WARNING : les avertissements et les messages d’erreur sont écrits dans le journal.

• LOGGER_SEVERITY_INFO : les messages d’information, les avertissements et les messages d’erreur sont écrits dans le journal.

• LOGGER_SEVERITY_DEFAULT : les messages d’information, les avertissements et les messages d’erreur sont écrits dans le journal.

• LOGGER_SEVERITY_DEBUG : les messages de débogage, les messages d'information, les avertissements et les messages d'erreur sont écrits dans le journal.

• LOGGER_SEVERITY_DETAILED_DEBUG : toutes les informations sont écrites dans le journal.

L'exemple JSON suivant montre les paramètres de tâche pour consigner toutes les actions et tous les niveaux de gravité.

…
  "Logging": {
    "EnableLogging": true,
    "LogComponents": [
      {
        "Id": "FILE_FACTORY",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      },{
        "Id": "METADATA_MANAGER",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      },{
        "Id": "SORTER",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      },{
        "Id": "SOURCE_CAPTURE",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      },{
        "Id": "SOURCE_UNLOAD",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      },{
        "Id": "TABLES_MANAGER",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      },{
        "Id": "TARGET_APPLY",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      },{
        "Id": "TARGET_LOAD",
        "Severity": "LOGGER_SEVERITY_INFO"
      },{
        "Id": "TASK_MANAGER",
        "Severity": "LOGGER_SEVERITY_DEBUG"
      },{
        "Id": "TRANSFORMATION",
        "Severity": "LOGGER_SEVERITY_DEBUG"
      },{
        "Id": "VALIDATOR",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      }
    ],
    "CloudWatchLogGroup": null,
    "CloudWatchLogStream": null
  }, 
…