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/에 저장됩니다.

파일에 덤프되는 데이터는 원시 형식입니다. 시스템에는 현재 NSX Manager에서 원시 데이터를 사용하고 분석하기 위한 UI가 제공되지 않습니다.

호스트에서 원시 파일을 다운로드하고 분석 목적으로 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. esx-obsrv-stats-management 모니터의 프로파일에 있는 enable_esx_datapath_per_segment_stats 속성을 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를 확인하려는 오버레이 세그먼트 ID의 값으로 바꿉니다.

      방법 2: NSX Manager UI 사용

      네트워킹 > 세그먼트 > NSX로 이동합니다. 오버레이 세그먼트의 세부 정보를 확장한 다음, 추가 설정 섹션을 확장합니다.

      오버레이 ID(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 모니터의 프로파일에서 세그먼트 통계 수집을 비활성화해야 합니다.