你当前正在访问 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>"
  • 将内部 <> 值替换为特定信息。
  • 查询群集资源并查找 中的值<CLUSTER-EXTENDED-LOCATION-ID>properties.clusterExtendedLocation
  • 该 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”

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

注意

  • 标准指标集的默认指标收集间隔设置为每 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。 省略未更改的字段。

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

删除指标配置

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

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

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