`AWSSupport-TroubleshootDMSTableErrors`

설명

AWS Systems Manager AWSSuport-TroubleshootDMSTabelErrors 자동화 실행서는 데이터베이스 마이그레이션 작업 또는 서버리스 복제에서 Table errors 찾을 수 있는에 대한 문제 해결 프로세스를 자동화하는 데 도움이 됩니다 AWS Database Migration Service. 이러한 오류는 AWS DMS 서비스에서 생성된 데이터베이스 마이그레이션 작업 또는 서버리스 복제를 통해 테이블이 소스 엔드포인트(소스 데이터베이스)에서 대상 엔드포인트(대상 데이터베이스)로 마이그레이션되지 않을 때 발생합니다. 이 실행서는 CloudWatch 로그의 서명 오류 메시지를 분석합니다. 특히 기존 데이터베이스 마이그레이션 작업의 작업 로그와 서버리스 복제의 서버리스 로그에 중점을 둡니다. 또한 AWS DMS 마이그레이션 Table error 중에에서 발생하는 일반적인 오류 메시지에 대한 대상 제안 및 수정 단계를 제공합니다.

어떻게 작동하나요?

실행서는 다음 단계를 수행합니다.

데이터베이스 마이그레이션 작업 또는 서버리스 복제일 수 있는 제공된 AWS DMS ARN에 대한 정보를 가져옵니다.
DescribeReplicationTasks API(데이터베이스 마이그레이션 작업의 경우) 및 DescribeReplications API(서버리스 복제의 경우) 응답의 FreshStartDate 값을 확인하여 제공된 AWS DMS 리소스가 한 번 이상 시작되었는지 확인합니다. 리소스가 시작되지 않은 경우 자동화에 오류가 발생합니다.
리소스가 시작된 경우 자동화는 TableStatistics 정보를 사용하여 TableError 상태의 테이블을 확인합니다. 오류가 발견되지 않으면 자동화는 지정된 데이터베이스 마이그레이션 작업 또는 서버리스 복제에서 테이블 오류가 발견되지 않았음을 확인하는 메시지를 표시한 후 워크플로를 종료합니다.
TableError 상태의 테이블이 발견되면 자동화는 지정된 AWS DMS 리소스에 대해 CloudWatch 로깅이 활성화되어 있는지 확인합니다. 로깅이 활성화되지 않은 경우 로깅이 활성화되지 않았음을 나타내는 메시지가 표시되면 자동화가 워크플로를 종료합니다.

참고: 자동화는 이러한 로그를 사용하여 TableError 상태의 테이블 문제를 분석하고 식별하기 때문에 CloudWatch 로깅이 활성화될 것으로 예상됩니다.
로깅이 활성화된 경우 자동화는 CloudWatch 로그를 분석하고 TableError 상태인 각 테이블에 대한 보고서를 생성합니다. 보고서에는 일반적인 오류 메시지에 대한 제안이 포함되어 있으며 AWS DMS 소스 엔드포인트에서 AWS DMS 대상 엔드포인트로의 성공적인 테이블 마이그레이션을 방해하는 문제를 식별하고 해결하는 데 도움이 되는 관련 오류 로그를 제공합니다.

이 자동화 실행(콘솔)

문서 유형

자동화

소유자

Amazon

플랫폼

파라미터

AutomationAssumeRole

유형: 문자열

설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
DMSArn

유형: 문자열

설명: (필수) 데이터베이스 마이그레이션 작업 또는 서버리스 복제의 ARN

허용된 패턴: ^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

유형: 문자열

설명: (선택 사항)이 파라미터는 지정된 데이터베이스 마이그레이션 작업 또는 서버리스 복제에 대한 CloudWatch 로그 분석의 시간 범위 시작을 정의합니다. 제공된 경우이 특정 시간부터 생성된 로그만 수집 및 분석됩니다. startDate와 사이의 시간 범위가 endDate 너무 길면 워크플로가 시간 초과될 수 있습니다. 값은 ISO 6081 날짜/시간 형식으로 제공해야 합니다.

허용된 패턴: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$
EndTimeRange

유형: 문자열

설명: (선택 사항)이 파라미터는 지정된 데이터베이스 마이그레이션 작업 또는 서버리스 복제에 대한 CloudWatch 로그 분석의 시간 범위 종료를 설정합니다. 제공된 경우이 특정 시간까지 생성된 로그만 수집 및 분석됩니다. startDate와 사이의 시간 범위가 endDate 너무 길면 워크플로가 시간 초과될 수 있습니다. 값은 ISO 6081 날짜/시간 형식으로 제공해야 합니다.

허용된 패턴: ^$|^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})\\.(\\d{3})Z$

필수 IAM 권한

실행서를 성공적으로 사용하려면 AutomationAssumeRole 파라미터에 다음 작업이 필요합니다.

dms:DescribeReplicationTasks
dms:DescribeReplications
dms:DescribeEndpoints
dms:DescribeReplicationConfigs
dms:DescribeTableStatistics
dms:DescribeReplicationTableStatistics
logs:FilterLogEvents

자동화 수임 역할에 대한 IAM 정책 예시



            {
                "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": "*"
                    }
                ]
            }

지침

다음 단계에 따라 자동화를 구성합니다.

Systems ManagerAWSSupport-TroubleshootDMSTableErrors의 문서로 이동합니다.
Execute automation(자동화 실행)을 선택합니다.
입력 파라미터에 다음을 입력합니다.
- AutomationAssumeRole(선택 사항):
  
  Systems Manager Automation이 사용자를 대신하여 작업을 수행할 수 있도록 허용하는 (IAM) 역할의 Amazon 리소스 이름 AWS AWS Identity and Access Management (ARN)입니다. 역할이 지정되지 않은 경우 Systems Manager Automation은이 실행서를 시작하는 사용자의 권한을 사용합니다.
- DMSArn
  
  테이블 오류가 있는 데이터베이스 마이그레이션 작업 또는 서버리스 복제의 ARN입니다.
- StartTimeRange
  
  (선택 사항) 지정된 데이터베이스 마이그레이션 작업 또는 서버리스 복제의 CloudWatch 로그를 분석하기 위한 시간 범위의 시작을 정의하는 ISO 6081 날짜 시간 형식입니다.
- EndTimeRange
  
  (선택 사항) 지정된 데이터베이스 마이그레이션 작업 또는 서버리스 복제의 CloudWatch 로그를 분석하기 위한 시간 범위의 끝을 정의하는 ISO 6081 날짜 시간 형식입니다.
페이지 하단에서 실행 버튼을 선택합니다.
자동화가 시작됩니다.
문서는 다음 단계를 수행합니다.
- validateDMSInputTypeAndGatherDetails
  
  지정된 AWS DMS ARN 입력을 검증하고 다음 단계에서 필요한 데이터베이스 마이그레이션 작업 또는 서버리스 복제의 기본 세부 정보를 수집합니다.
- branchOnTableErrors
  
  위 단계에서 발견된 테이블 오류 수를 기준으로 워크플로를 분기합니다. 개수가 0보다 크면 - branchOnCWLoggingStatus 단계로 진행합니다. 그렇지 않으면 - outputNoTableErrors 단계로 진행합니다.
- outputNoTableErrors
  
  지정된 데이터베이스 마이그레이션 작업 또는 서버리스 복제에서 테이블 오류를 찾을 수 없다는 메시지를 출력합니다.
- branchOnCWLoggingStatus
  
  위 단계에서 찾은 CloudWatch 로깅 상태를 기반으로 워크플로를 분기합니다. 활성화된 경우 - gatherTableDetails 단계로 진행합니다. 그렇지 않으면 - outputNoCWLoggingEnabled 단계로 진행합니다.
- outputNoCWLoggingEnabled
  
  지정된 데이터베이스 마이그레이션 작업 또는 서버리스 복제에서 CloudWatch 로깅이 활성화되지 않았다는 메시지를 출력합니다.
- gatherTableDetails
  
  실패한 테이블의 FullLoadEndTime 타임스탬프를 수집하고 시간 범위 값을 계산하여 CloudWatch 로그를 분석합니다.
- analyzeCloudWatchLogs
  
  서명 오류 메시지를 기반으로 CloudWatch 로그 그룹에서 찾은 로그를 분석하고 보고서를 사용자에게 반환합니다.
실행이 완료되면 출력 섹션에서 실행의 자세한 결과를 검토합니다.
- 테이블 없음 오류 출력
  
  제공된 데이터베이스 마이그레이션 작업 또는 서버리스 복제에서 테이블 오류를 찾을 수 없는 경우 자동화에 동일한 출력이 표시됩니다.
- CloudWatch 로그인이 활성화되지 않음의 출력
  
  제공된 데이터베이스 마이그레이션 작업 또는 서버리스 복제에서 CloudWatch 로깅이 활성화되지 않은 경우 자동화는 동일한 출력을 표시하고 로깅을 활성화하는 단계를 제공합니다.
- 로그 분석 보고서
  
  제공된 데이터베이스 마이그레이션 작업 또는 서버리스 복제에서 Table error 상태의 테이블을 식별하고, 오류 유형을 구분하고, 발생한 오류 메시지를 나열하고, 식별된 각 테이블에 대해 대상 수정 단계 및 제안을 제공하는 보고서를 출력합니다.

참조

Systems Manager Automation

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

AWS Database Migration Service

Amazon EBS