共用方式為

叢集計量設定

  • 發行項

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

對於收集這些包含的標準計量，使用者無法控制行為 (啟用或停用)。 不過，使用者可以控制不屬於清單連結的一些選擇性計量收集。 若要啟用此體驗，使用者必須建立和更新叢集的 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

計量設定元素

參數名稱 描述
CLUSTER 叢集的資源名稱
LOCATION 部署叢集的 Azure 區域
CLUSTER_EXTENDED_LOCATION_ID 來自 Azure 入口網站的叢集擴充位置
COLLECTION_INTERVAL 預設標準計量的收集頻率
RESOURCE_GROUP 叢集資源群組名稱
TAG_KEY1 要傳遞至 MetricsConfiguration create 的選擇性 tag1
TAG_VALUE1 要傳遞至 MetricsConfiguration create 的選擇性 tag1 值
TAG_KEY2 要傳遞至 MetricsConfiguration create 的選擇性 tag2
TAG_VALUE2 要傳遞至 MetricsConfiguration create 的選擇性 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 選項會導致以非同步方式執行此命令。 如需詳細資訊，請參閱如何追蹤非同步作業。