az arcdata dc debug

注意

此參考是 Azure CLI 的 arcdata 延伸模組的一部分 （2.3.1 版或更高版本）。 擴充功能會在您第一次執行 az arcdata dc debug 命令時自動安裝。 深入了解擴充功能。

偵錯資料控制器。

命令

名稱	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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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 資料服務記錄。 預設值為 False，其中包含所有 Arc 資料服務容器記錄。

預設值: False

--exclude-cluster-info

是否要從每個命名空間的結果資料夾排除 kubernetes 資源資訊。 預設值為 False，其中包含命名空間資源資訊。

預設值: False

--exclude-controldb

是否要從結果資料夾中排除 controldb 的備份。 預設值為 False，其中包含 controldb 備份。

預設值: False

--exclude-dumps

是否要從結果資料夾排除傾印。 預設值為 False，表示要包含傾印。

預設值: False

--exclude-system-logs

是否要從集合中排除 kube-system 和 azure-arc 命名空間記錄。 如果可存取，預設值為 False，其中包含 kube-system 和 connectedk8s 記錄。

預設值: 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。