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

上次更新时间:2021 年 2 月 10 日

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

解决方法

注意:如果您在运行 AWS 命令行界面 (AWS CLI) 命令时遇到错误,请确保您运行的是最新版本的 AWS CLI

为 AWS DMS 任务启用调试

注意:现在,您可以在创建或修改 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 编辑器中。

注意:如果您的 AWS DMS 任务正在运行,则您只可以修改 Logging(日志记录)任务设置。如果您想要修改其他任何任务设置,请先停止该任务,然后再进行修改。

4.    对于您要启用详细调试日志记录的每个日志组件,将 LOGGER_SEVERITY_DEFAULT(或其他任何设置)替换为 LOGGER_SEVERITY_DETAILED_DEBUG,从而编辑其Severity(严重度)设置。 SOURCE_UNLOAD 和 TARGET_LOAD 日志组件仅适用于完整加载任务。SOURCE_CAPTURE 和 TARGET_APPLY 适用于持续复制 (CDC) 任务。

示例

{
    "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.    保存 JSON 文件,并记下 Task ARN(任务 ARN)和文件路径以便之后使用。

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

7.    使用 Task ARN(任务 ARN)以及您在第五步中保存的文件路径运行 modify-replication-task AWS CLI 命令。

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)

8.    打开 AWS DMS 控制台,然后从导航窗格中选择 Database migration tasks(数据库迁移任务)。

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

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

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

修改现有任务以启用调试

您还可以修改现有任务以启用详细调试。

1.    修改 AWS DMS 任务

2.    确认已选中 Enable CloudWatch logs(启用 CloudWatch 日志)复选框。

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

注意:您可以为所有 AWS DMS 记录器启用详细调试,而不仅仅是 AWS DMS 控制台中提供的五个标准记录器。为此,请修改任务,然后从 Task settings(任务设置)中,根据需要在 JSON 编辑器中修改 LogComponents(日志组件)的 Severity(严重度)。


这篇文章对您有帮助吗?


您是否需要账单或技术支持?