Recopile la guía de resultados de ACI Tech Supports y TAC Requested

Introducción

Este documento describe los diversos registros y salidas que se requieren para la resolución de problemas cuando se trabaja con TAC para ACI.

Antecedentes

Para obtener una referencia rápida sobre qué datos recopilar antes de abrir un caso TAC, consulte la Tabla 1.

Tabla 1: Registros/demostración de la matriz de recopilación de tecnología:

Problemas	Qué recopilar	Notas
Problemas de actualización	Soporte técnico a pedido de los nodos con problemas de actualización. Soporte técnico a pedido de todos los APIC. Fallos, eventos y auditorías adicionales mediante TacOutput.	Si los APIC se desvían y la recopilación de asistencia técnica a demanda falla, recopile la asistencia técnica local.
Problema de conectividad aleatoria	Soporte técnico a demanda desde el nodo src (donde está conectado el terminal src). Asistencia técnica a demanda desde el nodo dst (donde está conectado el extremo dstendpoint). Fallos, eventos y auditorías adicionales mediante TacOutput.
Pérdida de conectividad total	Asistencia técnica a demanda desde hojas (src y dst). Soporte técnico principal a pedido. Soporte técnico a pedido del APIC Fallos, eventos y auditorías adicionales mediante TacOutput.	Para interrupciones continuas, active el TAC para la depuración en vivo. Si los nodos deben reiniciarse por algún motivo, recopile los registros antes de volver a cargarlos si se solicita el RCA.
Problemas del clúster	Soporte técnico a pedido de todos los APIC Fallos, eventos y auditorías adicionales mediante TacOutput.	Si los APIC se desvían y la recopilación de asistencia técnica a demanda falla, recopile la asistencia técnica local.
Problema de routing	Soporte técnico a pedido de nodos con problemas de routing. Fallos, eventos y auditorías adicionales mediante TacOutput.
Recarga inesperada/bloqueo del nodo	Soporte técnico a pedido de nodos bloqueados. Archivos de memoria/desperfecto de nodo(s) desperfecto(s). Fallos, eventos y auditorías adicionales mediante TacOutput.
Problemas de la aplicación del APIC	Soporte técnico a pedido de todos los APIC. Soporte técnico de la aplicación del APIC para la aplicación afectada.

Switch y APIC de ACI

Soporte técnico a pedido

Activación y carga de la información a través de APIC: aplicación de conector de nube de Nexus Insights

Para utilizar este método, consulte El fabric ACI debe estar conectado y reclamado en Intersight a través del APIC: Aplicación Nexus Insights Cloud Connector.

1. Navegue hasta: APIC > Aplicaciones > Aplicaciones instaladas > Abra la aplicación NICC > Asistencia del TAC > Haga clic en Iniciar
2. Seleccione los nodos y, a continuación, haga clic en Recopilar registros.
3. Una vez que el estado del trabajo sea COMPLETO, haga clic en Ver detalles.
4. En la página Detalles del trabajo, en la tabla Registros, en Archivo, busque la Columna de nube. 
5. Haga clic en Cargar para cada paquete TechSupport de dispositivos.

Activación y carga de datos para la interacción mediante ND - Información del panel de Nexus

Para utilizar este método, consulte El fabric ACI debe estar conectado y reclamado en Intersight a través del panel de Nexus: Perspectivas del panel de Nexus.

1. Navegue hasta: Panel de Nexus > Consola de administración > Servicios > Abrir Nexus Dashboard Insights > Solucionar problemas > Recopilador de registros.
2. Haga clic en New Log Collection.
   1. Agregue un nombre a la colección de registros.
   2. Seleccione un sitio. 
   3. Active la casilla de verificación Carga automática de archivos de registro.
   4. Haga clic en Seleccionar nodos y elija los nodos.
   5. Haga clic en Iniciar recopilación.
   6. Los archivos de TechSupport se cargan en intersight.com  
3. Una vez completada la carga, notifique al TAC que los archivos se cargan en Intersight. 
4. El ingeniero del TAC puede trasladar los archivos de Intersight al caso del TAC para su análisis. 

Activación a través de la IU del APIC

Creación de una política de soporte técnico a pedido

Nota: No especifique un intervalo de tiempo de soporte técnico a menos que el TAC se lo pida explícitamente. Si se produce una pérdida excesiva de registros, esto puede dar lugar a una pérdida de registros. Esto afecta gravemente a la capacidad del TAC para proporcionar una RCA a tiempo. Si se proporciona un rango de tiempo de TechSupport, recorta los registros basándose en la última marca de tiempo de modificación de archivos y NO basándose en las marcas de tiempo dentro del propio archivo de registro.

1. En la barra de menús, haga clic en Admin > Importar/Exportar > Exportar directivas >Haga clic con el botón secundario en Asistencia técnica bajo demanda > Crear asistencia técnica bajo demanda.
2. Introduzca los valores correspondientes en los campos del cuadro de diálogo Crear soporte técnico a pedido.
   • Si no hay una ubicación remota disponible, marque Exportar al controlador. Los TechSupports generados se descargan a través de la pestaña Operativo de la GUI una vez que se han generado.
   • Marque Incluir todos los controladores en el soporte técnico para generar los soportes técnicos del APIC.
   • El campo Nodos de origen permite especificar los nodos de switch que generan un soporte técnico.
3. Haga clic en Enviar para crear la política de soporte técnico a pedido.

Genere una asistencia técnica a demanda.

1. Navegue hasta una política de soporte técnico a pedido existente. Las políticas creadas se pueden encontrar en: Admin > Import/Export > Export Policies > On-Demand TechSupport > Expand On-Demand TechSupport Folder > Haga clic con el botón derecho en la política que se va a utilizar > Collect Tech Supports.
   
   • O haga clic con el botón izquierdo del ratón en On-Demand TechSupport Policy para que aparezca en el panel Principal; haga clic en el icono de llave inglesa/martillo y elija Recopilar soporte técnico.
2. Elija Sí para comenzar a recopilar información de soporte técnico.

Recopile la asistencia técnica generada.

1. Si la exportación al controlador no estaba habilitada durante la generación de TechSupport, se puede comprobar el destino de exportación (ubicación remota) para todos los archivos de TechSupport.
2. Si Exportar al controlador estaba habilitado, navegue hasta la política de soporte técnico a pedido con la que se generó el soporte técnico. Las políticas creadas se pueden encontrar en Admin > Import/Export > Export Policies > On-Demand TechSupport.
   • Los TechSupport generados se pueden encontrar en la pestaña Operativo de la Política de soporte técnico bajo demanda. Cada archivo tiene un enlace para descargar vía http/https. Cada nodo tiene tres enlaces, uno de ellos vinculado a cada archivo.

Nota: Si la versión es anterior a la 2.2, debe utilizar la cuenta de usuario del administrador local para descargar TechSupports a través de la interfaz de usuario. De lo contrario, utilice cualquier otra cuenta local que tenga privilegios de administrador. Los usuarios remotos no pueden descargar TechSupports a través de la interfaz de usuario. En su lugar, pueden utilizar sftp u otro método para extraer los archivos de TechSupport del directorio /data/techsupport/ en los APIC correspondientes.

Nota:  El número de la URL del paquete TechSupport indica en qué APIC reside el archivo. Por ejemplo, files/2/techsupport.tgz indica que este paquete específico se encuentra en el directorio /data/techsupport/ de APIC 2.

Archivos de soporte técnico a pedido explicados

Si los archivos de TechSupports se generaron con la opción Exportar a controlador, la GUI muestra tres direcciones URL por nodo ACI (nodo APIC o nodo de switch). Cada URL es un tipo de archivo de registro diferente y contiene información única. El TAC requiere normalmente que se carguen los tres archivos por nodo para recibir todos los registros para un análisis completo.

Cada URL se asigna a uno de los tres tipos de archivo:

Categoría	Sufijo típico	Útil para:	Tamaño del archivo
Exportación	_1of3.tgz	Registros de falla/auditoría	Pequeño-Mediano
Registros	_logs_3of3.tgz	Registros de procesos	Grande
DB	_db_2of3.tgz	Volcado de MO	Pequeño

Nota:  Si se ha seleccionado un destino de exportación en lugar de Exportar al controlador, la ubicación remota definida crea una carpeta que contiene los tres archivos por nodo.

Si se produce un problema al descargar soporte técnico mediante el enlace del navegador, descargue directamente los archivos del almacenamiento APIC mediante un cliente scp o sftp como WinSCP o FileZilla.

1. Conecte (sftp) a cada APIC. Los archivos de soporte técnico recopilados se almacenan en todos los APIC disponibles, por lo que es importante comprobar cada APIC en busca de los archivos de soporte técnico recopilados.

2. Navegue hasta la carpeta /data/techsupport en el APIC conectado (repita este paso en todos los controladores APIC).

3. Busque los archivos con un nombre que contenga el nombre de la directiva de soporte técnico bajo demanda (en este ejemplo, es ABCTECH) y descargue esos archivos en el equipo.

Soporte técnico local

Siempre se prefiere la asistencia técnica a demanda a la asistencia técnica local, ya que la asistencia técnica a demanda proporciona una imagen más completa. Sin embargo, depende de un clúster del APIC totalmente ajustado, ya que la recopilación se activa mediante una política.

Escenarios locales de TechSupport:

• El APIC no está completamente adaptado.
• El APIC aún no ha descubierto el switch ACI.
• El switch ACI ha perdido la comunicación con el APIC.
• El proceso interno no funciona correctamente, lo que impide que el servicio de asistencia técnica bajo demanda funcione por completo (poco frecuente).

Activación a través de la CLI del APIC

1. Abra una sesión SSH con el APIC con credenciales de administrador.
   • Si no puede utilizar las credenciales de administrador para iniciar sesión, utilice el nombre de usuario rescue-user. La contraseña puede ser la misma que la del usuario local administrador.
2. Ejecute el comando bash -c "techsupport local".

   Using username "admin".
   Application Policy Infrastructure Controller
   
   apic1# bash -c "techsupport local"
   This command is being deprecated on APIC controller, please use NXOS-style equivalent command
   Running bash commands
   Completed 1 of 10 commands
   ...
   Completed 10 of 10 commands
   Starting data compression
   Techsupport collected at /data/techsupport/local_apic1_2018-05-29T08-17.tgz . Please remove the file once done.
   

3. Descargue el soporte técnico local.
   
   • Opción A: Descargue el archivo de soporte técnico mediante el SCP:
     • WinSCP o pscp.exe (usuarios de Windows).
     • Cliente SCP nativo (usuarios de MAC).
   • Opción B: Descargue el archivo de soporte técnico mediante HTTPS:
     1. Abra un navegador, como Chrome o Firefox.
     2. Navegue hasta: https://<aci.apic.ip.addr>/files/<apic#>/techsupport/<ts_filename>
        • Ejemplo: https://a.p.i.c/files/1/techsupport/local_apic1_2018-05-29T08-17.tgz
     3. Inicie sesión con credenciales de administrador.
     4. Si se le solicita, seleccione Guardar archivo en la petición de descarga del navegador.

Activación a través de la CLI del switch

1. Abra una sesión SSH con el switch ACI con credenciales de administrador.
   • Si el APIC aún no ha descubierto el switch, utilice el nombre de usuario admin.
2. Ejecute el comando: "techsupport local".

fab5-leaf1# techsupport local
Running bash commands
Completed 1 of 9 commands
...
Completed 9 of 9 commands
Starting data compression
Techsupport collected at /data/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz . Please remove the file once done

3. Descargue el soporte técnico local.

• Opción A: Descargue el archivo techsupport del switch de ACI con el SCP:
  • WinSCP o pscp.exe (usuarios de Windows).
  • Cliente SCP nativo (usuarios de MAC).
• Opción B: Descargue el archivo de soporte técnico mediante HTTPS a través del APIC:
  
  1. Inicie sesión en una CLI de APIC (observe qué APIC se utiliza para el paso 4).
  2. Transfiera el archivo techsupport del switch ACI al APIC mediante este comando:
     • scp <node-name>:/data/techsupport/<ts_filename> /data/techsupport
     • Ejemplo: apic1# scp fab5-leaf1:/data/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz /data/techsupport
  3. Abra un navegador, como Chrome o Firefox.
  4. Navegue hasta: https://<aci.apic.ip.addr>/files/<apic#>/techsupport/<ts_filename>
     • Ejemplo: https://a.p.i.c/files/1/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz
  5. Inicie sesión con credenciales de administrador.
  6. Si se le solicita, seleccione Guardar archivo en la petición de descarga del navegador.

Soporte técnico de CIMC

Activación a través de la interfaz de usuario de CIMC

Se puede recopilar un soporte técnico de APIC CIMC para revisar los registros relacionados con el chasis de APIC. Un comando show tech de CIMC puede capturarse localmente o enviarse a una ubicación remota desde la sección Utilidades de la pestaña CIMC Admin. 

Desencadenar mediante CLI de CIMC

En la CLI del APIC de CIMC, introduzca:

~ # scope cimc
~ /cimc # scope tech-support
~ /cimc/tech-support # set tftp-ip 192.168.1.1
~ /cimc/tech-support *# set path \techsupport\showtech
~ /cimc/tech-support *# commit
~ /cimc/tech-support *# start 

Análisis de CIMC TechSupports

Consulte algunos de los campos clave de los comandos show tech:

Archivo/ubicación de TechSupport	Descripción
var/	Contiene registros detallados y un estado de todos los servicios supervisados. Cuenta con archivos de información de servicio como las configuraciones de SOL y alarmas de sensor IPMI.
var/log	Contiene los mensajes de registro volátil rotatorios.
obfl/	Contiene los mensajes de registro no volátiles rotatorios.
met/	Configuraciones no volátiles y SEL.
mp/	El comando show tech-support text files, junto con los archivos de texto de soporte técnico de BIOS. Los archivos de texto contienen toda la información de proceso, red, sistema, Mezzanine y estado de BIOS.
mctool	Obtenga información básica sobre el estado del CIMC.
Red	Reciba información sobre la configuración de red y el socket actual.
obfl	Obtenga un obfl activo (registros de fallos a bordo).
mensajes	Reciba el archivo /var/log/messages en directo.
alarmas	Enumera los sensores con estados de alarma.
sensores	Lecturas del sensor de corriente de IPMI.
energía	Estado de energía actual de x86.

Auditorías extendidas, eventos, fallas y más (TacOutput)

El TAC puede solicitar salidas básicas adicionales, como fallos, eventos y auditorías, que generalmente se requieren para el RCA.

A partir de hoy, el show techs ya incluye un subconjunto de estos objetos, sin embargo, solo los últimos 10.000 registros. En algunos casos, el TAC requiere un conjunto completo de registros, que supera los 10 000 registros.

Nota: A partir de la versión 5.2(1g), puede utilizar el comando CLI para activar la salida del APIC para recopilar estos objetos adicionales. Sin embargo, en las versiones anteriores a 5.3(x) y 6.0(3d), la secuencia de comandos integrada puede no recopilar todas las páginas de registros. En este caso, se recomienda utilizar la versión más actualizada del script dentro del repositorio aci-tac-scripts descrito en la siguiente sección.

Trigger vía Trigger TACOutput - 5.2/5.3/6.0(3d) y Versiones Posteriores

En el caso de los fabric de ACI que ejecutan la versión 5.2/5.3/6.0(3d) y versiones posteriores, la salida de tacoutput del disparador proporciona una interfaz de recopilación simplificada para eventos, fallos, auditorías y otras salidas de solución de problemas):

apic1# trigger tacoutput
Select corresponding numbers of objects to collect. Separate numbers with commas. *Note, topSystem, fabricNode, and firmwareARunning are automatically included.
Ex: 1,2,3,4,5
1. faultInfo *collected unfiltered
2. faultRecord
3. eventRecord
4. aaaModLR *collected unfiltered
5. polDeploymentRecord
6. epRecord
7. healthRecord
8. healthInst *collected unfiltered
Enter selections: 1,2,3,4,5,6,7,8
Enter record start date (format: 2019-12-15T00:00:00) *default is one month prior to current date: 
Enter record end date (format: 2019-12-15T00:00:00) *default is current date: 

... collection runs...

2021-12-17T08:19:59 TacOutput collection completed.
2021-12-17T08:19:59 Verify files and file sizes at /tmp/TacOutput2021-12-17T08-16-19
2021-12-17T08:19:59 Compressing files...
2021-12-17T08:20:01 Compression completed
Logs available for SCP or SFTP download from /data/techsupport/TacOutput-2021-11-17T08:18:06-to-2021-12-17T08:18:06.tgz
To download through your web browser go to https:///files/1/techsupport/TacOutput-2021-11-17T08:18:06-to-2021-12-17T08:18:06.tgz
Note: in the URL previous 1 denotes the APIC ID 1, if script was run on APIC-n, then n must be specified in the URL (n = APIC-ID).

To remove files when done run
rm -rf /tmp/TacOutput2021-12-17T08-16-19
rm -f /data/techsupport/TacOutput-2021-11-17T08:18:06-to-2021-12-17T08:18:06.tgz

Desencadenante a través de Recopilar script de salidas TACO

Para los Fabrics ACI que ejecutan versiones anteriores a 5.2/5.3/6.0(3d), existe una secuencia de comandos Collect TacOutput disponible en el repositorio aci-tac-scripts, que sirve a una interfaz similar al comando trigger tacoutput:

apic# /tmp/collectTacOutputs.sh
Select corresponding numbers of objects to collect. Separate numbers with commas. *Note, topSystem, fabricNode, and firmwareARunning are automatically included.
Ex: 1,2,3,4,5
1. faultInfo *collected unfiltered
2. faultRecord
3. eventRecord
4. aaaModLR
5. polDeploymentRecord
6. epRecord
7. healthRecord
8. healthInst *collected unfiltered
Enter selections: 1,2,3,4,5,6,7,8
Enter record start date (format: 2019-12-15T00:00:00) *default is one month prior to current date: 2019-12-25T00:00:00
Enter record end date (format: 2019-12-15T00:00:00) *default is current date: 2020-01-05T00:00:00

...script collection runs...

Compression completed
Logs available for SCP or SFTP download from /data/techsupport/TacOutput-2019-12-25T00:00:00-to-2020-01-05T00:00:00.tgz
To download through your web browser go to https:///files/1/techsupport/TacOutput-2019-12-25T00:00:00-to-2020-01-05T00:00:00.tgz

Archivos de núcleo/bloqueo

Recopilación mediante la interfaz de usuario del APIC

El nodo de switch de ACI y APIC cuentan con numerosos procesos que controlan diversos aspectos funcionales del sistema. Si el sistema presenta una falla de software en un proceso en particular, se genera un archivo de núcleo y se vuelve a cargar el proceso. Cuando un proceso falla y se genera un archivo de núcleo, se genera un fallo y un evento. Cuando el proceso en el switch/APIC falla, el archivo de núcleo se comprime y se copia en el APIC.

La GUI de APIC proporciona una ubicación central para recopilar los archivos de núcleo de los nodos de fabric. Se puede crear una nueva política de exportación desde Admin > IMPORT/EXPORT en Export Policies > Core.

Existe una política central predeterminada en la que los archivos se pueden descargar directamente. Todos los archivos de núcleo generados intentan una transferencia al controlador APIC cuando se generan. Si tienen éxito, se pueden encontrar bajo la política de núcleo predeterminada.

Registros de auditoría independientes

Recopilación mediante la interfaz de usuario de NDO/MSO

Los registros de auditoría de MSC se pueden descargar en formato JSON en formato CSV:

Historial de revisiones

Revisión	Fecha de publicación	Comentarios
9.0	08-Jun-2026	Ortografía, gramática, estructura de oraciones, texto alternativo editado y espaciado actualizados.
8.0	06-May-2024	PII, título, traducción automática, contenedores de notas y formato actualizados.
7.0	23-Apr-2024	Actualización de formato y enlaces a la guía del conector del dispositivo para APIC y ND
5.0	27-May-2022	Se actualizó la generación y carga de soporte técnico para Intersight mediante APIC/ND.
4.0	16-Mar-2022	Ruta agregada al script TacOutput en GIT.
3.0	22-Feb-2022	Actualización secundaria.
2.0	17-Dec-2021	Se ha añadido la CLI APIC "trigger tacoutput" al documento.
1.0	06-Sep-2021	Versión inicial