如何為 AWS DMS 任務設定詳細的偵錯日誌記錄？

3 分的閱讀內容

AWS Database Migration Service (AWS DMS) 任務有哪些日誌記錄類型可用？如何為 AWS DMS 任務開啟詳細的偵錯日誌記錄？

簡短描述

為 AWS DMS 任務開啟詳細偵錯日誌記錄的方式有三種：

使用 AWS DMS 主控台精靈
使用 AWS DMS 主控台手動更新 JSON 編輯器中的設定
使用 AWS Command Line Interface (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 任務，您可以修改 logging task settings (記錄任務設定)，並指定要記錄哪些元件活動和嚴重程度值。下列範例會使用最詳細的偵錯日誌記錄等級：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. 選擇 Save (儲存)。

使用 AWS CLI

1. 安裝和設定最新版本的 AWS CLI。

2. 開啟 AWS DMS 主控台，然後在導覽窗格中選擇 Database migration tasks (資料庫遷移任務)。

3. 選擇您的任務。然後，選擇 Overview (概觀) 標籤。

4. 複製 Task Settings (JSON) (任務設定 (JSON)) 並將其在本機另存為 .json 檔案。

5. 開啟 CloudWatch 日誌記錄。

6. 執行 modify-replication-task AWS CLI 命令，使用您的任務 ARN 以及您在步驟中儲存的 JSON 設定。

注意：在下例中，將 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 Resource Name (ARN)。

7. 開啟 AWS DMS 主控台，然後從導覽窗格中選擇 Database migration tasks (資料庫遷移任務)。

8. 確認任務狀態為 Modifying (修改中)。

9. 在任務的 Overview details (概觀詳細資訊) 區段的 Task Settings (任務設定) 底下，確認您修改過的每一個日誌組成部分的 Severity (嚴重性) 設定是 LOGGER_SEVERITY_DETAILED_DEBUG。