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: Matriz Logs/Show tech collection

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. Fallas adicionales, eventos, auditorías a través de TacOutput.	Si los APIC se desvían y falla la recopilación de asistencia técnica a demanda, 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). Soporte técnico a demanda desde el nodo dst (donde está conectado el punto final dstend). Fallas adicionales, eventos, auditorías a través de TacOutput
Pérdida de conectividad total	Soporte técnico secundario a pedido (origen y destino) Soporte técnico principal a pedido Soporte técnico a pedido del APIC Fallas adicionales, eventos, auditorías a través de 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 Fallas adicionales, eventos, auditorías a través de TacOutput	Si los APIC se desvían y falla la recopilación de asistencia técnica a demanda, recopile la asistencia técnica local.
Problema de routing	Soporte técnico a pedido de nodos con problemas de routing. Fallas adicionales, eventos, auditorías a través de TacOutput
Recarga inesperada/bloqueo del nodo	Soporte técnico a pedido de nodos bloqueados. Archivos de memoria/desperfecto de nodo(s) desperfecto(s). Fallas adicionales, eventos, auditorías a través de 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 de ACI debe estar conectado y reclamado en Intersight a través de la aplicación APIC: conector de nube de Nexus Insights.

1. Vaya a: APIC > Aplicaciones > Aplicaciones instaladas > abrir aplicación NICC > Asistencia del TAC > haga clic en Comenzar
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, encontrará la Columna de Nube. 
5. Haga clic en Cargar para obtener el paquete de soporte técnico de cada dispositivo.

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 de ACI debe estar conectado y reclamado en Intersight a través de Nexus Dashboard: Nexus Dashboard Insights.

1. Vaya a: Nexus Dashboard > Admin Console > Services > Open Nexus Dashboard Insights > Troubleshoot > Log Collector.
2. Haga clic en New Log Collection.
   1. Dé un nombre a la recopilación de registros.
   2. Seleccione un sitio. 
   3. Active la casilla de verificación para la 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 que se complete la carga, notifique al TAC que los archivos se cargan en el intercambio. 
4. El ingeniero del TAC podría trasladar los archivos de la entrevista 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 rango de tiempo de soporte técnico a menos que se lo solicite explícitamente el TAC. 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 en las marcas de tiempo dentro del propio archivo de registro.

1. En la barra de menús, haga clic en Admin > Import/Export > Export Policies > Right-click On-demand TechSupport > Create On-demand TechSupport.
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 Techsupport generados se pueden descargar a través de la ficha Operativa de la GUI después de que se hayan generado.
   • Marque Incluir todos los controladores en el soporte técnico para generar los soportes técnicos del APIC.
   • El campo Source Nodes (Nodos de origen) permite especificar 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 un soporte técnico 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 > right-click the policy to be used > 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; a continuación, haga clic en el icono Wrench/Hammer y seleccione Collect Tech Supports.
2. Elija Sí para comenzar a recopilar información de soporte técnico.

Recopile el soporte técnico generado.

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 servicios de soporte técnico generados se pueden encontrar en la ficha Operacional de la política de soporte técnico a pedido. Cada archivo tiene un enlace para descargarlo 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 Techsupport 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 soporte técnico a través de la interfaz de usuario. En su lugar, pueden utilizar sftp u otro método para extraer los archivos techsupport del directorio /data/techsupport/ en los APIC correspondientes.

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

Archivos de soporte técnico a pedido explicados

Si los soportes técnicos se generaron con la opción Exportar al controlador, la GUI muestra tres URL por nodo de ACI (nodo del APIC o nodo del switch). Cada URL es un tipo de archivo de registro diferente y contiene información única. El TAC generalmente requiere que los tres archivos se carguen por nodo para obtener 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 creará una carpeta que contiene los tres archivos por nodo.

Si se produce algún problema al descargar el 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).

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

Soporte técnico local

Siempre se prefiere un soporte técnico a demanda a un soporte técnico local porque un soporte técnico 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 soporte técnico

• 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.
• Un mal funcionamiento interno del proceso impide la operación de soporte técnico a demanda (poco frecuente).

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

1. Abra una sesión de SSH con el APIC con las 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 techsupport mediante SCP:
     • WinSCP o pscp.exe (usuarios de Windows)
     • Cliente del 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. Vaya a: 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 las 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 de SSH con el switch de ACI con las 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 ACI mediante SCP:
  • WinSCP o pscp.exe (usuarios de Windows)
  • Cliente del SCP nativo (usuarios de MAC)
• Opción B: Descargue el archivo de soporte técnico mediante HTTPS a través de 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. Vaya a: 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 las 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

Un soporte técnico de APIC CIMC se puede recopilar 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 Techsupport

Aquí se enumeran algunos de los campos clave del comando show tech.

Archivo/ubicación de Techsup	Descripción
var/	Contiene registros detallados y el estado de todos los servicios supervisados. También contiene archivos de información de servicios, como la configuración de las alarmas de los sensores SOL e IPMI.
var/log	Contiene los mensajes de registro volátil rotatorios.
obfl/	Contiene los mensajes de registro no volátiles rotatorios.
met/	Configuración no volátil 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	Obtiene información básica sobre el estado del CIMC.
Red	Obtiene la configuración de red actual y la información de socket.
obfl	Obtiene un obfl activo (registros de fallos incorporados).
mensajes	Obtiene el archivo /var/log/messages activo.
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 resultados básicos adicionales, como fallas, eventos y auditorías que generalmente se requieren para el RCA.

A partir de ahora, show tech ya incluye un subconjunto de estos objetos, sin embargo, son solo los últimos 10 000 registros. En algunos casos, el TAC requiere el conjunto completo de registros, que va mucho más allá de 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ía y otras salidas de resolució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://<apic address>/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 mediante script Collect TacOutputs

Para los Fabrics ACI que ejecutan versiones anteriores a 5.2/5.3/6.0(3d), existe un script 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 del switch de ACI y el APIC tienen 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 una falla 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.