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

az monitor metrics

参考

查看 Azure 资源指标。

命令

名称	说明	类型	状态
az monitor metrics alert	管理准实时指标警报规则。	核心	GA
az monitor metrics alert condition	管理准实时指标警报规则条件。	核心	GA
az monitor metrics alert condition create	生成指标警报规则条件。	核心	预览
az monitor metrics alert create	创建基于指标的警报规则。	核心	GA
az monitor metrics alert delete	删除基于指标的警报规则。	核心	GA
az monitor metrics alert dimension	管理准实时指标警报规则维度。	核心	GA
az monitor metrics alert dimension create	生成指标警报规则维度。	核心	预览
az monitor metrics alert list	列出基于指标的警报规则。	核心	GA
az monitor metrics alert show	显示基于指标的警报规则。	核心	GA
az monitor metrics alert update	更新基于指标的警报规则。	核心	GA
az monitor metrics list	列出资源的指标值。	核心	GA
az monitor metrics list-definitions	列出资源的指标定义。	核心	GA
az monitor metrics list-namespaces	列出资源的指标命名空间。	核心	预览
az monitor metrics list-sub	列出订阅的指标数据。可以在正文上指定参数。	核心	GA
az monitor metrics list-sub-definitions	列出订阅的指标定义。	核心	GA

az monitor metrics list

编辑

列出资源的指标值。

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

示例

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

az monitor metrics list --resource {ResourceName} --metric "Percentage CPU"

列出存储帐户的成功 E2E 延迟，并根据 API 名称拆分数据系列

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName

列出存储帐户的成功 E2E 延迟，并根据 API 名称和地理位置类型拆分数据系列

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --dimension ApiName GeoType

列出存储帐户的成功 E2E 延迟，并使用“--filter”参数根据 API 名称和地理位置类型拆分数据系列

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq '*' and GeoType eq '*'"

列出存储帐户的成功 E2E 延迟，并根据 API 名称和地理位置类型拆分数据系列。将 API 名称限制为“DeleteContainer”

az monitor metrics list --resource {ResourceName} --metric SuccessE2ELatency \
                        --filter "ApiName eq 'DeleteContainer' and GeoType eq '*'"

列出自 2017-01-01 以来每天存储帐户的事务

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --start-time 2017-01-01T00:00:00Z \
                        --interval PT24H

列出自 2017 年以来事务指标的 API 名称维度下的存储帐户的元数据值

az monitor metrics list --resource {ResourceName} --metric Transactions \
                        --filter "ApiName eq '*'" \
                        --start-time 2017-01-01T00:00:00Z

必需参数

--resource

目标资源的名称或 ID。

可选参数

--aggregation

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

接受的值: Average, Count, Maximum, Minimum, None, Total

值来自: az monitor metrics list-definitions

--dimension

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

值来自: az monitor metrics list-definitions

--end-time

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

--filter

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

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

--interval

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

默认值: 1m

--metadata

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

--metrics

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

值来自: az monitor metrics list-definitions

--namespace

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

值来自: az monitor metrics list-namespaces

--offset

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

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

默认值: 1h

--orderby

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

--resource-group -g

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

--resource-namespace

目标资源提供程序命名空间。

--resource-parent

目标资源父路径（如果适用）。

--resource-type

目标资源类型。还可以接受命名空间/类型格式（例如：“Microsoft.Compute/virtualMachines”。

--start-time

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

--top

要检索的最大记录数。

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

az monitor metrics list-definitions

编辑

列出资源的指标定义。

az monitor metrics list-definitions --resource
                                    [--namespace]
                                    [--resource-group]
                                    [--resource-namespace]
                                    [--resource-parent]
                                    [--resource-type]

示例

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

az monitor metrics list-definitions --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName}

必需参数

--resource

目标资源的名称或 ID。

可选参数

--namespace

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

值来自: az monitor metrics list-namespaces

--resource-group -g

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

--resource-namespace

目标资源提供程序命名空间。

--resource-parent

目标资源父路径（如果适用）。

--resource-type

目标资源类型。还可以接受命名空间/类型格式（例如：“Microsoft.Compute/virtualMachines”。

全局参数

--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 monitor metrics list-namespaces

编辑

预览

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

列出资源的指标命名空间。

az monitor metrics list-namespaces --resource-uri
                                   [--start-time]

示例

列出资源的指标命名空间。

az monitor metrics list-namespaces --resource /subscriptions/{subscriptionID}/resourceGroups/{resourceGroup}/Microsoft.Network/networkSecurityGroups/{resourceName} --start-time 2021-03-01T00:00:00Z

必需参数

--resource-uri

资源的标识符。

可选参数

--start-time

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

全局参数

--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 monitor metrics list-sub

编辑

列出订阅的指标数据。可以在正文上指定参数。

az monitor metrics list-sub --region
                            [--aggregation]
                            [--auto-adjust-timegrain {0, 1, f, false, n, no, t, true, y, yes}]
                            [--filter]
                            [--interval]
                            [--metricnames]
                            [--metricnamespace]
                            [--order-by]
                            [--result-type {Data, Metadata}]
                            [--roll-up-by]
                            [--timespan]
                            [--top]
                            [--validate-dimensions {0, 1, f, false, n, no, t, true, y, yes}]

必需参数

--region

要驻留的指标所在的区域。

可选参数

--aggregation

要检索的聚合类型列表（逗号分隔）。

--auto-adjust-timegrain

如果设置为 true，如果此指标不支持传入的时间跨度，API 将使用最近的支持时间跨度返回结果。如果设置为 false，则返回无效时间跨度参数的错误。默认为 false。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--filter

$filter用于减少返回的指标数据集。
示例：
指标包含元数据 A、B 和 C。
- 返回 C 的所有时序，其中 A = a1，B = b1 或 b2
$filter=A eq “a1” 和 B eq 'b1' 或 B eq 'b2' 和 C eq '*'
- 变体无效：
$filter=A eq “a1” 和 B eq 'b1' 和 C eq '*' 或 B = 'b2'
这无效，因为逻辑或运算符不能分隔两个不同的元数据名称。
- 返回所有时序，其中 A = a1，B = b1 和 C = c1：
$filter=A eq “a1”和 B eq 'b1' 和 C eq 'c1'
- 返回 A = a1 的所有时序
$filter=A eq 'a1' 和 B eq '' 和 C eq ''。

--interval

查询的间隔（即时间根）采用 ISO 8601 持续时间格式。默认为 PT1M。 “FULL”值的特殊情况，该值返回所请求的整个时间跨度的单个数据点。 示例：PT15M、PT1H、P1D、FULL。

--metricnames

要检索的指标的名称（逗号分隔）。

--metricnamespace

要驻留的指标的指标命名空间。

--order-by

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

--result-type

减少收集的数据集。允许的语法取决于操作。有关详细信息，请参阅操作的说明。

接受的值: Data, Metadata

--roll-up-by

要汇总结果的维度名称（s）。例如，如果只想查看带有“City eq Seattle 或 City eq Tacoma”等筛选器的指标值，但不想查看每个城市的单独值，则可以指定“RollUpBy=City”以查看西雅图的结果，Tacoma 汇总为一次。

--timespan

查询的时间跨度。它是格式为“startDateTime_ISO/endDateTime_ISO”的字符串。

--top

要检索的最大记录数。仅当指定$filter时才有效。默认值为 10。

--validate-dimensions

设置为 false 时，将忽略无效的筛选器参数值。如果设置为 true，则返回无效筛选器参数的错误。默认为 true。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

全局参数

--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 monitor metrics list-sub-definitions

编辑

列出订阅的指标定义。

az monitor metrics list-sub-definitions --region
                                        [--metricnamespace]

必需参数

--region

要驻留的指标所在的区域。

可选参数

--metricnamespace

要驻留的指标的指标命名空间。

全局参数

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

命令

az monitor metrics list

示例

必需参数

可选参数

az monitor metrics list-definitions

示例

必需参数

可选参数

az monitor metrics list-namespaces

示例

必需参数

可选参数

az monitor metrics list-sub

必需参数

可选参数

az monitor metrics list-sub-definitions

必需参数

可选参数

其他资源