Daniel shows you how to
set up detailed debug logging
for an AWS DMS task

Daniel_IAD

The debug logging information for my AWS Database Migration Service (AWS DMS) task is not detailed enough. How do I enable detailed debug logging?

Note: Detailed debug logging requires a large amount of storage space. If you are using ongoing replication, also known as change data capture (CDC), the log entries might consume the rest of your storage space.

1.    Open the AWS Database Migration Service console, and then choose Tasks in the navigation pane.

2.    Choose your task. If the task is running, choose Stop.

3.    On the Overview view, copy and paste the Task Settings section into a JSON editor.

4.    Edit the "Severity" setting of each log component that you want to enable detailed debug logging on by replacing "LOGGER_SEVERITY_DEFAULT" (or any other setting) with "LOGGER_SEVERITY_DETAILED_DEBUG". The "SOURCE_UNLOAD" and "TARGET_LOAD" log components are for full load tasks only. "SOURCE_CAPTURE" and "TARGET_APPLY" are for ongoing replication (CDC) tasks.  

Example:  

"LogComponents": [
      {
        "Id": "SOURCE_UNLOAD",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      },
      {
        "Id": "SOURCE_CAPTURE",
        "Severity": "LOGGER_SEVERITY_DETAILED_DEBUG"
      },
      {
        "Id": "TARGET_LOAD",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      },
      {
        "Id": "TARGET_APPLY",
        "Severity": "LOGGER_SEVERITY_DETAILED_DEBUG"
      },
      {
        "Id": "TASK_MANAGER",
        "Severity": "LOGGER_SEVERITY_DEFAULT"
      }
    ]

5.    Save the JSON file.

6.    Install and configure the latest version of the AWS Command Line Interface (AWS CLI).

7.    Run the modify-replication-task AWS CLI command, using your Task ARN and the path of the file that you saved in step five.

Linux example

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 example

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"

Note: To find your Task ARN, choose Tasks in the AWS Database Migration Service console navigation pane. The Task ARN appears in the Overview view. For more information, see Constructing an Amazon Resource Name (ARN) for AWS DMS.

8.    Return to the AWS Database Migration Service console and choose Tasks in the navigation pane to refresh the page.

9.    Confirm that the task status is Modifying.

10.    On the Overview view for your task, under Task Settings, confirm that the "Severity" setting is changed to "LOGGER_SEVERITY_DETAILED_DEBUG" for each log component that you modified.

The next time that you run this task, you'll get detailed debug logs.


Did this page help you? Yes | No

Back to the AWS Support Knowledge Center

Need help? Visit the AWS Support Center

Published: 2018-06-29