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

az iot hub distributed-tracing

  • 预览
  • 参考

注意

此参考是 Azure CLI（版本 2.37.0 或更高版本）的 azure-iot 扩展的一部分。 该扩展将在首次运行 az iot hub distributed-tracing 命令时自动安装。 详细了解扩展。

此命令组处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

管理每个设备的分布式设置。

命令

名称 说明 类型 状态
az iot hub distributed-tracing show

获取设备的分布式跟踪设置。

 分机 预览
az iot hub distributed-tracing update

更新设备的分布式跟踪选项。

 分机 预览

az iot hub distributed-tracing show

预览

命令组“iot 中心分布式跟踪”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

获取设备的分布式跟踪设置。

az iot hub distributed-tracing show --device-id
                                    --hub-name
                                    [--auth-type {key, login}]
                                    [--resource-group]

示例

获取设备的分布式跟踪设置

az iot hub distributed-tracing show -d {device_id} -n {iothub_name}

必需参数

--device-id -d

目标设备 ID。

--hub-name -n

IoT 中心名称或主机名。 如果未提供 --login，则为必需。

可选参数

--auth-type

指示操作是应自动派生策略密钥还是使用当前的 Azure AD 会话。 如果身份验证类型为登录，并且提供资源主机名，则除非需要，否则将跳过资源查找。可以使用 < a0/a0> 配置默认值 az configure --defaults iothub-data-auth-type=<auth-type-value>。

接受的值: key, login
默认值: key
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数
--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 iot hub distributed-tracing update

预览

命令组“iot 中心分布式跟踪”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

更新设备的分布式跟踪选项。

az iot hub distributed-tracing update --device-id
                                      --hub-name
                                      --sampling-mode {off, on}
                                      --sampling-rate
                                      [--auth-type {key, login}]
                                      [--resource-group]

示例

更新设备的分布式跟踪选项

az iot hub distributed-tracing update -d {device_id} --sm on --sr 50 -n {iothub_name}

必需参数

--device-id -d

目标设备 ID。

--hub-name -n

IoT 中心名称或主机名。 如果未提供 --login，则为必需。

--sampling-mode --sm

打开和关闭分布式跟踪的采样。 1 为 On，2 为 Off。

接受的值: off, on
--sampling-rate --sr

控制为添加跟踪上下文而采样的消息量。 此值为百分比。 仅允许从 0 到 100（含）的值。

可选参数

--auth-type

指示操作是应自动派生策略密钥还是使用当前的 Azure AD 会话。 如果身份验证类型为登录，并且提供资源主机名，则除非需要，否则将跳过资源查找。可以使用 < a0/a0> 配置默认值 az configure --defaults iothub-data-auth-type=<auth-type-value>。

接受的值: key, login
默认值: key
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数
--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 获取完整的调试日志。