Das System Health Agent (SHA)-Framework bietet Überwachungen, die Host-Transportknoten-Statistiken abrufen und optional Statistiken für eine bestimmte Dauer in Dateien segmentieren können, die auf den ESXi-Host-Transportknoten gespeichert werden. Diese Funktion wird als Datei-Dump bezeichnet.

Diese Funktion wird derzeit nur mit NSX-APIs unterstützt. Sie richtet sich in erster Linie an fortgeschrittene NSX-Benutzer oder Techniker, die am historischen Trend der Statistiken auf einem Host-Transportknoten interessiert sind und tiefer in die Statistiken zum Debuggen von Datenpfadproblemen eintauchen möchten.

Die Dateiabbildfunktion verwendet die folgenden zwei Überwachungen, um Statistiken in Dateien abzurufen:

  • esx-obsrv-tn-stats-file-dump-monitor: Diese Überwachung speichert ESXi-Host-Transportknoten-Statistiken in Dateien.
  • esx-obsrv-segment-stats-file-dump-monitor: Diese Überwachung speichert Segmentstatistiken in Dateien.

    Es werden nur Statistiken von Overlay-Segmenten in Dateien gespeichert. Die Datei-Dump-Funktion wird derzeit nicht für VLAN-Segmente unterstützt.

Auf den ESXi-Host-Transportknoten werden die Dateien unter /var/run/log/nsx-obsrv-stats-filedump/ gespeichert.

Die Daten werden als Rohdaten in den Dateien gespeichert. Das System stellt derzeit keine Benutzeroberfläche bereit, um die Rohdaten in NSX Manager zu verbrauchen und zu analysieren.

Sie können die Dateien mit Rohdaten von den Hosts herunterladen und sie für VMware-Support zu Analysezwecken freigeben. Die Dateien mit Rohdaten sind an folgendem Speicherort auf den Host-Transportknoten verfügbar:

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

Die Dateien mit Rohdaten werden auch im NSX-Support-Paket gespeichert, wenn Sie eine Anforderung zur Erfassung von Support-Paketen erstellen.

Das folgende Verfahren erläutert den API-Workflow für die Verwendung der Datei-Dump-Funktion.

Prozedur

  1. Führen Sie die folgenden Schritte aus, um Host-Transportknoten-Statistiken in Dateien abzurufen.
    1. Führen Sie die folgende API aus, um die Konfiguration des Standardprofils von esx-obsrv-tn-stats-file-dump-monitor anzuzeigen: 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/profiles/default-profile
    2. Kopieren Sie die Antwort der GET-API aus dem vorigen Schritt und fügen Sie sie in einen Texteditor ein. Bearbeiten Sie die folgenden Eigenschaften im Standardprofil:
      • check_interval
      • enable
      • disable_after
      • file_dump_backup_count_dp_tn_stats

      Weitere Informationen zu diesen Konfigurationseigenschaften finden Sie in der Dokumentation der folgenden API im Handbuch zu NSX-API:

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

      Erweitern des ShaMonitorProfile-Schemas. Klicken Sie in der Spalte Typ auf ShaEsxObsrvTnStatsFileDumpMonitorConfig, um die Eigenschaftsbeschreibungen anzuzeigen.

    3. Fügen Sie die aktualisierte Profilkonfiguration in den Anforderungstext der folgenden API ein:
      PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/profiles/default-profile

      Wenn diese API erfolgreich ist, wird die Datei-Dump-Funktion für alle Host-Transportknoten im System aktiviert.

    4. Um zu überprüfen, ob das Profil von esx-obsrv-tn-stats-file-dump-monitor auf einen bestimmten Host-Transportknoten angewendet wurde, führen Sie die folgende API aus: 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/status?transport_node_id=<node-id>

      Die Ausgabe dieser API zeigt das Überwachungsprofil an, das auf dem Host-Transportknoten wirksam ist, und die detaillierte Konfiguration dieses Profils.

      Für diese API müssen Sie die node_id in der API-URI angeben. Um die node_id der Host-Transportknoten abzurufen, führen Sie die folgende API aus:

      GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes
  2. Führen Sie die folgenden Schritte aus, um Statistiken bestimmter Segmente in Dateien zu abzurufen.
    1. Legen Sie die Eigenschaft enable_esx_datapath_per_segment_stats im Profil der Überwachung esx-obsrv-stats-management auf „true“ fest.

      Diese Aktion aktiviert die Erfassung von Segmentstatistiken von den Host-Transportknoten im System.

      Weitere Informationen zum Aktivieren der Erfassung von Segmentstatistiken finden Sie im Abschnitt Voraussetzungen in Überwachen von NSX-Segmentstatistiken mithilfe von APIs.

    2. Bestimmen Sie den VNI der Overlay-Segmente, deren Statistiken Sie in Dateien erstellen möchten.

      Sie können eine dieser Methoden verwenden, um den VNI der Segmente zu ermitteln.

      Methode 1: Mithilfe der API

      Führen Sie die folgende API aus:

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

      Ersetzen Sie in dieser API-URI segment-id durch den Wert der Overlay-Segment-ID, deren VNI Sie ermitteln möchten.

      Methode 2: Mithilfe der NSX Manager-Benutzeroberfläche

      Navigieren Sie zu Netzwerk > Segmente > NSX. Erweitern Sie die Details des Overlay-Segments und dann den Abschnitt Zusätzliche Einstellungen.

      Notieren Sie den Wert neben dem Feld Overlay-ID (VNI).

    3. Führen Sie die folgende API aus, um die Konfiguration des Standardprofils von esx-obsrv-segment-stats-file-dump-monitor anzuzeigen: 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/profiles/default-profile
    4. Kopieren Sie die Antwort der GET-API aus dem vorigen Schritt und fügen Sie sie in einen Texteditor ein. Bearbeiten Sie die folgenden Eigenschaften im Standardprofil:
      • check_interval
      • enable
      • segment_list
      • disable_after
      • file_dump_backup_count_dp_segment_stats

      Weitere Informationen zu diesen Konfigurationseigenschaften finden Sie in der Dokumentation der folgenden API im Handbuch zu NSX-API:

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

      Erweitern des ShaMonitorProfile-Schemas. Klicken Sie in der Spalte Typ auf ShaEsxObsrvSegmentStatsFileDumpMonitorConfig, um die Beschreibungen der Eigenschaft anzuzeigen.

    5. Fügen Sie die aktualisierte Profilkonfiguration in den Anforderungstext der folgenden API ein: 
      PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/profiles/default-profile

      Wenn diese API erfolgreich ist, wird die Datei-Dump-Funktion für die angegebenen Segmente aktiviert. Die Segmentstatistiken werden in Dateien abgerufen, die auf den Host-Transportknoten gespeichert werden.

    6. Um zu überprüfen, ob das Profil von esx-obsrv-segment-stats-file-dump-monitor auf einen bestimmten Host-Transportknoten angewendet wurde, führen Sie die folgende API aus: 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/status?transport_node_id=<node-id>

      Die Ausgabe dieser API zeigt das Überwachungsprofil an, das auf dem Host-Transportknoten wirksam ist, und die detaillierte Konfiguration dieses Profils.

      Für diese API müssen Sie die node_id in der API-URI angeben. Um die node_id der Host-Transportknoten abzurufen, führen Sie die folgende API aus:

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

Nächste Maßnahme

In der Regel sind Segmentstatistiken nur für das Debuggen von Datenpfadproblemen erforderlich. Die Erfassung von Segmentstatistiken ist eine ressourcenintensive Aktivität. Denken Sie daher nach Abschluss des Debuggings daran, die Erfassung von Segmentstatistiken im Profil der Überwachung esx-obsrv-stats-management zu deaktivieren.