Il framework SHA (System Health Agent) fornisce monitoraggi che possono eseguire il dump delle statistiche del nodo di trasporto host e, facoltativamente, segmentare le statistiche relative a un determinato periodo di tempo in file che vengono salvati nei nodi di trasporto host ESXi. Questa funzionalità è denominata dump del file.

Questa funzionalità è attualmente supportata solo con NSX API. È principalmente destinata agli utenti esperti di NSX o agli ingegneri che sono interessati allo studio delle tendenze cronologiche delle statistiche in un nodo di trasporto host e ad approfondire le statistiche per il debug dei problemi del percorso dati.

La funzionalità di dump del file utilizza i due monitoraggi seguenti per eseguire il dump delle statistiche nei file:

  • esx-obsrv-tn-stats-file-dump-monitor: questo monitoraggio esegue il dump delle statistiche del nodo di trasporto host ESXi nei file.
  • esx-obsrv-segment-stats-file-dump-monitor: questo monitoraggio esegue il dump delle statistiche dei segmenti nei file.

    Il dump delle statistiche nei file viene eseguito solo per i segmenti di overlay. La funzionalità di dump del file non è attualmente supportata per i segmenti della VLAN.

Nei nodi di trasporto host ESXi, i file vengono salvati in /var/run/log/nsx-obsrv-stats-filedump/

I dati il cui dump viene eseguito nei file sono in formato raw. Al momento, il sistema non fornisce un'interfaccia utente per utilizzare e analizzare i dati raw in NSX Manager.

È possibile scaricare i file raw dagli host e condividerli con il supporto di VMware a scopo di analisi. I file raw sono disponibili nella posizione seguente nei nodi di trasporto host:

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

I file raw vengono salvati anche nel bundle di supporto di NSX quando si crea una richiesta di raccolta di bundle di supporto.

La procedura seguente illustra il workflow dell'API per l'utilizzo della funzionalità di dump del file.

Procedura

  1. Per eseguire il dump delle statistiche del nodo di trasporto host nei file, eseguire i passaggi seguenti.
    1. Eseguire l'API seguente per visualizzare la configurazione del profilo predefinito di 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. Copiare la risposta dell'API GET del passaggio precedente e incollarla in un editor di testo. Modificare le proprietà seguenti nel profilo predefinito:
      • check_interval
      • enable
      • disable_after
      • file_dump_backup_count_dp_tn_stats

      Per ulteriori informazioni su queste proprietà di configurazione, consultare la documentazione dell'API seguente nella Guida di NSX API:

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

      Espandere lo schema ShaMonitorProfile. Nella colonna Tipo fare clic su ShaEsxObsrvTnStatsFileDumpMonitorConfig per visualizzare le descrizioni delle proprietà.

    3. Incollare la configurazione del profilo aggiornato nel corpo della richiesta dell'API seguente:
      PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/profiles/default-profile

      Quando l'API viene eseguita correttamente, la funzionalità di dump del file viene attivata per tutti i nodi di trasporto host nel sistema.

    4. Per verificare se il profilo di esx-obsrv-tn-stats-file-dump-monitor è stato applicato a un nodo di trasporto host specifico, eseguire l'API seguente: 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/status?transport_node_id=<node-id>

      L'output di questa API visualizza il profilo di monitoraggio effettivo nel nodo di trasporto host e la configurazione dettagliata di tale profilo.

      Questa API richiede di specificare node_id nell'URI dell'API. Per ottenere il valore di node_id dei nodi di trasporto host, eseguire l'API seguente:

      GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes
  2. Per eseguire il dump delle statistiche di segmenti specifici nei file, eseguire i passaggi seguenti.
    1. Impostare la proprietà enable_esx_datapath_per_segment_stats nel profilo del monitoraggio esx-obsrv-stats-management su true.

      Questa azione attiva la raccolta di statistiche dei segmenti dai nodi di trasporto host nel sistema.

      Per ulteriori informazioni sull'attivazione della raccolta di statistiche dei segmenti, vedere la sezione Prerequisiti in Monitoraggio delle statistiche del segmento di NSX tramite le API.

    2. Determinare la VNI dei segmenti di overlay di cui si desidera eseguire il dump delle statistiche nei file.

      È possibile utilizzare uno qualsiasi di questi metodi per determinare la VNI dei segmenti.

      Metodo 1: Utilizzo dell'API

      Eseguire l'API seguente:

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

      Nell'URI dell'API sostituire segment-id con il valore dell'ID del segmento di overlay di cui si desidera determinare la VNI.

      Metodo 2: Utilizzo dell'interfaccia utente di NSX Manager

      Passare a Rete > Segmenti > NSX. Espandere i dettagli del segmento di overlay, quindi espandere la sezione Impostazioni aggiuntive.

      Prendere nota del valore accanto al campo ID overlay (VNI).

    3. Eseguire l'API seguente per visualizzare la configurazione del profilo predefinito di 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. Copiare la risposta dell'API GET del passaggio precedente e incollarla in un editor di testo. Modificare le proprietà seguenti nel profilo predefinito:
      • check_interval
      • enable
      • segment_list
      • disable_after
      • file_dump_backup_count_dp_segment_stats

      Per ulteriori informazioni su queste proprietà di configurazione, consultare la documentazione dell'API seguente nella Guida di NSX API:

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

      Espandere lo schema ShaMonitorProfile. Nella colonna Tipo fare clic su ShaEsxObsrvSegmentStatsFileDumpMonitorConfig per visualizzare le descrizioni delle proprietà.

    5. Incollare la configurazione del profilo aggiornato nel corpo della richiesta dell'API seguente: 
      PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/profiles/default-profile

      Quando l'API viene eseguita correttamente, la funzionalità di dump del file viene attivata per i segmenti specificati. Viene eseguito il dump delle statistiche dei segmenti in file che vengono salvati nei nodi di trasporto host.

    6. Per verificare se il profilo di esx-obsrv-segment-stats-file-dump-monitor è stato applicato a un nodo di trasporto host specifico, eseguire l'API seguente: 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/status?transport_node_id=<node-id>

      L'output di questa API visualizza il profilo di monitoraggio effettivo nel nodo di trasporto host e la configurazione dettagliata di tale profilo.

      Questa API richiede di specificare node_id nell'URI dell'API. Per ottenere il valore di node_id dei nodi di trasporto host, eseguire l'API seguente:

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

Operazioni successive

In genere, le statistiche dei segmenti sono necessarie solo per il debug dei problemi del percorso dei dati. La raccolta di statistiche dei segmenti è un'attività che utilizza molte risorse. Pertanto, una volta completato il debug, ricordarsi di disattivare la raccolta delle statistiche dei segmenti nel profilo del monitoraggio esx-obsrv-stats-management.