Wie richte ich eine detaillierte Debug-Protokollierung für meine AWS-DMS-Aufgabe ein?

Lesedauer: 4 Minute

Welche Arten der Protokollierung sind für Aufgaben des AWS Database Migration Service (AWS DMS) verfügbar? Wie aktiviere ich die detaillierte Debug-Protokollierung für eine AWS-DMS-Aufgabe?

Kurzbeschreibung

Es gibt drei Möglichkeiten, die detaillierte Debug-Protokollierung für eine AWS-DMS-Aufgabe zu aktivieren:

Verwenden des AWS-DMS-Konsolenassistenten
Manuelles Aktualisieren der Einstellungen im JSON-Editor mithilfe der AWS-DMS-Konsole
Verwenden der AWS Command Line Interface (AWS CLI)

Hinweis: Wenn Sie beim Ausführen von AWS-CLI-Befehlen Fehler erhalten, stellen Sie sicher, dass Sie die aktuelle Version der AWS CLI verwenden.

Lösung

Verwenden Sie den AWS-Konsolenassistenten

1. Öffnen Sie die AWS-DMS-Konsole, und wählen Sie im Navigationsbereich die Option Datenbankmigrationsaufgaben aus.

2. Wählen Sie Ihre Aufgabe.

3. Wählen Sie unter Aufgabeneinstellung für den Modus Bearbeitung die Option Assistent aus.

4. Vergewissern Sie sich, dass das Kontrollkästchen CloudWatch-Protokolle aktivieren aktiviert ist.

5. Ändern Sie den Schweregrad der fünf Standard-Logger in der Dropdown-Liste nach Bedarf.

Wenn Sie diese Aufgabe das nächste Mal ausführen, erhalten Sie detaillierte Debug-Protokolle.

Hinweis: Zusätzlich zu den fünf Standard-Loggern, die in der AWS-DMS-Konsole verfügbar sind, können Sie das detaillierte Debugging für alle AWS-DMS-Logger aktivieren. Ändern Sie dazu die Aufgabe. Ändern Sie im JSON-Editor für Aufgabeneinstellungen für ProtokollKomponenten den Schweregrad nach Bedarf.

Manuelles Aktualisieren der Einstellungen im JSON-Editor mithilfe der AWS-Konsole

Hinweis: Sie können das detaillierte Debugging mithilfe der AWS-DMS-Konsole aktivieren, wenn Sie eine DMS-Aufgabe erstellen oder ändern. Greifen Sie dazu in Ihren Aufgabeneinstellungen auf den JSON-Editor zu. Ändern Sie für Protokollkomponenten den Schweregrad nach Bedarf.

Um Ihre AWS-DMS-Aufgabe zu überwachen, können Sie die Protokollierungsaufgabeneinstellungen ändern und angeben, welche Komponentenaktivitäten und Schweregrade protokolliert werden. Das folgende Beispiel verwendet die detaillierteste Ebene der Debug-Protokollierung: LOGGER_SCHWEREGRAD_DETAILLIERTES_DEBUG. Eine detaillierte Debug-Protokollierung benötigt viel Speicherplatz. Wenn Sie die fortlaufende Replikation verwenden, auch bekannt als Erfassung von Datenänderungen (Change Data Capture, CDC), belegen die Protokolleinträge möglicherweise den Rest Ihres Speicherplatzes.

1. Öffnen Sie die AWS-DMS-Konsole, und wählen Sie im Navigationsbereich die Option Datenbankmigrationsaufgaben aus.

2. Wählen Sie Ihre Aufgabe.

3. Erweitern Sie im Abschnitt Übersichtsdetails den Abschnitt Aufgabeneinstellungen (JSON). Kopieren Sie dann den Abschnitt Protokollierung der Aufgabeneinstellungen und fügen Sie ihn in einen JSON-Editor ein.

4. Bearbeiten Sie die Schweregradeinstellung jeder Protokollkomponente, für die Sie die detaillierte Debug-Protokollierung aktivieren möchten. Um den Schweregrad festzulegen, ersetzen Sie LOGGER_SCHWEREGRAD_STANDARD durch LOGGER_SCHWEREGRAD_DEBUG.

Beispiel:

{
 "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. Wählen Sie Speichern aus.

Verwendung der AWS CLI

1. Installieren und konfigurieren Sie die neueste Version der AWS CLI.

2. Öffnen Sie die AWS-DMS-Konsole, und wählen Sie im Navigationsbereich die Option Datenbankmigrationsaufgaben aus.

3. Wählen Sie Ihre Aufgabe. Wählen Sie dann die Registerkarte Übersicht.

4. Kopieren Sie die Aufgabeneinstellungen (JSON) und speichern Sie sie lokal als .json-Datei.

5. Schalten Sie die CloudWatch-Protokollierung ein.

6. Führen Sie den AWS-CLI-Befehl Replikationsaufgabe-ändern mit Ihrer Aufgaben-ARN und den JSON-Einstellungen aus, die Sie im Schritt gespeichert haben.

Hinweis: Ersetzen Sie in den folgenden Beispielen your-task-settings.json durch den Namen Ihrer gespeicherten Datei. Beispiel für 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

Beispiel für 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"

Hinweis: Um Ihren Aufgaben-ARN zu finden, öffnen Sie die AWS-DMS-Konsole und wählen Sie im Navigationsbereich Datenbankmigrationsaufgaben aus. Die Aufgaben-ARN wird im Abschnitt Übersichtdetails angezeigt. Weitere Informationen finden Sie unter Konstruieren eines Amazon-Ressourcennamens (ARN) für AWS DMS.

7. Öffnen Sie die AWS-DMS-Konsole und wählen Sie im Navigationsbereich die Option Datenbankmigrationsaufgaben aus.

8. Vergewissern Sie sich, dass der Aufgabenstatus Wird geändert lautet.

9. Vergewissern Sie sich im Abschnitt Übersichtdetails für Ihre Aufgabe unter Aufgabeneinstellungen, dass der Schweregrad für jede Protokollkomponente, die Sie geändert haben, LOGGER_SCHWEREGRAD_DETAILLIERTES_DEBUG lautet.