Konfiguracja metryk klastra

  • Artykuł

Gdy użytkownik wdraża klaster, standardowy zestaw metryk zostanie włączony dla kolekcji. Aby uzyskać listę metryk, zobacz Lista zebranych metryk.

Użytkownicy nie mogą kontrolować zachowania (włączyć lub wyłączyć) dla kolekcji uwzględnionych standardowych metryk. Użytkownicy mogą jednak kontrolować kolekcję niektórych opcjonalnych metryk, które nie są częścią linku do listy. Aby umożliwić to środowisko, użytkownicy muszą utworzyć i zaktualizować zasób MetricsConfiguration dla klastra. Domyślnie tworzenie tego zasobu MetricsConfiguration nie zmienia kolekcji metryk. Użytkownik musi zaktualizować zasób, aby włączyć lub wyłączyć tę opcjonalną kolekcję metryk.

Uwaga

  • W przypadku klastra można utworzyć maksymalnie jeden zasób MetricsConfiguration.
  • Użytkownicy muszą utworzyć zasób MetricsConfiguration, aby sprawdzić listę opcjonalnych metryk, które mogą być kontrolowane.
  • Usunięcie zasobu MetricsConfiguration powoduje przywrócenie standardowego zestawu metryk.

Jak zarządzać konfiguracją metryk klastra

Aby obsługiwać cykl życia konfiguracji metryk klastra, następujące interakcje umożliwiają tworzenie i zarządzanie konfiguracjami metryk klastra.

Tworzenie konfiguracji metryk

Użyj polecenia , aby utworzyć konfigurację az network cluster metricsconfiguration create metryk dla klastra. Jeśli masz wiele subskrypcji platformy Azure, użytkownik musi przekazać identyfikator subskrypcji przy użyciu flagi --subscription <SUBSCRIPTION_ID> do polecenia interfejsu wiersza polecenia lub wybrać odpowiedni identyfikator subskrypcji przy użyciu polecenia 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>"
  • Zastąp wartości w pliku <> określonymi informacjami.
  • Wykonaj zapytanie dotyczące zasobu klastra i znajdź wartość <CLUSTER-EXTENDED-LOCATION-ID> w elem. properties.clusterExtendedLocation
  • Pole collection-interval jest polem obowiązkowym i enabled-metrics jest polem opcjonalnym.

Alternatywnie operatory mogą udostępniać listę metryek z włączoną obsługą za pośrednictwem pliku json lub yaml.

Przykład: plik enabled-metrics.json

[
   "metric_1",
   "metric_2"
]

Przykład: plik enabled-metrics.yaml

- "metric_1"
- "metric_2"

Przykładowe polecenie umożliwiające używanie pliku json/yaml 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>"

<W tym miejscu plik path-to-yaml-or-json> może być plikiem ./enabled-metrics.json lub ./enabled-metrics.yaml (umieść plik w bieżącym katalogu roboczym) przed wykonaniem akcji.

Aby wyświetlić wszystkie dostępne parametry i ich opis, uruchom polecenie :

az networkcloud cluster metricsconfiguration create --help

Elementy konfiguracji metryk

Nazwa parametru opis
KLASTRA Nazwa zasobu klastra
LOCATION Region świadczenia usługi Azure, w którym wdrożono klaster
CLUSTER_EXTENDED_LOCATION_ID Lokalizacja rozszerzona klastra z witryny Azure Portal
COLLECTION_INTERVAL Częstotliwość zbierania domyślnych standardowych metryk
RESOURCE_GROUP Nazwa grupy zasobów klastra
TAG_KEY1 Opcjonalny tag1 do przekazania do elementu MetricsConfiguration create
TAG_VALUE1 Opcjonalna wartość tag1 do przekazania do elementu MetricsConfiguration create
TAG_KEY2 Opcjonalny tag2 do przekazania do elementu MetricsConfiguration create
TAG_VALUE2 Opcjonalna wartość tag2 do przekazania do elementu MetricsConfiguration create
METRIC_TO_ENABLE_1 Opcjonalna metryka "METRIC_TO_ENABLE_1" włączona oprócz domyślnych metryk
METRIC_TO_ENABLE_2 Opcjonalna metryka "METRIC_TO_ENABLE_2" jest włączona oprócz domyślnych metryk

Określanie --no-wait --debug opcji w az command powoduje wykonanie tego polecenia asynchronicznie. Aby uzyskać więcej informacji, zobacz jak śledzić operacje asynchroniczne.

Uwaga

  • Domyślny interwał zbierania metryk dla standardowego zestawu metryk jest ustawiany co 5 minut. collectionInterval Zmiana elementu będzie również mieć wpływ na częstotliwość zbierania domyślnych standardowych metryk.
  • Dla klastra można zdefiniować tylko jeden zestaw konfiguracji metryk. Zasób jest tworzony z nazwą default.

Wyświetlanie listy konfiguracji metryk

Zasób konfiguracji metryk dla określonego klastra można sprawdzić przy użyciu az networkcloud cluster metricsconfiguration list polecenia :

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

Pobieranie konfiguracji metryk

Po utworzeniu konfiguracji metryk operatory mogą sprawdzić szczegóły zasobu przy użyciu az networkcloud cluster metricsconfiguration show polecenia :

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

To polecenie zwraca reprezentację JSON konfiguracji metryk. Oprócz częstotliwości zbierania danych wyjściowych tego polecenia można obserwować listę metryk z włączonymi i wyłączonymi.

Aktualizowanie konfiguracji metryk

Podobnie jak w przypadku tworzenia konfiguracji metryk, operatorzy mogą wykonać akcję aktualizacji, aby zmienić konfigurację lub zaktualizować tagi przypisane do konfiguracji metryk.

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

Operatorzy mogą aktualizować collection-interval niezależnie od enabled-metrics listy. Pomiń pola, które nie są zmieniane.

Określanie --no-wait --debug opcji w az command powoduje wykonanie tego polecenia asynchronicznie. Aby uzyskać więcej informacji, zobacz jak śledzić operacje asynchroniczne.

Usuwanie konfiguracji metryk

Usunięcie konfiguracji metryk powoduje zwrócenie klastra do konfiguracji niezreaterowanej. Aby usunąć konfigurację metryk, użyj polecenia :

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

Określanie --no-wait --debug opcji w az command powoduje wykonanie tego polecenia asynchronicznie. Aby uzyskać więcej informacji, zobacz jak śledzić operacje asynchroniczne.