Configurazione delle metriche del cluster

  • Articolo

Quando l'utente distribuisce un cluster, viene abilitato un set standard di metriche per la raccolta. Per l'elenco delle metriche, vedere Elenco delle metriche raccolte.

Gli utenti non possono controllare il comportamento (abilitare o disabilitare) per la raccolta di queste metriche standard incluse. Tuttavia, gli utenti possono controllare la raccolta di alcune metriche facoltative che non fanno parte del collegamento all'elenco. Per abilitare questa esperienza, gli utenti devono creare e aggiornare una risorsa MetricsConfiguration per un cluster. Per impostazione predefinita, la creazione di questa risorsa MetricsConfiguration non modifica la raccolta di metriche. L'utente deve aggiornare la risorsa per abilitare o disabilitare la raccolta di metriche facoltative.

Nota

  • Per un cluster, al massimo, è possibile creare una sola risorsa MetricsConfiguration.
  • Gli utenti devono creare una risorsa MetricsConfiguration per controllare un elenco di metriche facoltative che possono essere controllate.
  • L'eliminazione della risorsa MetricsConfiguration comporta il ripristino del set standard di metriche.

Come gestire la configurazione delle metriche del cluster

Per supportare il ciclo di vita delle configurazioni delle metriche del cluster, le interazioni seguenti consentono la creazione e la gestione delle configurazioni delle metriche di un cluster.

Creazione di una configurazione delle metriche

Usare il az network cluster metricsconfiguration create comando per creare la configurazione delle metriche per il cluster. Se si dispone di più sottoscrizioni di Azure, l'utente deve passare l'ID sottoscrizione usando un flag --subscription <SUBSCRIPTION_ID> al comando dell'interfaccia della riga di comando o selezionare l'ID sottoscrizione appropriato usando il comando 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>"
  • Sostituire i valori all'interno <> con le informazioni specifiche.
  • Eseguire una query sulla risorsa cluster e trovare il valore di <CLUSTER-EXTENDED-LOCATION-ID> in properties.clusterExtendedLocation
  • Il collection-interval campo è un campo obbligatorio ed enabled-metrics è un campo facoltativo.

In alternativa, gli operatori possono fornire l'elenco delle metriche abilitate tramite file json o yaml.

Esempio: file enabled-metrics.json

[
   "metric_1",
   "metric_2"
]

Esempio: file enabled-metrics.yaml

- "metric_1"
- "metric_2"

Comando di esempio per usare il file 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>"

In questo caso, <path-to-yaml-or-json-file> può essere ./enabled-metrics.json o ./enabled-metrics.yaml (posizionare il file nella directory di lavoro corrente) prima di eseguire l'azione.

Per visualizzare tutti i parametri disponibili e la relativa descrizione, eseguire il comando :

az networkcloud cluster metricsconfiguration create --help

Elementi di configurazione delle metriche

Nome parametro Descrizione
GRAPPOLO Nome risorsa del cluster
UBICAZIONE Area di Azure in cui viene distribuito il cluster
CLUSTER_EXTENDED_LOCATION_ID Percorso esteso del cluster da portale di Azure
COLLECTION_INTERVAL Frequenza di raccolta per le metriche standard predefinite
RESOURCE_GROUP Nome del gruppo di risorse cluster
TAG_KEY1 Tag1 facoltativo da passare a MetricsConfiguration create
TAG_VALUE1 Valore tag1 facoltativo da passare a MetricsConfiguration create
TAG_KEY2 Tag2 facoltativo da passare a MetricsConfiguration create
TAG_VALUE2 Valore tag2 facoltativo da passare a MetricsConfiguration create
METRIC_TO_ENABLE_1 Metrica facoltativa "METRIC_TO_ENABLE_1" abilitata oltre alle metriche predefinite
METRIC_TO_ENABLE_2 Metrica facoltativa "METRIC_TO_ENABLE_2" abilitata oltre alle metriche predefinite

--no-wait --debug Se si specificano le opzioni in az command, l'esecuzione di questo comando viene eseguita in modo asincrono. Per altre informazioni, vedere Come tenere traccia delle operazioni asincrone.

Nota

  • L'intervallo di raccolta delle metriche predefinito per il set standard di metriche è impostato su ogni 5 minuti. La modifica di collectionInterval influirà anche sulla frequenza di raccolta per le metriche standard predefinite.
  • È possibile definire un solo set di configurazioni delle metriche per ogni cluster. La risorsa viene creata con il nome default.

Elencare la configurazione delle metriche

È possibile controllare la risorsa di configurazione delle metriche per un cluster specifico usando il az networkcloud cluster metricsconfiguration list comando :

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

Recupero di una configurazione delle metriche

Dopo aver creato una configurazione delle metriche, gli operatori possono controllare i dettagli della risorsa usando az networkcloud cluster metricsconfiguration show il comando :

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

Questo comando restituisce una rappresentazione JSON della configurazione delle metriche. È possibile osservare l'elenco delle metriche abilitate e disabilitate oltre alla frequenza di raccolta come output per questo comando.

Aggiornamento di una configurazione delle metriche

Analogamente alla creazione di una configurazione delle metriche, gli operatori possono eseguire un'azione di aggiornamento per modificare la configurazione o aggiornare i tag assegnati alla configurazione delle metriche.

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

Gli operatori possono aggiornare collection-interval indipendentemente dall'elenco enabled-metrics . Omettere i campi che non vengono modificati.

--no-wait --debug Se si specificano le opzioni in az command, l'esecuzione di questo comando viene eseguita in modo asincrono. Per altre informazioni, vedere Come tenere traccia delle operazioni asincrone.

Eliminazione di una configurazione delle metriche

L'eliminazione della configurazione delle metriche restituisce il cluster a una configurazione non modificata. Per eliminare una configurazione delle metriche, usare il comando :

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

--no-wait --debug Se si specificano le opzioni in az command, l'esecuzione di questo comando viene eseguita in modo asincrono. Per altre informazioni, vedere Come tenere traccia delle operazioni asincrone.