Konfigurace metrik clusteru

  • Článek

Když uživatel nasadí cluster, povolí se pro kolekci standardní sada metrik. Seznam metrik najdete v části Seznam shromažďovaných metrik.

Uživatelé nemůžou řídit chování (povolit nebo zakázat) pro shromažďování těchto standardních metrik. Uživatelé ale můžou řídit kolekci některých volitelných metrik, které nejsou součástí odkazu na seznam. Aby bylo možné toto prostředí povolit, musí uživatelé vytvořit a aktualizovat prostředek MetricsConfiguration pro cluster. Ve výchozím nastavení se při vytváření tohoto prostředku MetricsConfiguration nezmění kolekce metrik. Uživatel musí aktualizovat prostředek, aby mohl povolit nebo zakázat tuto volitelnou kolekci metrik.

Poznámka:

  • V případě clusteru je možné vytvořit maximálně jeden prostředek MetricsConfiguration.
  • Uživatelé musí vytvořit prostředek MetricsConfiguration, aby zkontrolovali seznam volitelných metrik, které je možné řídit.
  • Odstranění prostředku MetricsConfiguration způsobí obnovení standardní sady metrik.

Správa konfigurace metrik clusteru

Pro podporu životního cyklu konfigurací metrik clusteru umožňují následující interakce vytváření a správu konfigurací metrik clusteru.

Vytvoření konfigurace metrik

az network cluster metricsconfiguration create Pomocí příkazu vytvořte konfiguraci metrik pro cluster. Pokud máte více předplatných Azure, musí uživatel předat ID předplatného buď pomocí příznaku --subscription <SUBSCRIPTION_ID> příkazu rozhraní příkazového řádku, nebo pomocí příkazu az account set vybrat příslušné ID předplatného.

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>"
  • Hodnoty nahraďte < > konkrétními informacemi.
  • Zadejte dotaz na prostředek clusteru a najděte hodnotu <CLUSTER-EXTENDED-LOCATION-ID> v properties.clusterExtendedLocation
  • Pole collection-interval je povinné pole a enabled-metrics je volitelné pole.

Případně můžou operátory poskytnout seznam povolených metrik prostřednictvím souboru JSON nebo yaml.

Příklad: enabled-metrics.json soubor

[
   "metric_1",
   "metric_2"
]

Příklad: soubor enabled-metrics.yaml

- "metric_1"
- "metric_2"

Příklad příkazu pro použití souboru JSON/yaml s povolenými metrikami:

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

<Tady může být soubor path-to-yaml-or-json-file> ./enabled-metrics.json nebo ./enabled-metrics.yaml (před provedením akce umístěte soubor do aktuálního pracovního adresáře).

Spuštěním příkazu zobrazíte všechny dostupné parametry a jejich popis:

az networkcloud cluster metricsconfiguration create --help

Elementy konfigurace metrik

Název parametru Popis
SHLUK Název prostředku clusteru
UMÍSTĚNÍ Oblast Azure, ve které je cluster nasazený
CLUSTER_EXTENDED_LOCATION_ID Rozšířené umístění clusteru z webu Azure Portal
COLLECTION_INTERVAL Frekvence shromažďování výchozích standardních metrik
RESOURCE_GROUP Název skupiny prostředků clusteru
TAG_KEY1 Volitelná značka 1 pro předání do vytvoření MetricsConfiguration
TAG_VALUE1 Volitelná hodnota značky1 pro předání do vytvoření MetricsConfiguration
TAG_KEY2 Volitelná značka 2 pro předání do vytvoření MetricsConfiguration
TAG_VALUE2 Volitelná hodnota značky2 pro předání do vytvoření MetricsConfiguration
METRIC_TO_ENABLE_1 Volitelná metrika "METRIC_TO_ENABLE_1" povolená kromě výchozích metrik
METRIC_TO_ENABLE_2 Volitelná metrika "METRIC_TO_ENABLE_2" povolená kromě výchozích metrik

Zadání --no-wait --debug možností v příkazu az vede k asynchronnímu spuštění tohoto příkazu. Další informace najdete v tématu sledování asynchronních operací.

Poznámka:

  • Výchozí interval shromažďování metrik pro standardní sadu metrik je nastavený na každých 5 minut. collectionInterval Změna bude mít vliv také na frekvenci shromažďování výchozích standardních metrik.
  • Pro každý cluster může být definována pouze jedna sada konfigurací metrik. Prostředek se vytvoří s názvem default.

Výpis konfigurace metrik

Prostředek konfigurace metrik pro konkrétní cluster můžete zkontrolovat pomocí az networkcloud cluster metricsconfiguration list příkazu:

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

Načtení konfigurace metrik

Po vytvoření konfigurace metrik můžou operátoři pomocí příkazu zkontrolovat podrobnosti o prostředku az networkcloud cluster metricsconfiguration show :

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

Tento příkaz vrátí reprezentaci JSON konfigurace metrik. Kromě frekvence shromažďování můžete sledovat seznam povolených a zakázaných metrik jako výstup pro tento příkaz.

Aktualizace konfigurace metrik

Podobně jako při vytváření konfigurace metrik můžou operátoři provést akci aktualizace, která změní konfiguraci nebo aktualizuje značky přiřazené ke konfiguraci metrik.

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

Operátory mohou aktualizovat collection-interval nezávisle na enabled-metrics seznamu. Vynechání polí, která se nemění

Zadání --no-wait --debug možností v příkazu az vede k asynchronnímu spuštění tohoto příkazu. Další informace najdete v tématu sledování asynchronních operací.

Odstranění konfigurace metrik

Odstranění konfigurace metrik vrátí cluster do nealterované konfigurace. Pokud chcete odstranit konfiguraci metrik, použijte příkaz:

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

Zadání --no-wait --debug možností v příkazu az vede k asynchronnímu spuštění tohoto příkazu. Další informace najdete v tématu sledování asynchronních operací.