12.3. 로그 및 디버깅 툴

절차

1. MTC 웹 콘솔에서 마이그레이션 계획을 클릭합니다.
2. 마이그레이션 계획 옆에 있는 마이그레이션 번호를 클릭하면 마이그레이션 페이지가 표시됩니다.
3. 마이그레이션을 클릭하여 마이그레이션 세부 정보를 확인합니다.

4. 마이그레이션 리소스를 확장하여 목록 보기에서 마이그레이션 리소스 및 해당 상태를 봅니다.

   참고

   실패한 마이그레이션 문제를 해결하려면 실패한 상위 수준 리소스부터 시작한 다음 리소스 트리를 하위 수준 리소스로 이동합니다.

5. 리소스 옆에 있는 옵션 메뉴 를 클릭하고 다음 옵션 중 하나를 선택합니다.

   • oc describe 복사 명령은 명령을 클립보드에 복사합니다.

     • 관련 클러스터에 로그인한 다음 명령을 실행합니다.

       리소스의 조건 및 이벤트는 YAML 형식으로 표시됩니다.

   • oc logs 복사 명령은 명령을 클립보드에 복사합니다.

     • 관련 클러스터에 로그인한 다음 명령을 실행합니다.

       리소스가 로그 필터링을 지원하는 경우 필터링된 로그가 표시됩니다.

   • JSON 보기는 웹 브라우저에서 JSON 형식으로 리소스 데이터를 표시합니다.

     데이터는 oc get <resource> 명령의 출력과 동일합니다.

절차

1. MTC 웹 콘솔에서 마이그레이션 계획을 클릭합니다.
2. 마이그레이션 계획 옆에 있는 마이그레이션 번호를 클릭합니다.
3. 로그 보기를 클릭합니다.
4. 복사 아이콘을 클릭하여 oc logs 명령을 클립보드에 복사합니다.

5. 해당 클러스터에 로그인하고 CLI에 명령을 입력합니다.

   마이그레이션 계획에 대해 집계된 로그가 표시됩니다.

절차

1. mig-log-reader 포드를 가져옵니다.

   $ oc -n openshift-migration get pods | grep log

2. 단일 마이그레이션 로그를 표시하려면 다음 명령을 입력합니다.

   $ oc -n openshift-migration logs -f <mig-log-reader-pod> -c color 1

   1

   -c plain 옵션은 색상 없이 로그를 표시합니다.

절차

1. OpenShift Container Platform 웹 콘솔에서 모니터링 → 메트릭 을 클릭합니다.

2. PromQL 쿼리를 입력하고 표시할 시간 창을 선택한 다음 Run Queries(쿼리 실행 )를 클릭합니다.

   웹 브라우저에 모든 결과가 표시되지 않으면 Prometheus 콘솔을 사용합니다.

절차

1. must-gather 데이터를 저장하려는 디렉터리로 이동합니다.

2. 다음 데이터 수집 옵션 중 하나에 대해 oc adm must-gather 명령을 실행합니다.

   • 지난 시간 동안 데이터를 수집하려면 다음을 수행하십시오.

     $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.7

     데이터는 must-gather/must-gather.tar.gz 로 저장됩니다. Red Hat 고객 포털에서 해당 지원 사례에 이 파일을 업로드할 수 있습니다.

   • 지난 24 시간 동안 데이터를 수집하려면 다음을 수행하십시오.

     $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-gather-rhel8:v1.7 \
       -- /usr/bin/gather_metrics_dump

     이 작업에는 오랜 시간이 걸릴 수 있습니다. 데이터는 must-gather/metrics/prom_data.tar.gz 로 저장됩니다.

절차

1. prom_data.tar.gz 파일의 압축을 풉니다.

   $ tar -xvzf must-gather/metrics/prom_data.tar.gz

2. 로컬 Prometheus 인스턴스를 생성합니다.

   $ make prometheus-run

   이 명령은 Prometheus URL을 출력합니다.

   출력 결과

   Started Prometheus on http://localhost:9090

3. 웹 브라우저를 시작하고 URL로 이동하여 Prometheus 웹 콘솔을 사용하여 데이터를 확인합니다.

4. 데이터를 보고 나면 Prometheus 인스턴스 및 데이터를 삭제합니다.

   $ make prometheus-cleanup

프로세스

1. MigMigration CR의 상태를 확인합니다.

   $ oc get migmigration <migmigration> -o yaml

   출력 예

   status:
     conditions:
     - category: Warn
       durable: true
       lastTransitionTime: "2021-01-26T20:48:40Z"
       message: 'Final Restore openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf: partially failed on destination cluster'
       status: "True"
       type: VeleroFinalRestorePartiallyFailed
     - category: Advisory
       durable: true
       lastTransitionTime: "2021-01-26T20:48:42Z"
       message: The migration has completed with warnings, please look at `Warn` conditions.
       reason: Completed
       status: "True"
       type: SucceededWithWarnings

2. Velero describe 명령을 사용하여 Restore CR의 상태를 확인합니다.

   $ oc -n {namespace} exec deployment/velero -c velero -- ./velero \
     restore describe <restore>

   출력 예

   Phase:  PartiallyFailed (run 'velero restore logs ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf' for more information)
   
   Errors:
     Velero:     <none>
     Cluster:    <none>
     Namespaces:
       migration-example:  error restoring example.com/migration-example/migration-example: the server could not find the requested resource

3. Velero logs 명령을 사용하여 Restore CR 로그를 확인합니다.

   $ oc -n {namespace} exec deployment/velero -c velero -- ./velero \
     restore logs <restore>

   출력 예

   time="2021-01-26T20:48:37Z" level=info msg="Attempting to restore migration-example: migration-example" logSource="pkg/restore/restore.go:1107" restore=openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf
   time="2021-01-26T20:48:37Z" level=info msg="error restoring migration-example: the server could not find the requested resource" logSource="pkg/restore/restore.go:1170" restore=openshift-migration/ccc7c2d0-6017-11eb-afab-85d0007f5a19-x4lbf

   Restore CR 로그 오류 메시지인 the server could not find the requested resource은 부분적으로 실패한 마이그레이션의 원인을 나타냅니다.

절차

1. openshift-migration 네임스페이스에 MigMigration CR을 나열합니다.

   $ oc get migmigration -n openshift-migration

   출력 예

   NAME                                   AGE
   88435fe0-c9f8-11e9-85e6-5d593ce65e10   6m42s

2. MigMigration CR을 검사합니다.

   $ oc describe migmigration 88435fe0-c9f8-11e9-85e6-5d593ce65e10 -n openshift-migration

   출력은 다음 예제와 유사합니다.