Freigeben über


Konfiguration von Clustermetriken

Wenn der Benutzer einen Cluster bereitstellt, wird ein Standardsatz von Metriken für die Sammlung aktiviert. Eine Liste der Metriken finden Sie unter "Liste der gesammeltenMetriken".

Benutzer können das Verhalten (aktivieren oder deaktivieren) nicht für die Sammlung dieser enthaltenen Standardmetriken steuern. Benutzer können jedoch die Sammlung einiger optionaler Metriken steuern, die nicht Teil des Links zur Liste sind. Um diese Erfahrung zu ermöglichen, müssen Benutzer eine MetricsConfiguration-Ressource für einen Cluster erstellen und aktualisieren. Standardmäßig ändert die Erstellung dieser MetricsConfiguration-Ressource nicht die Sammlung von Metriken. Der Benutzer muss die Ressource aktualisieren, um diese optionalen Metrikensammlungen zu aktivieren oder zu deaktivieren.

Hinweis

  • Für einen Cluster kann maximal eine MetricsConfiguration-Ressource erstellt werden.
  • Benutzer müssen eine MetricsConfiguration-Ressource erstellen, um eine Liste der optionalen Metriken zu überprüfen, die gesteuert werden können.
  • Das Löschen der MetricsConfiguration-Ressource führt dazu, dass die Standardmenge der wiederhergestellten Metriken wiederhergestellt wird.

So verwalten Sie die Konfiguration von Clustermetriken

Um den Lebenszyklus von Clustermetrik-Konfigurationen zu unterstützen, ermöglichen die folgenden Interaktionen die Erstellung und Verwaltung der Metrikkonfigurationen eines Clusters.

Erstellen einer Metrikkonfiguration

Verwenden Sie den az network cluster metricsconfiguration create Befehl zum Erstellen der Metrikkonfiguration für cluster. Wenn Sie über mehrere Azure-Abonnements verfügen, muss der Benutzer entweder die Abonnement-ID mit einem Flag --subscription <SUBSCRIPTION_ID> an den CLI-Befehl übergeben oder die entsprechende Abonnement-ID mit dem Befehl az Konto einstellen auswählen.

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>"
  • Ersetzen Sie Werte innerhalb <> ihrer spezifischen Informationen.
  • Abfragen der Clusterressource und Suchen des Werts <CLUSTER-EXTENDED-LOCATION-ID> in der properties.clusterExtendedLocation
  • Das collection-interval Feld ist ein Pflichtfeld und enabled-metrics ist ein optionales Feld.

Alternativ können Operatoren die Liste der aktivierten Metriken über json- oder yaml-Datei bereitstellen.

Beispiel: enabled-metrics.json Datei

[
   "metric_1",
   "metric_2"
]

Beispiel: enabled-metrics.yaml Datei

- "metric_1"
- "metric_2"

Beispielbefehl für die Verwendung der json/yaml-Datei mit aktivierten Metriken:

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>"

<Hier kann Pfad-to-yaml-or-json-file> ./enabled-metrics.json oder ./enabled-metrics.yaml sein (die Datei unter dem aktuellen Arbeitsverzeichnis platzieren), bevor Sie die Aktion ausführen.

Um eine Liste der verfügbaren Parameter und ihrer Beschreibung anzuzeigen, führen Sie den folgenden Befehl aus:

az networkcloud cluster metricsconfiguration create --help

Metrikkonfigurationselemente

Parametername Beschreibung
CLUSTER Ressourcenname des Clusters
LOCATION Die Azure-Region, in der der Cluster bereitgestellt wird
CLUSTER_EXTENDED_LOCATION_ID Der erweiterte Clusterstandort über das Azure-Portal
SAMMLUNGSINTERVALL Die Sammlungshäufigkeit für Standardmetriken
RESOURCE_GROUP Der Name der Clusterressourcengruppe
TAG_KEY1 Optionales Tag1, das an MetricsConfiguration übergeben werden soll
TAG_VALUE1 Optionaler tag1-Wert, der an MetricsConfiguration übergeben werden soll
TAG_KEY2 Optionales Tag2, das an MetricsConfiguration übergeben werden soll
TAG_VALUE2 Optionaler Tag2-Wert, der an metricsConfiguration übergeben werden soll
METRIC_TO_ENABLE_1 Optionale Metrik "METRIC_TO_ENABLE_1" zusätzlich zu den Standardmetriken aktiviert
METRIC_TO_ENABLE_2 Optionale Metrik "METRIC_TO_ENABLE_2" zusätzlich zu den Standardmetriken aktiviert

Wenn Sie --no-wait --debug-Optionen im az-Befehl angeben, wird dieser Befehl asynchron ausgeführt. Weitere Informationen finden Sie unter Nachverfolgen asynchroner Vorgänge.

Hinweis

  • Das Standardmetrikensammlungsintervall für standardsätze von Metriken wird alle 5 Minuten festgelegt. Das Ändern von collectionInterval wirkt sich auch auf die Sammlungshäufigkeit für Standardmetriken aus.
  • Es kann nur eine Gruppe von Metrikkonfigurationen pro Cluster definiert werden. Die Ressource wird mit dem Namen defaulterstellt.

Auflisten der Metrikkonfiguration

Mithilfe des az networkcloud cluster metricsconfiguration list Befehls können Sie die Metrikkonfigurationsressource für einen bestimmten Cluster überprüfen:

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

Abrufen einer Metrikkonfiguration

Nachdem eine Metrikkonfiguration erstellt wurde, können Operatoren die Details für die Ressource mithilfe des az networkcloud cluster metricsconfiguration show Befehls überprüfen:

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

Dieser Befehl gibt eine JSON-Darstellung der Metrikkonfiguration zurück. Sie können die Liste der aktivierten und deaktivierten Metriken zusätzlich zur Sammlungshäufigkeit als Ausgabe für diesen Befehl beobachten.

Aktualisieren einer Metrikkonfiguration

Ähnlich wie beim Erstellen einer Metrikkonfiguration können Operatoren eine Aktualisierungsaktion ausführen, um die Konfiguration zu ändern oder die Tags zu aktualisieren, die der Metrikkonfiguration zugewiesen sind.

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>"

Operatoren können collection-interval unabhängig von der enabled-metrics Liste aktualisiert werden. Lassen Sie Felder weg, die nicht geändert werden.

Wenn Sie --no-wait --debug-Optionen im az-Befehl angeben, wird dieser Befehl asynchron ausgeführt. Weitere Informationen finden Sie unter Nachverfolgen asynchroner Vorgänge.

Löschen einer Metrikkonfiguration

Das Löschen der Metrikkonfiguration gibt den Cluster an eine unveränderte Konfiguration zurück. Verwenden Sie den Befehl, um eine Metrikkonfiguration zu löschen:

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

Wenn Sie --no-wait --debug-Optionen im az-Befehl angeben, wird dieser Befehl asynchron ausgeführt. Weitere Informationen finden Sie unter Nachverfolgen asynchroner Vorgänge.