다음을 통해 공유

az arcdata dc debug

  • 참조

참고 항목

이 참조는 Azure CLI(버전 2.3.1 이상)에 대한 arcdata 확장의 일부입니다. az arcdata dc debug 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

데이터 컨트롤러를 디버그합니다.

명령

Name Description 형식 상태
az arcdata dc debug controldb-cdc

데이터 컨트롤러 데이터베이스 및 테이블에서 CDC를 사용/사용하지 않도록 설정합니다. 문제 해결 용도로만 사용됩니다.

 내선 번호 GA
az arcdata dc debug copy-logs

로그를 복사합니다.

 내선 번호 GA
az arcdata dc debug dump

메모리 덤프를 트리거합니다.

 내선 번호 GA
az arcdata dc debug restore-controldb-snapshot

문제 해결 목적으로만 백업에서 ControlDB의 고유한 복사본을 복원합니다.

 내선 번호 GA

az arcdata dc debug controldb-cdc

데이터 컨트롤러 데이터베이스 및 테이블에서 CDC를 사용/사용하지 않도록 설정합니다. 문제 해결 용도로만 사용됩니다.

구성 가능한 보존 시간이 있는 '컨트롤러' 데이터베이스 및 지원되는 테이블에 대해 변경 데이터 캡처를 사용하거나 사용하지 않도록 설정합니다.

az arcdata dc debug controldb-cdc --k8s-namespace
                                  [--enable {false, true}]
                                  [--retention-hours]
                                  [--use-k8s]

예제

4시간의 보존 기간을 사용하여 변경 데이터 캡처를 사용하도록 설정합니다.

az arcdata dc debug controldb-cdc -k arc-data-services --enable true --retention-hours 4

변경 데이터 캡처를 사용하지 않도록 설정합니다.

az arcdata dc debug controldb-cdc -k arc-data-services --enable false

필수 매개 변수

--k8s-namespace -k

기존 데이터 컨트롤러의 Kubernetes 네임스페이스입니다.

선택적 매개 변수

--enable

변경 데이터 캡처를 사용하거나 사용하지 않도록 설정합니다.

허용되는 값: false, true
--retention-hours

CDC 보존 기간(시간 단위로 지정됨) 허용되는 값은 1~24입니다.

기본값: 8
--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az arcdata dc debug copy-logs

로그를 복사합니다.

데이터 컨트롤러에서 디버그 로그 복사 - 시스템에 Kubernetes 구성이 필요합니다.

az arcdata dc debug copy-logs --k8s-namespace
                              [--container]
                              [--exclude-arcdata-logs]
                              [--exclude-cluster-info]
                              [--exclude-controldb]
                              [--exclude-dumps]
                              [--exclude-system-logs]
                              [--pod]
                              [--resource-kind]
                              [--resource-name]
                              [--skip-compress]
                              [--target-folder]
                              [--timeout]
                              [--use-k8s]

필수 매개 변수

--k8s-namespace -k

데이터 컨트롤러의 Kubernetes 네임스페이스입니다.

선택적 매개 변수

--container -c

비슷한 이름의 컨테이너에 대한 로그를 복사합니다(선택 사항). 기본적으로 모든 컨테이너에 대한 로그를 복사합니다. 여러 번 지정할 수 없습니다. 여러 번 지정하면 마지막 항목이 사용됩니다.

--exclude-arcdata-logs

결과 폴더에서 arc Data Services 로그를 제외할지 여부입니다. 기본값은 모든 Arc 데이터 서비스 컨테이너 로그를 포함하는 False입니다.

기본값: False
--exclude-cluster-info

네임스페이스당 결과 폴더에서 kubernetes 리소스 정보를 제외할지 여부입니다. 기본값은 이름 간격이 지정된 리소스 정보를 포함하는 False입니다.

기본값: False
--exclude-controldb

결과 폴더에서 controldb의 백업을 제외할지 여부입니다. 기본값은 controldb 백업을 포함하는 False입니다.

기본값: False
--exclude-dumps

결과 폴더에서 덤프를 제외할지 여부입니다. 기본값은 False입니다. 이 값은 덤프를 포함합니다.

기본값: False
--exclude-system-logs

컬렉션에서 kube-system 및 azure-arc 네임스페이스 로그를 제외할지 여부입니다. 기본값은 액세스할 수 있는 경우 kube-system 및 connectedk8s 로그를 포함하는 False입니다.

기본값: False
--pod

비슷한 이름의 Pod에 대한 로그를 복사합니다. 선택 사항이며, 기본적으로 모든 Pod의 로그를 복사합니다. 여러 번 지정할 수 없습니다. 여러 번 지정하면 마지막 항목이 사용됩니다.

--resource-kind

특정 종류의 리소스에 대한 로그를 복사합니다. 여러 번 지정할 수 없습니다. 여러 번 지정하면 마지막 항목이 사용됩니다. 지정된 경우 리소스를 식별하기 위해 --resource-name도 지정해야 합니다.

--resource-name

지정된 이름의 리소스에 대한 로그를 복사합니다. 여러 번 지정할 수 없습니다. 여러 번 지정하면 마지막 항목이 사용됩니다. 지정한 경우 --resource-kind도 지정하여 리소스를 식별해야 합니다.

--skip-compress

결과 폴더 압축을 건너뛸지 여부입니다. 기본값은 결과 폴더를 압축하는 False입니다.

기본값: False
--target-folder -d

로그를 복사할 대상 폴더 경로입니다. 선택 사항이며, 기본적으로 로컬 폴더에 결과를 만듭니다. 여러 번 지정할 수 없습니다. 여러 번 지정하면 마지막 항목이 사용됩니다.

--timeout -t

명령이 완료되기를 기다리는 시간(초)입니다. 기본값은 무제한인 0입니다.

기본값: 0
--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az arcdata dc debug dump

메모리 덤프를 트리거합니다.

메모리 덤프를 트리거하고 컨테이너에서 복사합니다. 시스템에 Kubernetes 구성이 필요합니다.

az arcdata dc debug dump --k8s-namespace
                         [--container {controller}]
                         [--target-folder]
                         [--use-k8s]

필수 매개 변수

--k8s-namespace -k

데이터 컨트롤러의 Kubernetes 네임스페이스입니다.

선택적 매개 변수

--container -c

실행 중인 프로세스를 덤프하기 위해 트리거할 대상 컨테이너입니다.

허용되는 값: controller
기본값: controller
--target-folder -d

덤프를 복사할 대상 폴더입니다.

기본값: ./output/dump
--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az arcdata dc debug restore-controldb-snapshot

문제 해결 목적으로만 백업에서 ControlDB의 고유한 복사본을 복원합니다.

문제 해결을 위해 고유한 이름으로 ControlDB의 COPY_ONLY 백업을 복원합니다. 시스템에 Kubernetes 구성이 필요합니다.

az arcdata dc debug restore-controldb-snapshot --backup-file
                                               --k8s-namespace
                                               [--use-k8s]

예제

Linux - 이전에 실행한 'arcdata dc debug copy-logs' 명령에서 가져온 백업을 복원합니다.

az arcdata dc debug restore-controldb-snapshot -k arc-data-services -f /path/to/backup/controller-1675653451.bak

Windows - 이전에 실행한 'arcdata dc debug copy-logs' 명령에서 가져온 백업을 복원합니다.

az arcdata dc debug restore-controldb-snapshot -k arc-data-services -f C:\path\to\backup\controller-1675653451.bak

필수 매개 변수

--backup-file -f

기존 컨트롤러 데이터베이스 백업 파일은 '.bak'로 끝나야 하며 실행 타임스탬프에 따라 고유한 데이터베이스 이름으로 복원됩니다.

--k8s-namespace -k

기존 데이터 컨트롤러의 Kubernetes 네임스페이스입니다.

선택적 매개 변수

--use-k8s

로컬 Kubernetes API를 사용하여 이 작업을 수행합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.