Recopilar paquetes de soporte para un clúster de Antrea Kubernetes

Puede utilizar la función Paquete de soporte de NSX para recopilar archivos de registro de nodos de clúster de Antrea Kubernetes 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.

Nota: En esta documentación se utiliza el término "clúster de Antrea Kubernetes" para hacer referencia a clústeres de Kubernetes con Antrea CNI. El término "clúster de Kubernetes" es un término genérico que representa los clústeres de Tanzu Kubernetes Grid (TKG) con Antrea CNI, los clústeres de OpenShift con Antrea CNI o los clústeres de Kubernetes DIY con Antrea CNI.

La interfaz de usuario utiliza el término "clúster de contenedores de Antrea" para algunos campos o etiquetas. En la sección Procedimiento de esta documentación, el término "clúster de contenedores de Antrea" se conserva para esos campos o etiquetas de la interfaz de usuario. Para todo el texto libre, se utiliza el término "clúster de Antrea Kubernetes".

Un paquete de soporte para un clúster de Antrea Kubernetes 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 Antrea Kubernetes 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 Antrea Kubernetes que seleccione en cada solicitud de recopilación debe ser diferente.

  Por ejemplo, supongamos que inició 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 1 y 2 del clúster de Antrea Kubernetes 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 3 y 4 en el clúster de Antrea Kubernetes 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 Antrea Kubernetes.

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

Requisitos previos

Los clústeres de Antrea Kubernetes 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 Antrea Kubernetes 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 Antrea Kubernetes 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 Antrea Kubernetes 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 Antrea Kubernetes 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 Antrea Kubernetes en NSX.

3. Seleccione los nodos de destino que desea incluir en la solicitud del paquete de soporte.
   Los tipos de nodos disponibles son:

   • Antrea clústeres de contenedores
   • Nodos de administración
   • 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 Antrea Kubernetes, 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 Antrea Kubernetes.

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.
   Si la lista incluye varios clústeres 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úster que coinciden con los caracteres introducidos.
   Se mostrarán todos los nodos del clúster seleccionado en la lista Disponible.
6. Seleccione uno o varios nodos del clúster y haga clic en la flecha derecha para moverlos a la lista Seleccionado.
   Para seleccionar nodos de varios clústeres en una sola solicitud de recopilación, repita los pasos 4 y 5 para cada clúster.
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 Kubernetes 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 Kubernetes.
• 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 Antrea Kubernetes.

Escenario parcialmente correcto

Supongamos que seleccionó 10 nodos de un solo clúster de Antrea Kubernetes 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 Antrea Kubernetes, 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 Antrea Kubernetes 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 Antrea Kubernetes 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 Antrea Kubernetes en la solicitud de paquete de soporte. El archivo contiene información sobre los siguientes recursos de Kubernetes que se recopilan desde el servidor de API de Kubernetes: Pods Nodos Implementaciones ReplicaSets DaemonSets
   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