通过

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

群集指标配置

  • 项目

当用户部署群集时，会为收集启用一组标准指标。 如需指标列表，请参阅收集的指标列表。

用户无法控制这些包含的标准指标的收集行为（启用或禁用）。 不过，用户可以控制不属于列表链接的一些可选指标的收集。 若要启用此体验，用户必须为群集创建和更新 MetricsConfiguration 资源。 默认情况下，创建此 MetricsConfiguration 资源不会更改指标的收集。 用户必须更新资源才能启用或禁用这些可选指标收集。

注意

  • 对于群集，最多只能创建一个 MetricsConfiguration 资源。
  • 用户需要创建 MetricsConfiguration 资源来检查可控制的可选指标的列表。
  • 删除 MetricsConfiguration 资源会导致还原标准指标集。

如何管理群集指标配置

为了支持群集指标配置的生命周期，以下交互允许创建和管理群集的指标配置。

创建指标配置

使用 az network cluster metricsconfiguration create 命令为群集创建指标配置。 如果有多个 Azure 订阅，用户必须使用标志 --subscription <SUBSCRIPTION_ID> 将订阅 ID 传递给 CLI 命令，或使用 az account set 命令选择相应的订阅 ID。

az networkcloud cluster metricsconfiguration create \
 --cluster-name "<CLUSTER>" \
 --extended-location name="<CLUSTER_EXTENDED_LOCATION_ID>" type="CustomLocation" \
 --location "<LOCATION>" \
 --collection-interval <COLLECTION_INTERVAL (1-1440)> \
 --enabled-metrics "<METRIC_TO_ENABLE_1>" "<METRIC_TO_ENABLE_2>" \
 --tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
 --resource-group "<RESOURCE_GROUP>"
  • 将 < > 内的值替换为你的具体信息。
  • 查询群集资源并查找 properties.clusterExtendedLocation 中 <CLUSTER-EXTENDED-LOCATION-ID> 的值
  • collection-interval 字段是必填字段，而 enabled-metrics 是一个可选字段。

或者，运营商可以通过 json 或 yaml 文件提供启用的指标的列表。

示例：enabled-metrics.json 文件

[
   "metric_1",
   "metric_2"
]

示例：enabled-metrics.yaml 文件

- "metric_1"
- "metric_2"

使用 enabled-metrics json/yaml 文件的示例命令：

az networkcloud cluster metricsconfiguration create \
 --cluster-name "<CLUSTER>" \
 --extended-location name="<CLUSTER_EXTENDED_LOCATION_ID>" type="CustomLocation" \
 --location "<LOCATION>" \
 --collection-interval <COLLECTION_INTERVAL (1-1440)> \
 --enabled-metrics <path-to-yaml-or-json-file> \
 --tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
 --resource-group "<RESOURCE_GROUP>"

此处，在执行操作前，<path-to-yaml-or-json-file> 可以是 ./enabled-metrics.json 或 ./enabled-metrics.yaml（将文件置于当前工作目录下）。

若要查看所有可用参数及其说明，请运行以下命令：

az networkcloud cluster metricsconfiguration create --help

指标配置元素

参数名称 说明
群集 群集的资源名称
LOCATION 在其中部署了群集的 Azure 区域
CLUSTER_EXTENDED_LOCATION_ID Azure 门户中的群集扩展位置
COLLECTION_INTERVAL 默认标准指标的收集频率
RESOURCE_GROUP 群集资源组名称
TAG_KEY1 要传递给 MetricsConfiguration 创建的可选 tag1
TAG_VALUE1 要传递给 MetricsConfiguration 创建的可选 tag1 值
TAG_KEY2 要传递给 MetricsConfiguration 创建的可选 tag2
TAG_VALUE2 要传递给 MetricsConfiguration 创建的可选 tag2 值
METRIC_TO_ENABLE_1 除了默认指标之外，还启用了可选指标“METRIC_TO_ENABLE_1”
METRIC_TO_ENABLE_2 除了默认指标之外，还启用了可选指标“METRIC_TO_ENABLE_2”

在 az 命令中指定 --no-wait --debug 选项会导致异步执行此命令。 有关详细信息，请参阅如何跟踪异步操作。

注意

  • 标准指标集的默认指标收集间隔设置为每 5 分钟一次。 更改 collectionInterval 也会影响默认标准指标的收集频率。
  • 每个群集只能定义一组指标配置。 资源使用名称 default 创建。

列出指标配置

可以使用 az networkcloud cluster metricsconfiguration list 命令检查特定群集的指标配置资源：

az networkcloud cluster metricsconfiguration list \
 --cluster-name "<CLUSTER>" \
 --resource-group "<RESOURCE_GROUP>"

检索指标配置

创建指标配置后，运营商可以使用 az networkcloud cluster metricsconfiguration show 命令检查资源的详细信息：

az networkcloud cluster metricsconfiguration show \
 --cluster-name "<CLUSTER>" \
 --resource-group "<RESOURCE_GROUP>"

此命令返回指标配置的 JSON 表示形式。 除了收集频率作为此命令的输出外，还可以观察已启用和禁用的指标的列表。

更新指标配置

与创建指标配置类似，运营商可以执行更新操作来更改配置或更新分配给指标配置的标记。

az networkcloud cluster metricsconfiguration update \
 --cluster-name "<CLUSTER>" \
 --collection-interval <COLLECTION_INTERVAL (1-1440)> \
 --enabled-metrics "<METRIC_TO_ENABLE_1>" "<METRIC_TO_ENABLE_2>" \
 --tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
 --resource-group "<RESOURCE_GROUP>"

运营商可以独立于 enabled-metrics 列表更新 collection-interval。 省略未更改的字段。

在 az 命令中指定 --no-wait --debug 选项会导致异步执行此命令。 有关详细信息，请参阅如何跟踪异步操作。

删除指标配置

删除指标配置会将群集返回到未更改的配置。 若要删除指标配置，请使用以下命令：

az networkcloud cluster metricsconfiguration delete \
 --cluster-name "<CLUSTER>" \
 --resource-group "<RESOURCE_GROUP>"

在 az 命令中指定 --no-wait --debug 选项会导致异步执行此命令。 有关详细信息，请参阅如何跟踪异步操作。