你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az arcdata dc debug

注意

此参考是 Azure CLI（版本 2.3.1 或更高版本）的 arcdata 扩展的一部分。 该扩展将在首次运行 az arcdata dc debug 命令时自动安装。 详细了解扩展。

调试数据控制器。

命令

名称	说明	类型	状态
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 数据服务日志。 默认值为 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

订阅的名称或 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 获取完整的调试日志。