如何为我的 AWS DMS 任务设置详细的调试日志记录？

2 分钟阅读

哪些类型的日志记录可用于 AWS Database Migration Service (AWS DMS) 任务？如何为 AWS DMS 任务开启详细的调试日志记录？

简短描述

有三种方法可以为 AWS DMS 任务开启详细的调试日志：

使用 AWS DMS 控制台向导
使用 AWS DMS 控制台手动更新 JSON 编辑器中的设置
使用 AWS 命令行界面（AWS CLI）

**注意：**如果在运行 AWS CLI 命令时收到错误，请确保您使用的是最新的 AWS CLI 版本。

解决方法

使用 AWS 管理控制台向导

1. 打开 AWS DMS 控制台，然后从导航窗格中选择 Database migration tasks（数据库迁移任务）。

2. 选择您的任务。

3. 在 Task Setting（任务设置）下，对于 Editing（编辑）模式，选择 Wizard（向导）。

4. 确认已选中 Enable CloudWatch logs（启用 CloudWatch 日志）复选框。

5. 根据需要更改下拉列表中五个标准记录器的 Severity（严重度）。

在下次运行此任务时，您会获得详细的调试日志。

**注意：**除了 AWS DMS 控制台中提供的五个标准日志记录器外，您还可以为所有 AWS DMS 记录器开启详细调试。为此，请修改任务。在任务设置 JSON 编辑器中，对于 LogComponents，根据需要更改 Severity（严重度）。

使用 AWS 管理控制台手动更新 JSON 编辑器中的设置

注意：现在，您可以在创建或修改 DMS 任务时使用 AWS DMS 控制台开启详细调试。为此，请在 Task settings（任务设置）中访问 JSON 编辑器。对于 LogComponents（日志组件），请根据需要更改 Severity（严重度）。

要监控 AWS DMS 任务，您可以修改日志记录任务设置并指定要在日志中记录的组件活动和严重度值。以下示例使用最详细的调试日志记录级别：LOGGER_SEVERITY_DETAILED_DEBUG。详细的调试日志记录需要大量存储空间。如果您使用持续复制（也称为变更数据捕获 (CDC)），则日志条目可能会耗尽您的其余存储空间。

1. 打开 AWS DMS 控制台，然后从导航窗格中选择 Database migration tasks（数据库迁移任务）。

2. 选择您的任务。

3. 在 Overview details（概述详细信息）部分中，展开 Task Settings (JSON)（任务设置 (JSON)）部分。然后，将任务设置的 Logging（日志记录）部分复制并粘贴到 JSON 编辑器中。

4. 编辑要开启详细调试日志记录的每个日志组件的 Severity（严重度）设置。要设置严重性，请将 LOGGER_SEVERITY_DEFAULT 替换为 LOGGER_SEVERITY_DETAILED_DEBUG。

例如：

{
 "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. 选择保存。

使用 AWS CLI

1. 安装和配置最新版本的 AWS CLI。

2. 打开 AWS DMS 控制台，然后从导航窗格中选择 Database migration tasks（数据库迁移任务）。

3. 选择您的任务。然后选择 Overview（概览）选项卡。

4. 复制 Task Settings (JSON)（任务设置 (JSON)）并将其另存为 .json 文件到本地。

5. 开启 CloudWatch 日志记录。

6. 使用 Task ARN（任务 ARN）以及您在步骤中保存的 JSON 设置运行 modify-replication-task AWS CLI 命令。

注意：在以下示例中，将 your-task-settings.json 替换为已保存文件的名称。 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

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"

注意：要查找 Task ARN（任务 ARN），请打开 AWS DMS 控制台并从导航窗格中选择 Database migration tasks（数据库迁移任务）。Task ARN（任务 ARN）将在 Overview details（概述详情）部分显示。有关更多信息，请参阅为 AWS DMS 构造 Amazon 资源名称（ARN）。

7. 打开 AWS DMS 控制台，然后从导航窗格中选择 Database migration tasks（数据库迁移任务）。

8. 确认任务状态为正在修改。

9. 进入任务的 Overview details（概述详情）部分，然后打开 Task Settings（任务设置），确认对于您修改过的每个日志组件，其 Severity（严重度）设置为 LOGGER_SEVERITY_DETAILED_DEBUG。