Raccolta del supporto tecnico ACI e guida agli output richiesti TAC

Introduzione

Questo documento descrive i vari log e output necessari per la risoluzione dei problemi quando si lavora con TAC per ACI.

Premesse

Per un rapido riferimento ai dati da raccogliere prima di aprire una richiesta TAC, fare riferimento alla tabella 1.

Tabella 1: Registra/Mostra matrice di raccolta dati tecnici:

Problemi	Dati da raccogliere	Note
Problemi di aggiornamento	Informazioni per il supporto tecnico su richiesta sui nodi con problemi di aggiornamento. Informazioni per il supporto tecnico su richiesta su tutti gli APIC. Ulteriori errori, eventi e verifiche tramite TacOutput.	Se gli APIC sono diversi e la raccolta di TechSupport su richiesta non riesce, raccogliere TechSupport Local.
Problema di connettività casuale	Supporto tecnico su richiesta dal nodo src (dove l'endpoint src è connesso). Supporto tecnico su richiesta dal nodo dst (dove è connesso il dstendpoint). Ulteriori errori, eventi e verifiche tramite TacOutput.
Perdita completa di connettività	Supporto tecnico su richiesta da foglie (src e dst). Informazioni per il supporto tecnico su richiesta sui nodi spine. Informazioni per il supporto tecnico su richiesta sugli APIC Ulteriori errori, eventi e verifiche tramite TacOutput.	In caso di interruzioni operative, chiedere al team TAC di eseguire un debug in tempo reale. Se i nodi devono essere riavviati per analizzare le cause profonde di un problema (RCA, Root Cause Analysis), raccogliere i log prima di ricaricare i nodi.
Problemi di clustering	Informazioni per il supporto tecnico su richiesta su tutti gli APIC Ulteriori errori, eventi e verifiche tramite TacOutput.	Se gli APIC sono diversi e la raccolta di TechSupport su richiesta non riesce, raccogliere TechSupport Local.
Problemi di routing	Informazioni per il supporto tecnico su richiesta sui nodi con problemi di routing. Ulteriori errori, eventi e verifiche tramite TacOutput.
Arresto anomalo / ricaricamento imprevisto del nodo	Informazioni per il supporto tecnico su richiesta sui nodi bloccati. Crash/core file da nodi arrestati in modo anomalo. Ulteriori errori, eventi e verifiche tramite TacOutput.
Problema sull'appliance APIC	Informazioni per il supporto tecnico su richiesta su tutti gli APIC. Informazioni per il supporto tecnico per l'appliance APIC interessata.

ACI APIC e switch

Informazioni per il supporto tecnico su richiesta

Attivazione e caricamento su Intersight tramite APIC - App Nexus Insights Cloud Connector

Per utilizzare questo metodo, fare riferimento al documento ACI Fabric deve essere connesso e richiesto su Intersight tramite l'APIC: App Nexus Insights Cloud Connector.

1. Accedere a: APIC >Apps >Installed Apps > Apri l'app NICC > TAC Assist > Fare clic su Inizia
2. Selezionare i nodi, quindi fare clic su Raccogli log.
3. Una volta che lo stato del job è COMPLETO, fare clic su Visualizza dettagli.
4. Nella pagina Dettagli job, sotto la tabella Log, in File, individuare la colonna Cloud. 
5. Fare clic su Upload per ciascun pacchetto di supporto tecnico dei dispositivi.

Attivazione e caricamento su Intersight tramite ND - Nexus Dashboard Insights

Per utilizzare questo metodo, fare riferimento a ACI Fabric deve essere connesso e richiesto su Intersight via Nexus Dashboard: Informazioni approfondite su Nexus Dashboard.

1. Accedere a: Nexus Dashboard > Admin Console > Services > Open Nexus Dashboard Insights > Risoluzione dei problemi > Log Collector.
2. Fare clic su Nuova raccolta di log.
   1. Aggiungere un nome alla raccolta di log.
   2. Selezionare un sito. 
   3. Selezionare la casella di controllo Caricamento automatico file registro.
   4. Fare clic su Seleziona nodi e scegliere i nodi.
   5. Fare clic su Avvia raccolta.
   6. I file di TechSupport vengono caricati su intersight.com  
3. Una volta completato il caricamento, notificare a TAC che i file vengono caricati su Intersight. 
4. Il tecnico TAC può spostare i file da Intersight al caso TAC per analizzarli. 

Attivazione dall'interfaccia utente dell'APIC

Creazione di una policy di supporto tecnico su richiesta

Nota: non specificare un intervallo di tempo per la raccolta delle informazioni per il supporto tecnico a meno che non venga richiesto esplicitamente dal team TAC. Se si verifica una variazione eccessiva del log, si potrebbe verificare una perdita di log. Ciò incide gravemente sulla capacità di TAC di fornire un RCA tempestivo. Se viene fornito un intervallo di tempo di TechSupport, i registri vengono tagliati in base all'ultimo timestamp di modifica del file e NON in base ai timestamp all'interno del file di registro stesso.

1. Nella barra dei menu, fare clic su Admin > Import/Export > Export Policies >Right-Click On-Demand TechSupport > Create On-Demand TechSupport.
2. Compilare i campi della finestra di dialogo Create On-demand TechSupport (Crea file di supporto tecnico su richiesta) con le informazioni necessarie.
   • Se un percorso remoto non è disponibile, fare clic su Export to Controller (Esporta nel controller). I servizi di supporto tecnico generati vengono scaricati tramite la scheda Operational dell'interfaccia grafica una volta generati.
   • Selezionare Include All Controllers in TechSupport (Includi tutti i controller nei file di supporto tecnico) per generare i file di supporto tecnico degli APIC.
   • Il campo Nodi origine consente di specificare i nodi dello switch che generano un supporto tecnico.
3. Fare clic su Submit (Invia) per creare la policy di supporto tecnico su richiesta.

Generare un supporto tecnico su richiesta.

1. Selezionare una policy di supporto tecnico su richiesta esistente. I criteri creati sono disponibili all'indirizzo: Admin > Import/Export > Export Policies > On-Demand TechSupport > Expand On-Demand TechSupport Folder> Fare clic con il pulsante destro del mouse sul criterio da utilizzare > Collect Tech Supports (Raccogli supporto tecnico).
   
   • In alternativa, fare clic con il pulsante sinistro del mouse sulla politica di supporto tecnico su richiesta per visualizzarla nel riquadro principale; quindi fare clic sull'icona degli attrezzi e selezionare Collect Tech Supports (Raccogli informazioni per il supporto tecnico).
2. Selezionare Yes (Sì) per iniziare a raccogliere informazioni per il supporto tecnico.

Raccogliere il supporto tecnico generato.

1. Se l'esportazione nel controller non è stata abilitata durante la generazione del supporto tecnico, è possibile controllare la destinazione di esportazione (posizione remota) per tutti i file del supporto tecnico.
2. Se l'opzione Export to Controller (Esporta nel controller) è stata abilitata, selezionare la policy di supporto tecnico su richiesta usata per generare le informazioni. I criteri creati sono disponibili all'indirizzo Admin > Import/Export > Export Policies > On-Demand TechSupport.
   • I servizi di supporto tecnico generati sono reperibili nella scheda Operativo della politica di supporto tecnico su richiesta. Ogni file ha un collegamento da scaricare tramite http/https. Ogni nodo dispone di tre collegamenti, uno collegato a ciascun file.

Nota: Se la versione è precedente alla 2.2, è necessario utilizzare l'account utente admin locale per scaricare TechSupports tramite l'interfaccia utente. In alternativa, usare un altro account locale con privilegi di amministratore. Gli utenti remoti non possono scaricare TechSupports tramite l'interfaccia utente. Possono invece utilizzare sftp o un altro metodo per estrarre i file di TechSupport dalla directory /data/techsupport/ degli APIC corrispondenti.

Nota:  Il numero nell'URL del bundle TechSupport indica su quale APIC risiede il file. Ad esempio, files/2/techsupport.tgz indica che questo bundle specifico si trova nella directory /data/techsupport/ di APIC 2.

Informazioni sui file di supporto tecnico su richiesta

Se i file TechSupports sono stati generati con l'opzione Esporta in controller, la GUI mostra tre URL per nodo ACI (nodo APIC o nodo Switch). Ogni URL rappresenta un file di log di tipo diverso e contiene informazioni univoche. In genere, TAC richiede il caricamento di tutti e tre i file per nodo per ricevere tutte le registrazioni e consentire un'analisi completa.

Ogni URL corrisponde a uno dei tre tipi di file seguenti:

Categoria	Suffisso tipico	Utile per:	Dimensioni file
Esporta	_1of3.tgz	Log di audit/errori	Medio-piccole
Log	_logs_3of3.tgz	Log di processo	Molto elevate
DB	_db_2of3.tgz	Dump MO	Piccole

Nota:  Se invece di Esporta in controller è stata selezionata una destinazione di esportazione, la posizione remota definita crea una cartella contenente i tre file per nodo.

In caso di problemi durante il download del supporto tecnico tramite il collegamento del browser, scaricare direttamente i file dallo storage APIC utilizzando un client SCP o SFTP, ad esempio WinSCP o FileZilla.

1. Connettersi (sftp) a ciascun APIC. I file del supporto tecnico raccolti vengono memorizzati su tutti gli APIC disponibili, quindi è importante controllare ogni APIC per individuare i file del supporto tecnico raccolti.

2. Passare alla cartella /data/techsupport dell'APIC connesso (ripetere questo passaggio per tutti i controller APIC).

3. Cercare i file il cui nome contiene il nome del criterio di supporto tecnico su richiesta (in questo esempio, ABCTECH) e scaricarli nel computer.

Supporto tecnico locale

Il supporto tecnico su richiesta è sempre preferito al supporto tecnico locale, in quanto offre un quadro più completo. Tuttavia, il cluster APIC deve essere completamente integrato in quanto la raccolta è attivata dalla policy.

Scenari locali di TechSupport:

• APIC non è completamente adatto.
• Lo switch ACI non è stato ancora individuato dall'APIC.
• Lo switch ACI ha perso la comunicazione con l'APIC.
• Il processo interno non funziona correttamente, il che impedisce al supporto tecnico su richiesta di funzionare (raramente).

Attivazione dalla CLI dall'APIC

1. Aprire una sessione SSH con l'APIC con le credenziali di amministratore.
   • Se non è possibile utilizzare le credenziali di amministratore per eseguire l'accesso, utilizzare il nome utente save-user. La password può essere la stessa dell'utente locale amministratore.
2. Eseguire il comando bash -c "supporto tecnico locale".

   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. Scaricare il file di supporto tecnico locale.
   
   • Opzione A. Scaricare il file di supporto tecnico usando il protocollo SCP:
     • WinSCP o pscp.exe (utenti di Windows).
     • Client SCP nativo (utenti MAC).
   • Opzione B. Scaricare il file di supporto tecnico usando il protocollo HTTPS.
     1. Aprire un browser, ad esempio Chrome o Firefox.
     2. Accedere a: https://<aci.apic.ip.addr>/files/<apic#>/supporto tecnico/<ts_filename>
        • Esempio: https://a.p.i.c/files/1/techsupport/local_apic1_2018-05-29T08-17.tgz
     3. Accedere con le credenziali di amministratore.
     4. Se richiesto, selezionare Save File (Salva file) sul prompt di download del browser.

Attivazione dalla CLI dello switch

1. Aprire una sessione SSH con lo switch ACI con credenziali amministrative.
   • Se lo switch non è stato ancora rilevato dall'APIC, usare il nome utente admin.
2. Eseguire il 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. Scaricare il file di supporto tecnico locale.

• Opzione A. Scaricare il file di supporto tecnico dallo switch ACI usando il protocollo SCP:
  • WinSCP o pscp.exe (utenti di Windows).
  • Client SCP nativo (utenti MAC).
• Opzione B. Scaricare il file di supporto tecnico usando il protocollo HTTPS tramite l'APIC:
  
  1. Eseguire il login a una CLI APIC (notare quale APIC viene utilizzato per il passo 4).
  2. Trasferire il file di supporto tecnico dallo switch ACI all'APIC utilizzando questo comando:
     • scp <nome-nodo>:/data/techsupport/<nome_file_ts> /data/techsupport
     • Esempio: apic1#  scp  fab5-leaf1:/data/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz   /data/techsupport
  3. Aprire un browser, ad esempio Chrome o Firefox.
  4. Accedere a: https://<aci.apic.ip.addr>/files/<apic#>/supporto tecnico/<ts_filename>
     • Esempio: https://a.p.i.c/files/1/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz
  5. Accedere con le credenziali di amministratore.
  6. Se richiesto, selezionare Save File (Salva file) sul prompt di download del browser.

File di supporto tecnico in CIMC

Attivazione dall'interfaccia utente di CIMC

È possibile raccogliere un supporto tecnico da CIMC APIC per esaminare i registri relativi allo chassis APIC. Un programma CIMC può essere acquisito localmente o inviato a una postazione remota dalla sezione Utilità della scheda Amministrazione CIMC. 

Attivazione tramite CLI CIMC

Nella CLI dell'APIC CIMC, immettere:

~ # 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 

Analisi del supporto tecnico CIMC

Fare riferimento ad alcuni dei campi chiave del comando show tech:

File/percorso di TechSupport	Descrizione
var/	Contiene registri dettagliati e lo stato di tutti i servizi monitorati. Dispone di file di informazioni sul servizio come le configurazioni degli allarmi dei sensori SOL e IPMI.
var/log	Contiene i messaggi di log volatili in sequenza.
obfl/	Contiene i messaggi di registro non volatile in sequenza.
soddisfatto/	Configurazioni non volatili e SEL.
mp/	I file di testo show tech-support, insieme ai file di testo del BIOS tech-support. I file di testo contengono tutte le informazioni sullo stato di processo, rete, sistema, scheda mezzanino e BIOS.
mctool	Ottenere informazioni di base sullo stato del CIMC.
rete	Ricevere le informazioni correnti sulla configurazione della rete e sul socket.
obfl	Ottenere un obfl (On-Board Failure Logs) attivo.
messaggi	Ricevi il file live /var/log/messages.
allarmi	Elenca i sensori negli stati di allarme.
sensori	Rilevazioni correnti del sensore da IPMI.
potenza	Stato di alimentazione corrente di x86.

Verifiche estese, eventi, errori (TacOutput)

TAC può richiedere output di base aggiuntivi, ad esempio errori, eventi e verifiche, generalmente richiesti per RCA.

Ad oggi, i tecnici del programma includono già un sottoinsieme di questi oggetti, ma solo gli ultimi 10.000 record. In alcuni casi, la funzione TAC richiede una serie completa di record, superiore a 10.000.

Nota: A partire dalla versione 5.2(1g), è possibile usare il comando CLI trigger output dall'APIC per raccogliere questi oggetti aggiuntivi. Nelle versioni precedenti alla 5.3(x) e alla 6.0(3d), tuttavia, lo script incorporato potrebbe non riuscire a raccogliere tutte le pagine di record. In questo caso, si consiglia di utilizzare la versione più aggiornata dello script all'interno del repository aci-tac-scripts descritto nella sezione successiva.

Trigger tramite TACOutput - 5.2/5.3/6.0(3d) e versioni successive

Per ACI Fabric con versione 5.2/5.3/6.0(3d) e successive, il trigger taoutput fornisce un'interfaccia di raccolta semplificata per eventi, errori, verifiche e altri output per la risoluzione dei problemi):

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

Script trigger tramite raccolta output TACO

Per i fabric ACI con versione precedente alla 5.2/5.3/6.0(3d), è disponibile uno script Collect TacOutput nel repository aci-tac-scripts che serve un'interfaccia simile 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

File degli arresti anomali/core

Raccolta dall'interfaccia utente dell'APIC

Il nodo dello switch ACI e l'APIC dispongono di numerosi processi che controllano vari aspetti funzionali del sistema. Se il sistema presenta un errore software in un determinato processo, viene generato un file core e il processo viene ricaricato. Quando un processo si blocca e viene generato un file di base, viene generato un errore e un evento. In caso di arresto anomalo del processo sullo switch/APIC, il file core viene compresso e copiato nell'APIC.

L'interfaccia utente grafica APIC offre una posizione centrale per la raccolta dei file di base per i nodi della struttura. È possibile creare un nuovo criterio di esportazione da Admin > IMPORT/EXPORT in Criteri di esportazione > Core.

Esiste una regola di base predefinita che consente di scaricare direttamente i file. Tutti i file di base generati tentano il trasferimento al controller APIC quando vengono generati. Se l'operazione ha esito positivo, è possibile trovarle nei criteri di base predefiniti.

Log di audit autonomo

Raccolta dall'interfaccia utente di NDO/MSO

È possibile scaricare i registri di controllo MSC in formato JSON CSV:

Cronologia delle revisioni

Revisione	Data di pubblicazione	Commenti
9.0	08-Jun-2026	Controllo ortografico, grammaticale, struttura della frase, testo alternativo modificato e spaziatura aggiornati.
8.0	06-May-2024	Informazioni personali aggiornate, titolo, traduzione automatica, contenitori di note e formattazione.
7.0	23-Apr-2024	Aggiornamento del formato e collegamenti alla guida Device Connector per APIC e ND
5.0	27-May-2022	La generazione e il caricamento di TechSupport in Intersight tramite APIC/ND è stato aggiornato.
4.0	16-Mar-2022	Aggiunto percorso allo script TacOutput su GIT.
3.0	22-Feb-2022	Aggiornamento secondario.
2.0	17-Dec-2021	Aggiunta della CLI APIC "trigger output" al documento.
1.0	06-Sep-2021	Versione iniziale