Puede utilizar la función Paquete de soporte de NSX para recopilar archivos de registro de nodos de clúster de contenedores de Antrea con fines detallados de diagnóstico y solución de problemas.

NSX puede cargar los paquetes de soporte en un nodo de NSX Manager desde donde activó la solicitud de recopilación de paquetes de soporte, o bien puede cargar los paquetes de soporte en un servidor de archivos remoto que especificó en la solicitud. Si los paquetes de soporte se cargan en un nodo de NSX Manager, puede descargarlos en el equipo local.

Un paquete de soporte para un clúster de contenedores de Antrea contiene archivos de registro para los siguientes componentes:
  • Controlador de Antrea
  • Agente de Antrea
  • Adaptador del plano de administración
  • Adaptador del plano de control central
  • Open vSwitch
Funciones compatibles y no compatibles
  • Desde un nodo de NSX Manager, puede iniciar una única solicitud de recopilación de paquetes de soporte. Sin embargo, puede recopilar paquetes de soporte para varios clústeres de contenedores de Antrea con una única solicitud de recopilación.
  • Si está utilizando un clúster de NSX Manager con tres nodos de administración, puede iniciar una solicitud de recopilación de paquetes de soporte independientes simultáneamente desde cada nodo de NSX Manager. Sin embargo, el clúster de contenedores que seleccione en cada solicitud de recopilación debe ser diferente.

    Por ejemplo, supongamos que ha iniciado una solicitud de recopilación de paquetes de soporte en el nodo A de NSX Manager. En esta solicitud de recopilación, seleccionó los nodos de clúster de contenedores 1 y 2 del clúster de contenedores X. Al mismo tiempo, si inicia una segunda solicitud de recopilación en el nodo B de NSX Manager para los nodos de clúster de contenedores 3 y 4 en el clúster de contenedores X, una de estas dos solicitudes fallará. Debe esperar a que se complete la primera solicitud de recopilación antes de activar la segunda solicitud para el mismo clúster de contenedores.

  • Actualmente no se admite la recopilación de paquetes de soporte desde NSX Manager Central CLI para clústeres de contenedores de Antrea.

Requisitos previos

Los clústeres de contenedores de Antrea se registran en NSX.

Procedimiento

  1. Desde su navegador, inicie sesión en NSX Manager en https://dirección-ip-de-nsx-manager.
  2. Desplácese hasta Sistema > Paquete de soporte.
    Se abrirá la página Solicitar paquete.
    Importante: La interfaz de usuario de NSX Manager recupera la información sobre los clústeres de contenedores de Antrea registrados cuando se inicia la aplicación de NSX Manager en el navegador. Si la interfaz de usuario de la aplicación ya está abierta, no recuperará la información de registro del clúster de contenedores de Antrea automáticamente. Este comportamiento es el esperado según el diseño de la interfaz de usuario actual. Si registró el primer clúster de contenedores de Antrea después de abrir la aplicación de NSX Manager, asegúrese de actualizar el navegador después de desplazarse hasta la página Solicitar paquete. Una actualización manual garantiza que puedan seleccionar clústeres de contenedores de Antrea como los nodos de destino en el siguiente paso de este procedimiento.

    Esta actualización manual del navegador solo es necesaria una vez, y no cada vez que se registra un nuevo clúster de contenedores de Antrea en NSX.

  3. Seleccione los nodos de destino que desea incluir en la solicitud del paquete de soporte.
    Los tipos de nodos disponibles son:
    • Clústeres de contenedores de Antrea
    • Nodos de NSX Manager
    • Instancias de Edge
    • Hosts
    • Puertas de enlace de nube pública

    Una única solicitud de paquete de soporte puede incluir una combinación de diferentes tipos de nodos en el entorno de NSX. Por ejemplo, puede seleccionar nodos de clústeres de contenedores de Antrea, nodos de NSX Manager y nodos de NSX Edge en la misma solicitud de recopilación. Sin embargo, el ámbito de este procedimiento es explicar el flujo de trabajo de creación de una solicitud de recopilación de paquetes de soporte solo para clústeres de contenedores Antrea.

  4. En el menú desplegable Tipo, seleccione Clústeres de contenedores de Antrea.
  5. En la lista Clúster de contenedores, seleccione el nombre de un clúster de contenedores.
    Si la lista incluye varios clústeres de contenedores entre los que puede seleccionar, introduzca los primeros caracteres del nombre del clúster. El sistema filtra la lista y muestra solo los nombres de clústeres de contenedores que coinciden con los caracteres introducidos.
    Se mostrarán todos los nodos del clúster de contenedores seleccionado en la lista Disponible.
  6. Seleccione uno o varios nodos del clúster de contenedores y haga clic en la flecha derecha para moverlos a la lista Seleccionado.
    Para seleccionar nodos de varios clústeres de contenedores de Antrea en una sola solicitud de recopilación, repita los pasos 4 y 5 para cada clúster de contenedores.
  7. (opcional) En el cuadro de texto Antigüedad del registro (días), mantenga el valor predeterminado o introduzca el número específico de días de los registros que desea que incluya el paquete de soporte. Especifique la antigüedad del registro como un número de días.
  8. (opcional) Para cargar el paquete de soporte en un servidor de archivos remoto, especifique la configuración del servidor de archivos.
    1. Introduzca una dirección IP o el nombre de host del servidor de archivos remoto.
    2. Introduzca el protocolo de transferencia de archivos y el número de puerto. El número de puerto predeterminado es 22.
    3. Introduzca el nombre de usuario y la contraseña para acceder al servidor de archivos remoto.
    4. Introduzca la ruta de la carpeta de destino en la que se cargará el archivo del paquete de soporte.
    Cuando no se especifica la configuración del servidor de archivos remoto, el paquete de soporte se carga en el nodo de NSX Manager desde el que activó la solicitud de recopilación del paquete de soporte.
  9. Haga clic en Iniciar recopilación de paquetes.
    Los detalles del tiempo de ejecución de la solicitud de recopilación se muestran en la página Estado. El proceso de recopilación tarda unos minutos. El tiempo necesario para crear el paquete de soporte depende de la cantidad de archivos de registro que se recopilarán de cada nodo del clúster de contenedores.
  10. Una vez finalizado el proceso de recopilación, haga clic en Descargar.
    El archivo de paquete de soporte se guardará en su equipo local. Si especificó la configuración del servidor de archivos remoto, el botón Descargar no aparecerá en la interfaz de usuario.

Resultados

Una solicitud de recopilación de paquetes de soporte genera un único archivo de cinta (TAR) con la siguiente convención de nomenclatura de archivos: nsx_support_archive_datestamp_timestamp.tar

La solicitud de recopilación del paquete de soporte técnico puede fallar en las siguientes situaciones:
  • Si el Adaptador de NSX Antrea falla en un clúster de contenedores cuando la solicitud del paquete de soporte está en curso, se producirá un error en la recopilación de registros para ese clúster de contenedores.
  • Si el dispositivo de NSX Manager falla o no se puede acceder a él cuando la solicitud del paquete de soporte está en curso, fallará la recopilación de registros. Hasta que se resuelva el problema de conectividad con NSX Manager, puede utilizar la herramienta de línea de comandos nativa de Antrea (antctl) para recopilar archivos de registro de los clústeres de contenedores de Antrea.
Escenario parcialmente correcto
Supongamos que seleccionó 10 nodos de un solo clúster de contenedores de Antrea para la recopilación de paquetes de soporte. Durante el proceso de recopilación, los archivos de registro se recopilaron correctamente de cinco nodos en el clúster de contenedores, pero no se recopilaron para los cinco nodos restantes. En otras palabras, la solicitud de recopilación se realizó solo parcialmente. En esta situación, el estado de la solicitud de recopilación es Correcto, y el archivo de paquete de soporte (TAR) contiene registros de los cinco nodos correctos.

Qué hacer a continuación

  1. Extraiga el archivo TAR. Se mostrarán los siguientes archivos:
    Nombre de archivo Descripción
    manifest.json

    Este archivo contiene un resumen de los resultados de la solicitud de recopilación y las propiedades de la solicitud de recopilación.

    Por ejemplo, contiene información sobre:
    • Los nodos para los que la recopilación se realizó correctamente.
    • Los nodos para los que se produjo un error en la recopilación.
    • Los identificadores de clúster y los identificadores de nodo que se utilizaron en la solicitud de recopilación.
    nsx_antrea_cluster-id.tgz

    Se crea un único archivo .tgz para cada clúster de contenedores de Antrea del paquete de soporte.

  2. Extraiga el archivo nsx_antrea_cluster-id.tgz file. Se mostrarán los siguientes archivos:
    Nombre de archivo Descripción
    adapters.tar.gz

    Este archivo contiene los archivos de registro del Adaptador del plano de administración y del Adaptador del plano de control central.

    agent_node_name.tar.gz

    Este archivo contiene los archivos de registro del Agente de Antrea y Open vSwitch. Se genera un archivo para cada nodo de clúster de contenedores en la solicitud de recopilación.

    Al extraer este archivo, puede ver los siguientes archivos:
    • Archivo agentinfo
    • Registros del agente en /logs/agent
    • Registros de Open vSwitch en /logs/ovs
    • Volcado de OpenFlow
    • IPtables
    • Volcado de enrutamiento
    clusterinfo

    Este archivo se genera para cada clúster de contenedores en la solicitud de paquete de soporte. El archivo contiene información sobre los diversos recursos de Kubernetes que se recopilan del servidor de API de Kubernetes, como pods, nodos, implementaciones, ReplicaSets, DaemonSets, etc.

    controller.tar.gz

    Este archivo contiene los archivos de registro del Controlador de Antrea.

    Al extraer este archivo, puede ver los siguientes archivos:
    • Archivo controllerinfo
    • Registros del controlador en /logs/controller