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

az monitor app-insights metrics

  • 参考

注意

此参考是 Azure CLI（版本 2.55.0 或更高版本）的 application-insights 扩展的一部分。 该扩展将在首次运行 az monitor app-insights metrics 命令时自动安装。 详细了解扩展。

从应用程序检索指标。

命令

名称 说明 类型 状态
az monitor app-insights metrics get-metadata

获取特定应用程序上的指标的元数据。

 扩展 GA
az monitor app-insights metrics show

查看单个指标的值。

 扩展 GA

az monitor app-insights metrics get-metadata

获取特定应用程序上的指标的元数据。

az monitor app-insights metrics get-metadata [--app]
                                             [--ids]
                                             [--resource-group]
                                             [--subscription]

示例

查看提供的应用的元数据。

az monitor app-insights metrics get-metadata --app e292531c-eb03-4079-9bb0-fe6b56b99f8b

可选参数

--app -a

Application Insights 组件的 GUID、应用名称或完全限定的 Azure 资源名称。 可以从Azure 门户中任何 Application Insights 资源上的 API 访问菜单项获取应用程序 GUID。 如果使用应用程序名称，请指定资源组。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

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

--subscription

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

全局参数
--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 app-insights metrics show

查看单个指标的值。

az monitor app-insights metrics show --metrics
                                     [--aggregation]
                                     [--app]
                                     [--end-time]
                                     [--filter]
                                     [--ids]
                                     [--interval]
                                     [--offset]
                                     [--orderby]
                                     [--resource-group]
                                     [--segment]
                                     [--start-time]
                                     [--subscription]
                                     [--top]

示例

查看 availabilityResults 事件的计数。

az monitor app-insights metrics show --app e292531c-eb03-4079-9bb0-fe6b56b99f8b --metric availabilityResults/count

必需参数

--metrics -m

要检索的指标。 可以是标准 AI 指标或特定于应用程序的自定义指标。

可选参数

--aggregation

计算指标值时要使用的聚合。 若要一次检索多个聚合，请使用逗号分隔它们。 如果未指定聚合，则使用指标的默认聚合。

--app -a

Application Insights 组件的 GUID、应用名称或完全限定的 Azure 资源名称。 可以从Azure 门户中任何 Application Insights 资源上的 API 访问菜单项获取应用程序 GUID。 如果使用应用程序名称，请指定资源组。

--end-time

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

--filter

用于筛选结果的表达式。 此值应该是有效的 OData 筛选器表达式，其中每个子句的键应是所检索指标的适用维度。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--interval

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

--offset

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

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

默认值: 1h
--orderby

聚合函数和排序依据的段的方向。 仅当指定段时，此值才有效。

--resource-group -g

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

--segment

要按其细分指标值的维度的名称。 此维度必须适用于要检索的指标。 若要一次按多个维度分段，请用逗号（，）分隔它们。 在这种情况下，指标数据将按维度列在参数中的顺序进行分段。

--start-time

要为其检索数据的开始时间范围。 格式：date （yyyy-mm-dd） 时间 （hh：mm：ss.xxxxx） 时区 （+/-hh：mm）。

--subscription

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

--top

要返回的段数。 仅当指定段时，此值才有效。

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