Cette documentation explique les concepts de base d'un moniteur SHA, qui est un composant introduit dans l'infrastructure SHA (System Health Agent) de NSX 4.2.

SHA est l'agent de santé du système distribué dans NSX. Cette infrastructure surveille les statistiques (mesures) de divers composants NSX, tels que les hôtes ESXi, les serveurs bare metal, les dispositifs Edge NSX, le dispositif NSX Manager, etc. SHA surveille les statistiques des composants, les analyse, alerte les anomalies et déclenche des actions de correction lorsque des conditions spécifiques sont remplies.

Avant NSX 4.2, pour contrôler la collecte des statistiques de composants (mesures), les utilisateurs NSX devaient suivre un processus en deux étapes. Tout d'abord, ils devaient déterminer le mappage entre les statistiques et les plug-ins SHA. En d'autres termes, ils devaient déterminer quel plug-in SHA contrôle quelles statistiques, puis utiliser les profils de plug-in SHA pour contrôler la collecte des statistiques. Les profils de plug-in SHA sont principalement destinés aux développeurs qui ont accès au code et peuvent déterminer quel profil de plug-in SHA doit être ajusté pour quelles statistiques.

Avec l'introduction du composant de moniteur dans l'infrastructure SHA, le processus est désormais simplifié.

Surveiller

Un moniteur est un composant de l'infrastructure SHA qui surveille diverses statistiques (mesures) sur la santé du système et prend les mesures correspondantes. Par exemple, il exporte les statistiques vers une destination pour que les utilisateurs puissent afficher la santé du système, déclenche des alarmes pour notifier les utilisateurs et vide les statistiques dans un fichier pour une analyse hors ligne. Un moniteur remplace les plug-ins SHA qui ont été introduits dans une version antérieure de NSX. Un moniteur fournit des descriptions détaillées des statistiques afin que les utilisateurs connaissent l'objectif de chaque statistique et comment contrôler le moniteur si nécessaire.

Par exemple, le esx-obsrv-stats-monitor contient des descriptions de toutes les statistiques d'observabilité collectées à partir d'un nœud de transport hôte ESXi.

Actuellement, un moniteur prend en charge l'exportation de statistiques vers une destination unique, qui est NSX Manager.

Profil de moniteur

Un profil de moniteur vous permet de contrôler le moniteur en configurant un ensemble de propriétés.

Par exemple, certaines propriétés de configuration dans le profil de moniteur sont les suivantes :

  • enable
  • check_interval
  • applied_to_group_paths

Seules quelques propriétés de configuration sont répertoriées ici. Pour en savoir plus sur toutes les propriétés de configuration d'un profil de moniteur, reportez-vous au schéma du profil de moniteur SHA dans le Guide de NSX API à l'adresse :

GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/<monitor-id>/profiles/<profile-id>

Vous pouvez accéder au moniteur et aux profils de surveillance uniquement avec des API NSX. Actuellement, ces composants ne sont pas exposés dans l'interface utilisateur NSX Manager.

Pour obtenir la liste de tous les ID de moniteur, utilisez l'API suivante :

GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors

Pour obtenir la liste de tous les profils pour un moniteur spécifique, utilisez l'API suivante :

GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/<monitor-id>/profiles
Note : Dans un déploiement de NSX à locataires multiples, les utilisateurs des projets et NSX VPC ne peuvent pas utiliser les API de profil de surveillance et de surveillance. Ces API sont actuellement disponibles pour la consommation uniquement pour les utilisateurs dans l'espace par défaut.

Chaque moniteur dispose d'un profil par défaut créé par le système. Par exemple, le profil par défaut du esx-obsrv-stats-monitor est appliqué à tous les nœuds de transport hôtes dans le système sur lequel ce moniteur s'exécute. Lorsque vous mettez à jour la configuration du profil par défaut, la modification affecte tous les nœuds. Vous ne pouvez pas supprimer le profil par défaut.

Vous pouvez créer un profil défini par l'utilisateur (personnalisé) pour remplacer le profil par défaut d'un groupe spécifique de nœuds de transport hôtes. Si plusieurs profils sont appliqués au moniteur sur un nœud de transport hôte, le dernier profil appliqué remplacera les autres profils. Le profil par défaut a la priorité la plus faible.

Que vous configuriez le profil par défaut ou un profil personnalisé du moniteur, certaines propriétés du profil ne peuvent pas être modifiées.

Par exemple :
  • Le profil par défaut du esx-obsrv-stats-monitor est appliqué au groupe par défaut créé par le système, qui contient tous les nœuds de transport hôtes dans le système. Vous ne pouvez pas modifier la propriété applied_to_group_paths du profil par défaut.
  • Vous ne pouvez pas désactiver esx-obsrv-alarms-monitor en définissant la propriété enable dans le profil sur false. Ce moniteur signale les alarmes dans le système et est toujours activé.

Types de moniteurs

L'infrastructure SHA contient deux principaux types de moniteurs.

Moniteurs exportateurs de mesures

Ces moniteurs sont utilisés pour exporter des mesures (statistiques) vers une destination, telle que NSX Manager. Par exemple, esx-obsrv-stats-monitor.

Pour un moniteur d'exportateur de mesures, le système ne prend en charge qu'un seul profil défini par l'utilisateur (personnalisé).

Moniteurs standard

Ces moniteurs sont utilisés pour effectuer d'autres tâches, sauf l'exportation de mesures, telles que la génération de rapports d'alarmes à NSX Manager, le dumping des statistiques dans un fichier, etc. Par exemple, esx-obsrv-alarms-monitor, esx-obsrv-segment-stats-file-dump-monitor.

Pour un moniteur standard, il n'existe aucune restriction sur le nombre de profils définis par l'utilisateur (personnalisés) que vous pouvez créer.

Un moniteur définit une catégorie de statistiques de haut niveau (mesures) qu'il contrôle. Les statistiques d'un moniteur sont organisées en plusieurs sous-catégories. Un sous-moniteur est défini pour contrôler des sous-catégories individuelles. Par défaut, la configuration définie pour le moniteur parent est appliquée à tous les sous-moniteurs du moniteur parent. Si nécessaire, vous pouvez modifier la configuration des sous-moniteurs.

Par exemple :

Le esx-obsrv-stats-monitor est un type d'exportateur de mesures de moniteur. Il contient deux sous-moniteurs de type exportateur de mesures, appelés esx-obsrv-datapath-traffic-stats-monitor et esx-obsrv-datapath-infra-stats-monitor.

L'avantage de catégoriser les statistiques dans un moniteur avec plusieurs sous-moniteurs est que vous pouvez contrôler tous les sous-moniteurs avec le moniteur parent. Vous n'avez pas besoin d'exécuter des appels d'API distincts pour les sous-moniteurs individuels afin de configurer leurs propriétés.