共用方式為

叢集計量組態

當使用者部署叢集時，會啟用一組標準計量以供收集。 如需度量清單，請參閱 收集的度量清單。

使用者無法控制（啟用或停用）這些包含在內的標準指標的收集行為。 不過，使用者可以控制一些不屬於清單連結的可選指標的集合。 若要啟用此體驗，使用者必須建立和更新叢集的 MetricsConfiguration 資源。 根據預設，建立此 MetricsConfiguration 資源不會變更計量的集合。 使用者必須更新資源，才能啟用或停用這些選擇性計量收集。

備註

  • 對於叢集，最多只能建立一個 MetricsConfiguration 資源。
  • 使用者需要建立 MetricsConfiguration 資源，以檢查可控制的選用指標清單。
  • 刪除 MetricsConfiguration 資源會導致還原標準指標集。

如何管理叢集計量組態

為了支援叢集指標組態的生命週期，下列互動可讓您建立和管理叢集的指標組態。

建立指標組態

使用命令 az network cluster metricsconfiguration create 來建立叢集的度量組態。 如果您有多個 Azure 訂用帳戶，使用者必須使用旗標 --subscription <SUBSCRIPTION_ID> 將訂用帳戶識別碼傳遞至 CLI 命令，或使用 az account set 命令選取適當的訂用帳戶識別碼。

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

計量設定元素

參數名稱 Description
叢集 叢集的資源名稱
位置 部署叢集的 Azure 區域
CLUSTER_EXTENDED_LOCATION_ID Azure 門戶的叢集擴展位置
收集間隔 預設標準指標的收集頻率
資源群組 叢集資源群組名稱
TAG_KEY1 選擇性的 tag1 用於傳遞至 MetricsConfiguration create
TAG_VALUE1 要傳遞至 MetricsConfiguration create 的選用 tag1 值
TAG_KEY2 可選的 tag2 會傳遞至 MetricsConfiguration 的創建過程
TAG_VALUE2 傳遞選用的 tag2 值至「MetricsConfiguration create」
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>"

操作員可以獨立更新collection-interval，而不依賴enabled-metrics清單。 省略未變更的欄位。

在 az 命令中指定 --no-wait --debug 選項會導致此命令被非同步執行。 如需詳細資訊，請參閱如何追蹤非同步作業。

刪除指標組態

刪除指標組態會將叢集傳回未變更的組態。 若要刪除指標組態，請使用下列命令：

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

在 az 命令中指定 --no-wait --debug 選項會導致此命令被非同步執行。 如需詳細資訊，請參閱如何追蹤非同步作業。

  • Last updated on