通过

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

az arcdata dc debug

Note

This reference is part of the arcdata extension for the Azure CLI (version 2.3.1 or higher). 该扩展将在首次运行 az arcdata dc debug 命令时自动安装。 Learn more about extensions.

调试数据控制器。

命令

名称 说明 类型 Status
az arcdata dc debug controldb-cdc

在数据控制器数据库和表上启用/禁用 CDC - 仅用于故障排除目的。

 Extension GA
az arcdata dc debug copy-logs

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
                                  [--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 命名空间。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--enable

启用或禁用更改数据捕获。

属性 值
接受的值: false, true
--retention-hours

CDC 保留期，以小时为单位指定。 允许的值为 1 到 24。

属性 值
默认值: 8
--use-k8s

使用本地 Kubernetes API 来执行此操作。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

Output format.

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az arcdata dc debug copy-logs

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 命名空间。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Output format.

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az arcdata dc debug dump

触发内存转储。

触发内存转储并将其从容器复制 - 系统上需要 Kubernetes 配置。

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

必需参数

--k8s-namespace -k

数据控制器的 Kubernetes 命名空间。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--container -c

要触发的目标容器，用于转储正在运行的进程。

属性 值
默认值: controller
接受的值: controller
--target-folder -d

要复制转储的目标文件夹。

属性 值
默认值: ./output/dump
--use-k8s

使用本地 Kubernetes API 来执行此操作。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

Output format.

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 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
                                               [--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 命名空间。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--use-k8s

使用本地 Kubernetes API 来执行此操作。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

Output format.

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False