El marco del agente de estado del sistema (SHA) proporciona monitores que pueden volcar estadísticas de nodos de transporte del host y, opcionalmente, segmentar estadísticas durante un tiempo específico a archivos, que se guardan en los nodos de transporte del host ESXi. Esta función se denomina volcado de archivos.

Actualmente, esta función solo está disponible en las API de NSX. Está dirigida principalmente a usuarios o ingenieros avanzados de NSX interesados en estudiar la tendencia histórica de las estadísticas en un nodo de transporte del host y profundizar en las estadísticas para depurar problemas de ruta de datos.

La función de volcado de archivos utiliza los siguientes dos monitores para volcar estadísticas en archivos:

  • esx-obsrv-tn-stats-file-dump-monitor: este monitor vuelca estadísticas del nodo de transporte del host ESXi en archivos.
  • esx-obsrv-segment-stats-file-dump-monitor: este monitor vuelca estadísticas de segmentos en archivos.

    Las estadísticas de solo segmentos superpuestos se vuelcan en archivos. Actualmente, no se admite la función de volcado de archivos para segmentos de VLAN.

En los nodos de transporte del host ESXi, los archivos se guardan en /var/run/log/nsx-obsrv-stats-filedump/

Los datos que se vuelcan a los archivos se encuentran en formato sin procesar. Actualmente, el sistema no proporciona una interfaz de usuario para consumir y analizar los datos sin procesar en NSX Manager.

Puede descargar los archivos sin formato de los hosts y compartirlos con VMware Support con fines de análisis. Los archivos sin formato están disponibles en la siguiente ubicación en los nodos de transporte del host:

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

Los archivos sin formato también se guardan en el paquete de soporte de NSX al crear una solicitud de recopilación de paquetes de soporte.

El siguiente procedimiento explica el flujo de trabajo de API para usar la función de volcado de archivos.

Procedimiento

  1. Para volcar las estadísticas del nodo de transporte del host en archivos, siga estos pasos.
    1. Ejecute la siguiente API para ver la configuración del perfil predeterminado de 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. Copie la respuesta de la API GET del paso anterior y péguela en un editor de texto. Edite las siguientes propiedades en el perfil predeterminado:
      • check_interval
      • enable
      • disable_after
      • file_dump_backup_count_dp_tn_stats

      Para obtener más información sobre estas propiedades de configuración, vaya a la documentación de la siguiente API en la Guía de NSX API:

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

      Expanda el esquema ShaMonitorProfile. En la columna Tipo, haga clic en ShaEsxObsrvTnStatsFileDumpMonitorConfig para ver las descripciones de las propiedades.

    3. Pegue la configuración de perfil actualizada en el cuerpo de la solicitud de siguiente API:
      PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/profiles/default-profile

      Cuando esta API se ejecuta correctamente, la función de volcado de archivos se activa para todos los nodos de transporte del host en el sistema.

    4. Para comprobar si el perfil de esx-obsrv-tn-stats-file-dump-monitor tuvo efecto en un nodo de transporte del host específico, ejecute la siguiente API: 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-tn-stats-file-dump-monitor/status?transport_node_id=<node-id>

      Los resultados de esta API muestran el perfil de supervisión que es efectivo en el nodo de transporte del host y la configuración detallada de ese perfil.

      Esta API requiere que se especifiquen los node_id en el URI de la API. Para obtener el node_id de los nodos de transporte del host, ejecute la siguiente API:

      GET https://<nsx-mgr>/policy/api/v1/infra/sites/default/enforcement-points/default/host-transport-nodes
  2. Para volcar estadísticas de segmentos específicos en archivos, siga estos pasos.
    1. Establezca la propiedad enable_esx_datapath_per_segment_stats del perfil del monitor esx-obsrv-stats-management en true.

      Esta acción activará la recopilación de estadísticas de segmentos de los nodos de transporte del host en el sistema.

      Para obtener más información sobre cómo activar la recopilación de estadísticas de segmentos, consulte la sección Requisitos previos en Supervisar estadísticas de segmentos de NSX mediante API.

    2. Determine el VNI de los segmentos superpuestos cuyas estadísticas desea volcar a archivos.

      Puede utilizar cualquiera de estos métodos para determinar el VNI de los segmentos.

      Método 1: Con una API

      Ejecute la siguiente API:

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

      En este URI de API, reemplace segment-id con el valor del identificador de segmento superpuesto cuyo VNI desee determinar.

      Método 2: Con la UI de NSX Manager

      Desplácese hasta Redes > Segmentos > NSX. Expanda los detalles del segmento de superposición y, a continuación, expanda la sección Configuración.

      Anote el valor junto al campo Identificador de superposición (VNI).

    3. Ejecute la siguiente API para ver la configuración del perfil predeterminado de 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. Copie la respuesta de la API GET del paso anterior y péguela en un editor de texto. Edite las siguientes propiedades en el perfil predeterminado:
      • check_interval
      • enable
      • segment_list
      • disable_after
      • file_dump_backup_count_dp_segment_stats

      Para obtener más información sobre estas propiedades de configuración, vaya a la documentación de la siguiente API en la Guía de NSX API:

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

      Expanda el esquema ShaMonitorProfile. En la columna Tipo, haga clic en ShaEsxObsrvSegmentStatsFileDumpMonitorConfig para ver las descripciones de las propiedades.

    5. Pegue la configuración de perfil actualizada en el cuerpo de la solicitud de siguiente API: 
      PATCH https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/profiles/default-profile

      Cuando esta API se ejecuta correctamente, la función de volcado de archivos se activa para los segmentos especificados. Las estadísticas de segmentos se volcarán en los archivos que se guardan en los nodos de transporte del host.

    6. Para comprobar si el perfil de esx-obsrv-segment-stats-file-dump-monitor tuvo efecto en un nodo de transporte del host específico, ejecute la siguiente API: 
      GET https://<nsx-mgr>/policy/api/v1/infra/sha/monitors/esx-obsrv-segment-stats-file-dump-monitor/status?transport_node_id=<node-id>

      Los resultados de esta API muestran el perfil de supervisión que es efectivo en el nodo de transporte del host y la configuración detallada de ese perfil.

      Esta API requiere que se especifiquen los node_id en el URI de la API. Para obtener el node_id de los nodos de transporte del host, ejecute la siguiente API:

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

Qué hacer a continuación

Por lo general, las estadísticas de segmentos solo son necesarias para depurar problemas de ruta de datos. La recopilación de estadísticas de segmentos es una actividad que requiere muchos recursos. Por lo tanto, una vez completada la depuración, recuerde desactivar la recopilación de estadísticas de segmentos en el perfil del monitor esx-obsrv-stats-management.