az arcdata dc debug

Note

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

偵錯數據控制器。

命令

名稱	Description	類型	狀態
az arcdata dc debug controldb-cdc	在數據控制器資料庫和數據表上啟用/停用 CDC - 僅供疑難解答之用。	Extension	GA
az arcdata dc debug copy-logs	複製記錄。	Extension	GA
az arcdata dc debug dump	觸發記憶體轉儲。	Extension	GA
az arcdata dc debug restore-controldb-snapshot	從備份還原 ControlDB 的唯一複本 - 僅供疑難解答之用。	Extension	GA

az arcdata dc debug controldb-cdc

在數據控制器資料庫和數據表上啟用/停用 CDC - 僅供疑難解答之用。

啟用/停用「控制器」資料庫的異動數據擷取，以及具有可設定保留時數的支持數據表。

az arcdata dc debug controldb-cdc --k8s-namespace
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--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 命名空間。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--enable

啟用或停用異動數據擷取。

屬性	值
接受的值:	false, true

--retention-hours

CDC 保留期間，以小時為單位指定。 允許的值為 1 到 24。

屬性	值
預設值:	8

--use-k8s

使用本機 Kubernetes API 來執行此動作。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az arcdata dc debug copy-logs

複製記錄。

從數據控制器複製偵錯記錄 - 系統上需要 Kubernetes 設定。

az arcdata dc debug copy-logs --k8s-namespace
                              [--acquire-policy-token]
                              [--change-reference]
                              [--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 命名空間。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

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

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az arcdata dc debug dump

觸發記憶體轉儲。

觸發記憶體轉儲並從容器複製它 - 系統上需要 Kubernetes 設定。

az arcdata dc debug dump --k8s-namespace
                         [--acquire-policy-token]
                         [--change-reference]
                         [--container {controller}]
                         [--target-folder]
                         [--use-k8s]

必要參數

--k8s-namespace -k

數據控制器的 Kubernetes 命名空間。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--container -c

要觸發以傾印執行中進程的目標容器。

屬性	值
預設值:	controller
接受的值:	controller

--target-folder -d

要複製傾印的目標資料夾。

屬性	值
預設值:	./output/dump

--use-k8s

使用本機 Kubernetes API 來執行此動作。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az arcdata dc debug restore-controldb-snapshot

從備份還原 ControlDB 的唯一複本 - 僅供疑難解答之用。

以唯一名稱還原 ControlDB 的COPY_ONLY備份以進行疑難解答 - 系統上需要 Kubernetes 設定。

az arcdata dc debug restore-controldb-snapshot --backup-file
                                               --k8s-namespace
                                               [--acquire-policy-token]
                                               [--change-reference]
                                               [--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 命名空間。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--use-k8s

使用本機 Kubernetes API 來執行此動作。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False