View a markdown version of this page

AWSSupport-TroubleshootDMSTableErrors - AWS Systems Manager Riferimento al runbook dell’automazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWSSupport-TroubleshootDMSTableErrors

Descrizione

Il runbook di AWS Systems Manager AWSSuport-TroubleshootDMSTableErrors automazione consente di automatizzare il processo di risoluzione dei problemi Table errors riscontrati nell'attività di migrazione del database o nella replica serverless da. AWS Database Migration Service Questi errori si verificano quando le tabelle non riescono a migrare dall'endpoint di origine (database di origine) all'endpoint di destinazione (database di destinazione) tramite l'attività di migrazione del database o la replica serverless creata nel servizio. AWS DMS Questo runbook analizza i messaggi di errore relativi alle firme provenienti dai CloudWatch log, concentrandosi in particolare sui task log per le tradizionali attività di migrazione del database e sui log serverless per la replica serverless. Fornisce inoltre suggerimenti mirati e procedure correttive per i messaggi di errore più comuni riscontrati durante le migrazioni. Table error AWS DMS

Come funziona?

Il runbook esegue i seguenti passaggi:

  • Recupera informazioni sull' AWS DMS ARN fornito, che può essere un'attività di migrazione del database o una replica serverless.

  • Verifica se la AWS DMS risorsa fornita è stata avviata almeno una volta controllando il FreshStartDate valore nella risposta API (per l'attività di migrazione del database) e DescribeReplicationTasks DescribeReplications API (per la replica senza server). Se la risorsa non è stata avviata, l'automazione genera un errore.

  • Se la risorsa è stata avviata, l'automazione verifica la presenza di tabelle negli TableError stati utilizzando TableStatistics le informazioni. Se non viene rilevato alcun errore, l'automazione termina il flusso di lavoro dopo aver visualizzato un messaggio che conferma l'assenza di errori di tabella nell'attività di migrazione del database specificata o nella replica serverless.

  • Se vengono trovate tabelle con TableError stato, l'automazione verifica se la CloudWatch registrazione è abilitata per la risorsa specificata. AWS DMS Se la registrazione non è abilitata, l'automazione termina il flusso di lavoro dopo aver visualizzato un messaggio che indica che la registrazione non è abilitata.

    Nota: la CloudWatch registrazione dovrebbe essere abilitata, poiché l'automazione si basa su questi registri per analizzare e identificare i problemi relativi allo stato delle tabelle. TableError

  • Se la registrazione è abilitata, l'automazione analizza i CloudWatch log e genera un report per ogni tabella in stato. TableError Il rapporto include suggerimenti per i messaggi di errore più comuni e fornisce i log degli errori pertinenti per aiutare a identificare e risolvere i problemi che impediscono la corretta migrazione della tabella dall'endpoint di AWS DMS origine all' AWS DMS endpoint di destinazione.

Esegui questa automazione (console)

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

/

Parametri

  • AutomationAssumeRole

    Tipo: stringa

    Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.

  • DMS-Arn

    Tipo: stringa

    Descrizione: (obbligatorio) ARN dell'attività di migrazione del database o della replica serverless

    Modello consentito: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):dms:[a-z0-9-]+:\d{12}:(task|replication-config):[a-zA-Z0-9-]+$

  • StartTimeRange

    Tipo: stringa

    Descrizione: (Facoltativo) Questo parametro definisce l'inizio dell'intervallo di tempo per l'analisi dei CloudWatch log di una determinata attività di migrazione del database o della replica serverless. Se fornito, verranno raccolti e analizzati solo i log generati da questo momento specifico in poi. Tieni presente che è possibile che il flusso di lavoro vada in timeout se l'intervallo di tempo tra startDate e endDate è troppo lungo. Il valore deve essere fornito nel formato data/ora ISO 6081.

    Schema consentito: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

  • EndTimeRange

    Tipo: stringa

    Descrizione: (Facoltativo) Questo parametro imposta la fine dell'intervallo di tempo per l'analisi dei CloudWatch log dell'attività di migrazione del database o della replica serverless specificata. Se fornito, verranno raccolti e analizzati solo i log generati fino a questo momento specifico. Tieni presente che è possibile che il flusso di lavoro vada in timeout se l'intervallo di tempo tra startDate e endDate è troppo lungo. Il valore deve essere fornito nel formato data/ora ISO 6081.

    Schema consentito: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

Autorizzazioni IAM richieste

Il AutomationAssumeRole parametro richiede le seguenti azioni per utilizzare correttamente il runbook.

  • dms:DescribeReplicationTasks

  • dms:DescribeReplications

  • dms:DescribeEndpoints

  • dms:DescribeReplicationConfigs

  • dms:DescribeTableStatistics

  • dms:DescribeReplicationTableStatistics

  • logs:FilterLogEvents

Esempio di policy IAM per l'automazione Assume Role

JSON

            {
                "Version":"2012-10-17",
                "Statement": [
                    {
                        "Sid": "VisualEditor0",
                        "Effect": "Allow",
                        "Action": [
                            "dms:DescribeReplicationConfigs",
                            "dms:DescribeEndpoints",
                            "dms:DescribeReplicationTableStatistics",
                            "dms:DescribeTableStatistics",
                            "logs:FilterLogEvents",
                            "dms:DescribeReplicationTasks",
                            "dms:DescribeReplications"
                        ],
                        "Resource": "*"
                    }
                ]
            }

Istruzioni

Segui questi passaggi per configurare l'automazione:

  1. Accedi AWSSupport-TroubleshootDMSTableErrors a Systems Manager in Documenti.

  2. Seleziona Execute automation (Esegui automazione).

  3. Per i parametri di input, inserisci quanto segue:

    • AutomationAssumeRole (Facoltativo):

      L'Amazon Resource Name (ARN) del ruolo AWS AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.

    • DMS-Arn

      ARN dell'attività di migrazione del database o della replica serverless con errori di tabella.

    • StartTimeRange

      (Facoltativo) Formato di data e ora ISO 6081 che definisce l'inizio dell'intervallo di tempo per l'analisi dei CloudWatch log della determinata attività di migrazione del database o della replica serverless.

    • EndTimeRange

      (Facoltativo) Formato di data e ora ISO 6081 che definisce la fine dell'intervallo di tempo per l'analisi dei CloudWatch log di una determinata attività di migrazione del database o della replica serverless.

  4. Seleziona il pulsante Esegui nella parte inferiore della pagina.

  5. L'automazione viene avviata.

  6. Il documento esegue i seguenti passaggi:

    • convalidare DMSInputTypeAndGatherDetails

      Convalida l'input AWS DMS ARN fornito e raccoglie i dettagli di base dell'attività di migrazione del database o della replica serverless, necessari nei passaggi successivi.

    • filiale OnTableErrors

      Suddivide il flusso di lavoro in base al numero di errori di tabella rilevati nel passaggio precedente. Se il conteggio è maggiore di 0, procedi al branchOnCWLoggingStatus passaggio -. Altrimenti, procedi al outputNoTableErrors passaggio -.

    • outputNoTableErrors

      Emette un messaggio che indica che gli errori di tabella non sono stati rilevati nell'attività di migrazione del database o nella replica serverless specificata.

    • filiale OnCWLoggingStatus

      Suddivide il flusso di lavoro in base allo stato di CloudWatch registrazione riportato nel passaggio precedente. Se abilitato, procedi con il gatherTableDetails passaggio -. Altrimenti, procedi al outputNoCWLoggingEnabled passaggio -.

    • outputNoCWLoggingEnabled

      Emette un messaggio che indica che la CloudWatch registrazione non è abilitata nell'attività di migrazione del database o nella replica serverless specificata.

    • raccogliere TableDetails

      Raccoglie i FullLoadEndTime timestamp delle tabelle non riuscite e calcola i valori dell'intervallo di tempo per analizzare i log. CloudWatch

    • analizza CloudWatchLogs

      Analizza i log trovati nel gruppo di CloudWatch log in base ai messaggi di errore di firma e restituisce il rapporto all'utente.

  7. Al termine dell'esecuzione, consulta la sezione Output per i risultati dettagliati dell'esecuzione.

    • Risultato di Nessun errore di tabella trovato

      Se non vengono rilevati errori di tabella nell'attività di migrazione del database fornita o nella replica serverless, l'automazione mostra l'output che indica lo stesso.

    • L'output di No loggin è abilitato CloudWatch

      Se la CloudWatch registrazione non è abilitata nell'attività di migrazione del database fornita o nella replica serverless, l'automazione mostra l'output che indica lo stesso e fornisce i passaggi per abilitare la registrazione.

    • Rapporto di analisi dei log

      Genera un report che identifica Table error lo stato delle tabelle in base all'attività di migrazione del database fornita o alla replica serverless, distinguendo i tipi di errore, elencando i messaggi di errore riscontrati e fornendo passaggi e suggerimenti mirati per la correzione per ogni tabella identificata.

Riferimenti

Systems Manager Automation