Share via

叢集計量設定

  • 發行項

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

使用者無法控制收集這些包含標準計量的行為（啟用或停用）。 不過，使用者可以控制不屬於清單連結的一些選擇性計量集合。 若要啟用此體驗，使用者必須建立及更新叢集的 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>"
  • 將 中的 <> 值取代為您的特定資訊。
  • 查詢叢集資源，並在 中尋找 的值 <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>"

運算子可以更新 collection-interval 與 enabled-metrics 清單無關。 省略未變更的欄位。

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

刪除計量組態

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

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

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