L'infrastructure SHA (System Health Agent) fournit des moniteurs qui peuvent vider les statistiques du nœud de transport hôte et éventuellement segmenter les statistiques sur une durée spécifiée dans des fichiers, qui sont enregistrés sur les nœuds de transport hôtes ESXi. Cette fonctionnalité est appelée vidage de fichiers.

Cette fonctionnalité est actuellement prise en charge uniquement avec les API NSX. Elle est principalement destinée aux utilisateurs NSX avancés ou aux ingénieurs qui souhaitent étudier la tendance historique des statistiques sur un nœud de transport hôte et approfondir les statistiques pour déboguer les problèmes de chemin de données.

La fonctionnalité de vidage de fichiers utilise les deux moniteurs suivants pour vider les statistiques dans les fichiers :

  • esx-obsrv-tn-stats-file-dump-monitor : ce moniteur vide les statistiques du nœud de transport hôte ESXi dans des fichiers.
  • esx-obsrv-segment-stats-file-dump-monitor : ce moniteur vide les statistiques de segment dans les fichiers.

    Les statistiques des segments de superposition uniquement sont vides dans les fichiers. La fonctionnalité de vidage de fichier n'est actuellement pas prise en charge pour les segments VLAN.

Sur les nœuds de transport hôtes ESXi, les fichiers sont enregistrés dans /var/run/log/nsx-obsrv-stats-filedump/

Les données qui sont vides dans les fichiers sont dans un format brut. Actuellement, le système ne fournit pas d'interface utilisateur pour consommer et analyser les données brutes dans NSX Manager.

Vous pouvez télécharger les fichiers bruts à partir des hôtes et les partager avec le support VMware à des fins d'analyse. Les fichiers bruts sont disponibles à l'emplacement suivant sur les nœuds de transport hôtes :

/var/run/log/nsx-obsrv-stats-filedump/

Les fichiers bruts sont également enregistrés dans le bundle de support NSX lorsque vous créez une demande de collecte de bundles de support.

La procédure suivante explique le workflow d'API pour l'utilisation de la fonctionnalité de vidage de fichiers.

Procédure

  1. Pour vider les statistiques du nœud de transport hôte dans des fichiers, procédez comme suit.
    1. Exécutez l'API suivante pour afficher la configuration du profil par défaut du esx-obsrv-tn-stats-file-dump-monitor : 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/profiles/default-profile
    2. Copiez la réponse de l'API GET et de l’étape précédente et collez-la dans un éditeur de texte. Modifiez les propriétés suivantes dans le profil par défaut :
      • check_interval
      • enable
      • disable_after
      • file_dump_backup_count_dp_tn_stats

      Pour en savoir plus sur ces propriétés de configuration, accédez à la documentation de l'API suivante dans le Guide de NSX API :

      /policy/api/v1/infra/sha/monitors/<monitor-id>/profiles/<monitor-profile-id>

      Développez le schéma ShaMonitorProfile. Dans la colonne Type, cliquez sur ShaEsxObsrvTnStatsFileDumpMonitorConfig pour afficher les descriptions des propriétés.

    3. Collez la configuration du profil mis à jour dans le corps de la demande de l'API PATCH suivante :
      PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/profiles/default-profile

      Lorsque cette API réussit, la fonctionnalité de vidage de fichiers est activée pour tous les nœuds de transport hôtes du système.

    4. Pour vérifier si le profil du esx-obsrv-tn-stats-file-dump-monitor a pris effet sur un nœud de transport hôte spécifique, exécutez l'API suivante : 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/status?transport_node_id=<node-id>

      La sortie de cette API affiche le profil de moniteur effectif sur le nœud de transport hôte et la configuration détaillée de ce profil.

      Cette API nécessite que vous spécifiiez le node_id dans l'URI de l'API. Pour obtenir les node_id des nœuds de transport hôtes, exécutez l'API suivante :

      GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes
  2. Pour vider les statistiques de segments spécifiques dans des fichiers, procédez comme suit.
    1. Définissez la propriété enable_esx_datapath_per_segment_stats dans le profil du moniteur esx-obsrv-stats-management sur true.

      Cette action active la collecte des statistiques de segment à partir des nœuds de transport hôtes dans le système.

      Pour en savoir plus sur l'activation de la collecte de statistiques de segments, reportez-vous à la section Conditions préalables dans Surveiller les statistiques de segments NSX à l'aide d'API.

    2. Déterminez le VNI des segments de superposition dont vous souhaitez vider les statistiques dans des fichiers.

      Vous pouvez utiliser l'une de ces méthodes pour déterminer le VNI des segments.

      Méthode 1 : utilisation de l'API

      Exécutez l'API suivante :

      GET https://<nsx-mgr>/policy/api/v1/infra/realized-state/realized-entities?intent_path=/infra/segments/<segment-id>

      Dans cet URI d'API, remplacez segment-id par la valeur de l'ID de segment de superposition dont vous souhaitez déterminer le VNI.

      Méthode 2 : utilisation de l'interface utilisateur NSX Manager

      Accédez à Mise en réseau > Segments > NSX. Développez les détails du segment de superposition, puis développez la section Options supplémentaires.

      Notez la valeur en regard du champ ID de superposition (VNI).

    3. Exécutez l'API suivante pour afficher la configuration du profil par défaut du esx-obsrv-segment-stats-file-dump-monitor : 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/profiles/default-profile
    4. Copiez la réponse de l'API GET et de l’étape précédente et collez-la dans un éditeur de texte. Modifiez les propriétés suivantes dans le profil par défaut :
      • check_interval
      • enable
      • segment_list
      • disable_after
      • file_dump_backup_count_dp_segment_stats

      Pour en savoir plus sur ces propriétés de configuration, accédez à la documentation de l'API suivante dans le Guide de NSX API :

      /policy/api/v1/infra/sha/monitors/<monitor-id>/profiles/<monitor-profile-id>

      Développez le schéma ShaMonitorProfile. Dans la colonne Type, cliquez sur ShaEsxObsrvSegmentStatsFileDumpMonitorConfig pour afficher les descriptions des propriétés.

    5. Collez la configuration du profil mis à jour dans le corps de la demande de l'API PATCH suivante : 
      PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/profiles/default-profile

      Lorsque cette API réussit, la fonctionnalité de vidage de fichier est activée pour les segments spécifiés. Les statistiques de segment sont vides dans des fichiers qui sont enregistrés sur les nœuds de transport hôtes.

    6. Pour vérifier si le profil du esx-obsrv-segment-stats-file-dump-monitor a pris effet sur un nœud de transport hôte spécifique, exécutez l'API suivante : 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/status?transport_node_id=<node-id>

      La sortie de cette API affiche le profil de moniteur effectif sur le nœud de transport hôte et la configuration détaillée de ce profil.

      Cette API nécessite que vous spécifiiez le node_id dans l'URI de l'API. Pour obtenir les node_id des nœuds de transport hôtes, exécutez l'API suivante :

      GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes

Que faire ensuite

En général, les statistiques de segment sont requises uniquement pour le débogage des problèmes de chemin d'accès aux données. La collecte de statistiques de segments est une activité exigeante en ressources. Par conséquent, une fois le débogage terminé, n'oubliez pas de désactiver la collecte des statistiques de segment dans le profil du moniteur esx-obsrv-stats-management.