通过

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

az vm monitor metrics

  • 预览
  • 参考

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

管理 VM 的指标。

命令

名称 说明 类型 Status
az vm monitor metrics list-definitions

列出 VM 的指标定义。

 核心 预览
az vm monitor metrics tail

列出 VM 的指标值。

 核心 预览版

az vm monitor metrics list-definitions

编辑
预览

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

列出 VM 的指标定义。

az vm monitor metrics list-definitions --name
                                       --resource-group
                                       [--namespace]

示例

列出 VM 的指标定义。 （自动生成）

az vm monitor metrics list-definitions --name MyIDVirtualMachine --resource-group MyResourceGroup

必需参数

--name -n

虚拟机的名称或 ID。

--resource-group -g

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

可选参数

--namespace

要查询其指标定义的命名空间。

全局参数
--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 vm monitor metrics tail

编辑
预览

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

列出 VM 的指标值。

az vm monitor metrics tail --name
                           --resource-group
                           [--aggregation {Average, Count, Maximum, Minimum, None, Total}]
                           [--dimension]
                           [--end-time]
                           [--filter]
                           [--interval]
                           [--metadata]
                           [--metrics]
                           [--namespace]
                           [--offset]
                           [--orderby]
                           [--start-time]
                           [--top]

示例

列出过去一小时内 VM 的 CPU 使用率

az vm monitor metrics tail --name myVM -g myRG --metric "Percentage CPU"

列出从 2019-12-18T00：00：00Z 开始的 VM 的一小时 CPU 使用率

az vm monitor metrics tail --name myVM -g myRG --metric "Percentage CPU" --start-time 2019-12-18T00:00:00Z

列出过去一小时内 VM 的 CPU 使用率和筛选器

az vm monitor metrics tail --name myVM -g myRG --metrics "Per Disk Read Bytes/sec" --filter "SlotId eq '*'"

必需参数

--name -n

虚拟机的名称或 ID。

--resource-group -g

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

可选参数

--aggregation

要检索的聚合类型列表（空格分隔）。

接受的值: Average, Count, Maximum, Minimum, None, Total
值来源: az vm monitor metrics list-definitions -n MyVM -g MyRG --query "@[*].supportedAggregationTypes"
--dimension

查询指标的维度列表（空格分隔）。

值来源: az vm monitor metrics list-definitions -n MyVM -g MyRG --query "@[*].dimensions"
--end-time

查询的结束时间。 默认为当前时间。 格式：date （yyyy-mm-dd） 时间 （hh：mm：ss.xxxxx） 时区 （+/-hh：mm）。

--filter

用于减少返回的指标数据集的字符串。 例如 “LUN eq '*'”。

有关筛选器的完整列表，请参阅筛选器字符串引用。https://docs.microsoft.com/rest/api/monitor/metrics/list

--interval

聚合指标的间隔（采用 ##h##m 格式）。

默认值: 1m
--metadata

返回元数据值而不是指标数据。

--metrics

要检索的指标名称的空格分隔列表。

值来源: az vm monitor metrics list-definitions -n MyVM -g MyRG --query "@[*].name.value"
--namespace

要查询其指标定义的命名空间。

--offset

查询范围的时间偏移量，采用 ##d##h 格式。

可与 --start-time 或 --end-time 一起使用。 如果与 --start-time 一起使用，则通过添加偏移量来计算结束时间。 如果与 --end-time（默认值）一起使用，则通过减去偏移量来计算开始时间。 如果提供了 --start-time 和 --end-time，则将忽略 --offset。

默认值: 1h
--orderby

用于对结果进行排序和排序方向的聚合。 只能指定一个订单。 示例：sum asc。

--start-time

查询的开始时间。 格式：date （yyyy-mm-dd） 时间 （hh：mm：ss.xxxxx） 时区 （+/-hh：mm）。

--top

要检索的最大记录数。 仅当使用 --filter 时才有效。

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