Configuration des métriques de cluster

  • Article

Lorsque l’utilisateur déploie un cluster, un ensemble standard de métriques est activé pour la collecte. Pour obtenir la liste des métriques, consultez Liste des métriques collectées.

Les utilisateurs ne peuvent pas contrôler le comportement (activer ou désactiver) pour la collecte de ces métriques standard incluses. Toutefois, les utilisateurs peuvent contrôler la collection de certaines métriques facultatives qui ne font pas partie du lien vers la liste. Pour activer cette expérience, les utilisateurs doivent créer et mettre à jour une ressource MetricsConfiguration pour un cluster. Par défaut, la création de cette ressource MetricsConfiguration ne modifie pas la collection de métriques. L’utilisateur doit mettre à jour la ressource pour activer ou désactiver ces collectes de métriques facultatives.

Remarque

  • Pour un cluster, au maximum, une seule ressource MetricsConfiguration peut être créée.
  • Les utilisateurs doivent créer une ressource MetricsConfiguration pour case activée une liste de métriques facultatives qui peuvent être contrôlées.
  • La suppression de la ressource MetricsConfiguration entraîne la restauration de l’ensemble standard de métriques.

Comment gérer la configuration des métriques de cluster

Pour prendre en charge le cycle de vie des configurations de métriques de cluster, les interactions suivantes permettent la création et la gestion des configurations de métriques d’un cluster.

Création d’une configuration de métriques

Utilisez la commande pour créer la az network cluster metricsconfiguration create configuration des métriques pour le cluster. Si vous avez plusieurs abonnements Azure, l’utilisateur doit passer l’ID d’abonnement à l’aide d’un indicateur --subscription <SUBSCRIPTION_ID> à la commande CLI ou sélectionner l’ID d’abonnement approprié à l’aide de la commande 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>"
  • Remplacez les valeurs par <> vos informations spécifiques.
  • Interrogez la ressource de cluster et recherchez la valeur dans <CLUSTER-EXTENDED-LOCATION-ID> le properties.clusterExtendedLocation
  • Le collection-interval champ est un champ obligatoire et enabled-metrics est un champ facultatif.

Vous pouvez également fournir la liste des métriques activées via un fichier json ou yaml.

Exemple : fichier enabled-metrics.json

[
   "metric_1",
   "metric_2"
]

Exemple : fichier enabled-metrics.yaml

- "metric_1"
- "metric_2"

Exemple de commande pour utiliser le fichier 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>"

Ici, <path-to-yaml-or-json-file> peut être ./enabled-metrics.json ou ./enabled-metrics.yaml (placez le fichier dans le répertoire de travail actuel) avant d’effectuer l’action.

Pour afficher tous les paramètres disponibles et leur description, exécutez la commande :

az networkcloud cluster metricsconfiguration create --help

Éléments de configuration des métriques

Nom du paramètre Description
CLUSTER Nom de la ressource du cluster
LOCATION Région Azure où le cluster est déployé
CLUSTER_EXTENDED_LOCATION_ID Emplacement étendu du cluster à partir de Portail Azure
COLLECTION_INTERVAL Fréquence de collecte pour les métriques standard par défaut
RESOURCE_GROUP Nom du groupe de ressources de cluster
TAG_KEY1 Balise1 facultative à passer à MetricsConfiguration create
TAG_VALUE1 Valeur tag1 facultative à passer à MetricsConfiguration create
TAG_KEY2 Balise2 facultative à passer à MetricsConfiguration create
TAG_VALUE2 Valeur tag2 facultative à passer à MetricsConfiguration create
METRIC_TO_ENABLE_1 Métrique facultative « METRIC_TO_ENABLE_1 » activée en plus des métriques par défaut
METRIC_TO_ENABLE_2 Métrique facultative « METRIC_TO_ENABLE_2 » activée en plus des métriques par défaut

La spécification d’options --no-wait --debug dans az command entraîne l’exécution de cette commande de façon asynchrone. Pour plus d’informations, consultez comment suivre les opérations asynchrones.

Remarque

  • L’intervalle de collecte des métriques par défaut pour l’ensemble standard de métriques est défini sur toutes les 5 minutes. La modification du collectionInterval paramètre a également un impact sur la fréquence de collecte pour les métriques standard par défaut.
  • Il ne peut y avoir qu’un seul ensemble de configuration de métriques défini par cluster. La ressource est créée avec le nom default.

Répertorier la configuration des métriques

Vous pouvez case activée la ressource de configuration des métriques pour un cluster spécifique à l’aide az networkcloud cluster metricsconfiguration list de la commande :

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

Récupération d’une configuration de métriques

Une fois qu’une configuration de métriques est créée, les opérateurs peuvent case activée les détails de la ressource à l’aide az networkcloud cluster metricsconfiguration show de la commande :

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

Cette commande retourne une représentation JSON de la configuration des métriques. Vous pouvez observer la liste des métriques activées et désactivées en plus de la fréquence de collecte en tant que sortie pour cette commande.

Mise à jour d’une configuration de métriques

Tout comme la création d’une configuration de métriques, les opérateurs peuvent effectuer une action de mise à jour pour modifier la configuration ou mettre à jour les balises affectées à la configuration des métriques.

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

Les opérateurs peuvent mettre à jour collection-interval indépendamment de la enabled-metrics liste. Omettez les champs qui ne sont pas modifiés.

La spécification d’options --no-wait --debug dans az command entraîne l’exécution de cette commande de façon asynchrone. Pour plus d’informations, consultez comment suivre les opérations asynchrones.

Suppression d’une configuration de métriques

La suppression de la configuration des métriques retourne le cluster à une configuration non inchangée. Pour supprimer une configuration de métriques, utilisez la commande :

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

La spécification d’options --no-wait --debug dans az command entraîne l’exécution de cette commande de façon asynchrone. Pour plus d’informations, consultez comment suivre les opérations asynchrones.