系統健全狀況代理程式 (SHA) 架構提供的監視器可以傾印主機傳輸節點統計資料，並可以選擇將指定持續時間內的區段統計資料傾印到檔案，這些檔案儲存在 ESXi 主機傳輸節點上。此功能稱為檔案傾印。

目前僅 NSX API 支援此功能。它主要針對進階的 NSX 使用者或工程師，這些使用者或工程師有興趣研究主機傳輸節點上統計資料的歷史趨勢，並深入探討統計資料以進行資料路徑問題的偵錯。

檔案傾印功能使用以下兩個監視器將統計資料傾印到檔案：

  • esx-obsrv-tn-stats-file-dump-monitor：此監視器將 ESXi 主機傳輸節點統計資料傾印到檔案。
  • esx-obsrv-segment-stats-file-dump-monitor：此監視器將區段統計資料傾印到檔案。

    系統只會將覆疊區段的統計資料傾印到檔案。VLAN 區段目前不支援檔案傾印功能。

在 ESXi 主機傳輸節點上，這些檔案儲存在 /var/run/log/nsx-obsrv-stats-filedump/ 中

傾印到檔案的資料採用原始格式。系統目前不提供 UI 來取用及分析 NSX Manager 中的原始資料。

您可以從主機下載原始檔案，並與 VMware 支援團隊共用，以進行分析。這些原始檔案可在主機傳輸節點的以下位置找到：

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

建立支援服務包收集要求時，還會將原始檔儲存在 NSX 支援服務包中。

以下程序介紹了使用檔案傾印功能的 API 工作流程。

程序

  1. 若要將主機傳輸節點統計資料傾印到檔案，請執行以下步驟。
    1. 執行以下 API 以檢視 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. 複製上一個步驟的 GET API 回應，並將其貼到文字編輯器中。編輯預設設定檔中的以下內容：
      • check_interval
      • enable
      • disable_after
      • file_dump_backup_count_dp_tn_stats

      若要進一步瞭解有關這些組態內容，請移至NSX API 指南中的以下 API 說明文件：

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

      展開 ShaMonitorProfile 架構。在類型資料行中，按一下 ShaEsxObsrvTnStatsFileDumpMonitorConfig 以檢視內容說明。

    3. 將更新的設定檔組態貼到以下 API 的要求本文中：
      PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/profiles/default-profile

      此 API 成功後，將為系統中的所有主機傳輸節點啟用檔案傾印功能。

    4. 若要驗證 esx-obsrv-tn-stats-file-dump-monitor 的設定檔是否已在特定主機傳輸節點上生效，請執行以下 API： 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/status?transport_node_id=<node-id>

      此 API 的輸出顯示在主機傳輸節點上有效的監視器設定檔，以及該設定檔的詳細組態。

      此 API 要求您在 API URI 中指定 node_id。若要取得主機傳輸節點的 node_id，請執行以下 API：

      GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes
  2. 若要將特定區段的統計資料傾印到檔案，請執行以下步驟。
    1. 將 enable_esx_datapath_per_segment_stats 監視器設定檔中的 esx-obsrv-stats-management 內容設定為 true。

      此動作將啟用從系統中的主機傳輸節點收集區段統計資料的功能。

      若要進一步瞭解啟用區段統計資料收集，請參閱使用 API 監控 NSX 區段統計資料中的〈必要條件〉一節。

    2. 確定要將其統計資料傾印到檔案的覆疊區段的 VNI。

      您可以使用其中任一方法來確定區段的 VNI。

      方法 1：使用 API

      執行以下 API：

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

      在此 API URI 中，將 segment-id 取代為要確定其 VNI 的覆疊區段識別碼值。

      方法 2：使用 NSX Manager UI

      導覽至網路 > 區段 > NSX。展開覆疊區段的詳細資料，然後展開其他設定區段。

      記下覆疊識別碼 (VNI) 欄位旁邊的值。

    3. 執行以下 API 以檢視 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. 複製上一個步驟的 GET API 回應，並將其貼到文字編輯器中。編輯預設設定檔中的以下內容：
      • check_interval
      • enable
      • segment_list
      • disable_after
      • file_dump_backup_count_dp_segment_stats

      若要進一步瞭解有關這些組態內容，請移至NSX API 指南中的以下 API 說明文件：

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

      展開 ShaMonitorProfile 架構。在類型資料行中，按一下 ShaEsxObsrvSegmentStatsFileDumpMonitorConfig 以檢視內容說明。

    5. 將更新的設定檔組態貼到以下 API 的要求本文中： 
      PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/profiles/default-profile

      此 API 執行成功後，將為指定的區段啟用檔案傾印功能。區段統計資料將傾印到在主機傳輸節點上儲存的檔案。

    6. 若要驗證 esx-obsrv-segment-stats-file-dump-monitor 的設定檔是否已在特定主機傳輸節點上生效，請執行以下 API： 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/status?transport_node_id=<node-id>

      此 API 的輸出顯示在主機傳輸節點上有效的監視器設定檔，以及該設定檔的詳細組態。

      此 API 要求您在 API URI 中指定 node_id。若要取得主機傳輸節點的 node_id，請執行以下 API：

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

下一步

通常，只有在偵錯資料路徑問題時，才需要區段統計資料。收集區段統計資料是一項資源密集型活動。因此，在偵錯完成後，請記得在 esx-obsrv-stats-management 監視器的設定檔中停用區段統計資料收集。