叢集計量設定
當使用者部署叢集時，會啟用一組標準計量進行收集。 如需計量清單，請參閱收集的計量清單。
對於收集這些包含的標準計量，使用者無法控制行為 (啟用或停用)。 不過，使用者可以控制不屬於清單連結的一些選擇性計量收集。 若要啟用此體驗，使用者必須建立和更新叢集的 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 選項會導致以非同步方式執行此命令。 如需詳細資訊，請參閱如何追蹤非同步作業。