Konfiguration av klustermått
När användaren distribuerar ett kluster aktiveras en standarduppsättning mått för insamling. En lista över mått finns i Lista över insamlade mått.
Användare kan inte styra beteendet (aktivera eller inaktivera) för insamling av dessa inkluderade standardmått. Användarna kan dock styra samlingen med vissa valfria mått som inte ingår i länken till listan. För att aktivera den här upplevelsen måste användarna skapa och uppdatera en MetricsConfiguration-resurs för ett kluster. Som standard ändrar inte skapandet av den här MetricsConfiguration-resursen samlingen med mått. Användaren måste uppdatera resursen för att aktivera eller inaktivera den här valfria måttsamlingen.
Kommentar
- För ett kluster kan endast en MetricsConfiguration-resurs skapas.
- Användare måste skapa en MetricsConfiguration-resurs för att kontrollera en lista över valfria mått som kan kontrolleras.
- Borttagning av metricsConfiguration-resursen resulterar i att standarduppsättningen med mått återställs.
Hantera konfiguration av klustermått
För att stödja livscykeln för klustermåttkonfigurationer möjliggör följande interaktioner skapande och hantering av ett klusters måttkonfigurationer.
Skapa en måttkonfiguration
az network cluster metricsconfiguration create
Använd kommandot för att skapa måttkonfiguration för kluster. Om du har flera Azure-prenumerationer måste användaren skicka prenumerations-ID antingen med en flagga --subscription <SUBSCRIPTION_ID>
till CLI-kommandot eller välja lämpligt prenumerations-ID med kommandot 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>"
- Ersätt värden inom
<
>
med din specifika information. - Fråga klusterresursen och hitta värdet
<CLUSTER-EXTENDED-LOCATION-ID>
för iproperties.clusterExtendedLocation
- Fältet
collection-interval
är ett obligatoriskt fält ochenabled-metrics
är ett valfritt fält.
Operatorer kan också ange listan över aktiverade mått via json- eller yaml-fil.
Exempel: enabled-metrics.json fil
[
"metric_1",
"metric_2"
]
Exempel: filen enabled-metrics.yaml
- "metric_1"
- "metric_2"
Exempelkommando för att använda json/yaml-filen enabled-metrics:
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>"
<Här kan path-to-yaml-or-json-file> vara ./enabled-metrics.json eller ./enabled-metrics.yaml (placera filen under aktuell arbetskatalog) innan du utför åtgärden.
Om du vill se alla tillgängliga parametrar och deras beskrivning kör du kommandot:
az networkcloud cluster metricsconfiguration create --help
Konfigurationselement för mått
Parameternamn | beskrivning |
---|---|
KLUSTER | Resursnamn för kluster |
PLATS | Den Azure-region där klustret distribueras |
CLUSTER_EXTENDED_LOCATION_ID | Den utökade platsen för klustret från Azure Portal |
COLLECTION_INTERVAL | Insamlingsfrekvensen för standardstandardmått |
RESOURCE_GROUP | Namnet på klusterresursgruppen |
TAG_KEY1 | Valfri tagg1 som ska skickas till MetricsConfiguration create |
TAG_VALUE1 | Valfritt tag1-värde som ska skickas till MetricsConfiguration create |
TAG_KEY2 | Valfri tag2 för att skicka till MetricsConfiguration create |
TAG_VALUE2 | Valfritt tag2-värde som ska skickas till MetricsConfiguration create |
METRIC_TO_ENABLE_1 | Valfritt mått "METRIC_TO_ENABLE_1" aktiverat utöver standardmåtten |
METRIC_TO_ENABLE_2 | Valfritt mått "METRIC_TO_ENABLE_2" aktiverat utöver standardmåtten |
Om du anger --no-wait --debug
alternativ i az-kommandot körs kommandot asynkront. Mer information finns i spåra asynkrona åtgärder.
Kommentar
- Standardintervallet för insamling av mått för standarduppsättningen av mått anges till var femte minut.
collectionInterval
Om du ändrar den påverkas även insamlingsfrekvensen för standardstandardmått. - Det kan bara finnas en uppsättning måttkonfiguration definierad per kluster. Resursen skapas med namnet
default
.
Visa en lista över måttkonfigurationen
Du kan kontrollera måttkonfigurationsresursen för ett specifikt kluster med hjälp az networkcloud cluster metricsconfiguration list
av kommandot:
az networkcloud cluster metricsconfiguration list \
--cluster-name "<CLUSTER>" \
--resource-group "<RESOURCE_GROUP>"
Hämta en måttkonfiguration
När en måttkonfiguration har skapats kan operatörer kontrollera informationen för resursen med hjälp av az networkcloud cluster metricsconfiguration show
kommandot:
az networkcloud cluster metricsconfiguration show \
--cluster-name "<CLUSTER>" \
--resource-group "<RESOURCE_GROUP>"
Det här kommandot returnerar en JSON-representation av måttkonfigurationen. Du kan se listan över aktiverade och inaktiverade mått utöver samlingsfrekvensen som utdata för det här kommandot.
Uppdatera en måttkonfiguration
Precis som när en måttkonfiguration skapas kan operatörer utföra en uppdateringsåtgärd för att ändra konfigurationen eller uppdatera taggarna som tilldelats till måttkonfigurationen.
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>"
Operatorer kan uppdatera collection-interval
oberoende av enabled-metrics
listan. Utelämna fält som inte ändras.
Om du anger --no-wait --debug
alternativ i az-kommandot körs kommandot asynkront. Mer information finns i spåra asynkrona åtgärder.
Ta bort en måttkonfiguration
Borttagning av måttkonfigurationen returnerar klustret till en oförändrad konfiguration. Om du vill ta bort en måttkonfiguration använder du kommandot:
az networkcloud cluster metricsconfiguration delete \
--cluster-name "<CLUSTER>" \
--resource-group "<RESOURCE_GROUP>"
Om du anger --no-wait --debug
alternativ i az-kommandot körs kommandot asynkront. Mer information finns i spåra asynkrona åtgärder.