Paramètres de la tâche de journalisation - AWS Database Migration Service

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.

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 des tâches de journalisation sont écrits dans un JSON fichier. 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 lors de la création d'une tâche à l'aide du AWS DMS API. Vous pouvez également le spécifier "EnableLogging": true dans la section JSON de journalisation des paramètres des tâches.

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 <resourcename> section de la tâcheARN. Pour plus d'informations sur le mode AWS DMS de génération des ressourcesARNs, 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'IAMin CloudWatch, consultez les sections Gestion des identités et des accès pour Amazon CloudWatch et Journalisation des CloudWatch API appels Amazon dans le guide de CloudWatch l'utilisateur Amazon.

Pour supprimer les journaux des tâches, vous pouvez DeleteTaskLogs définir la valeur true dans la section JSON de journalisation des paramètres des tâches.

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 SORTER de service gère les événements mis en cache, collecte des CDC statistiques et signale le temps de latence des tâches.

  • SOURCE_CAPTURE— Les données de réplication en cours (CDC) sont capturées à partir de la base de données ou du service source et transmises au composant SORTER de service.

  • 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 instructions relatives aux données et au langage de définition des données (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 de plus amples informations, veuillez consulter 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 de plus amples informations, veuillez consulter 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'JSONexemple suivant montre les paramètres des tâches pour la journalisation de toutes les actions et 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
  }, 
…