Collecter le support technique ACI et le guide des résultats demandés par le TAC

Introduction

Ce document décrit les différents journaux et sorties requis pour le dépannage lors de l'utilisation du TAC pour l'ACI.

Informations générales

Pour obtenir une référence rapide sur les données à collecter avant d'ouvrir un dossier TAC, reportez-vous au Tableau 1.

Tableau 1 : Matrice d’obtention des journaux/des fichiers d’affichage technique:

Problèmes	Quoi rassembler	Remarques
Problèmes de mise à jour	Fichiers d’assistance technique à la demande à partir des nœuds présentant un problème de mise à niveau. Fichiers d’assistance technique à la demande de tous les contrôleurs APIC. Erreurs, événements et audits supplémentaires via TacOutput.	Si les APIC sont divergents et que la collecte TechSupport à la demande échoue, collectez TechSupport Local.
Problème de connectivité aléatoire	Assistance technique à la demande à partir du noeud src (où le point d'extrémité src est connecté). Assistance technique à la demande à partir du noeud dst (où le point de terminaison dst est connecté). Erreurs, événements et audits supplémentaires via TacOutput.
Perte totale de connectivité	Assistance technique à la demande à partir des feuilles (src et dst). Fichiers d’assistance technique à la demande à partir de commutateurs dorsaux. Fichiers d’assistance technique à la demande à partir de contrôleurs APIC Erreurs, événements et audits supplémentaires via TacOutput.	Pour les pannes en cours, communiquer avec Cisco TAC pour le débogage en direct. Si, pour une raison quelconque, les nœuds doivent être redémarrés, obtenir les journaux avant le rechargement si une analyse de cause première doit être effectuée.
Problèmes de mise en grappe	Fichiers d’assistance technique à la demande de tous les contrôleurs APIC Erreurs, événements et audits supplémentaires via TacOutput.	Si les APIC sont divergents et que la collecte TechSupport à la demande échoue, collectez TechSupport Local.
Problèmes de routage	Fichiers d’assistance technique à la demande à partir des nœuds ayant un problème de routage. Erreurs, événements et audits supplémentaires via TacOutput.
Panne de nœud ou rechargement inattendu	Fichiers d’assistance technique à la demande à partir des nœuds en panne. Fichiers de blocage/mémoire à partir d'un ou de plusieurs noeuds bloqués. Erreurs, événements et audits supplémentaires via TacOutput.
Problème d’application APIC	Fichiers d’assistance technique à la demande de tous les contrôleurs APIC. Fichiers d’assistance technique de l’application APIC pour l’application concernée.

APIC et commutateur ACI

Fichiers d’assistance technique à la demande

Déclenchement et téléchargement vers Intersight via APIC - Application Nexus Insights Cloud Connector

Pour utiliser cette méthode, reportez-vous à la section ACI Fabric must be connected and claim on Intersight via the APIC: Application Nexus Insights Cloud Connector.

1. Naviguez jusqu’à l’adresse : APIC > Apps > Installed Apps > Ouvrez l'application NICC > TAC Assist > Cliquez sur Begin
2. Sélectionnez le ou les noeuds, puis cliquez sur Collecter les journaux.
3. Une fois que l'état du travail est COMPLETE, cliquez sur View Details.
4. Sur la page Job Details, sous le tableau Logs, sous File, recherchez la colonne Cloud. 
5. Cliquez sur Upload pour chaque offre TechSupport de périphériques.

Déclenchement et téléchargement vers Intersight via ND - Nexus Dashboard Insights

Pour utiliser cette méthode, reportez-vous à la section ACI Fabric must be connected and claim on Intersight via Nexus Dashboard : Aperçu du tableau de bord Nexus.

1. Naviguez jusqu’à l’adresse : Tableau de bord Nexus > Console d'administration > Services > Ouvrir Nexus Dashboard Insights > Dépanner > Log Collector.
2. Cliquez sur Nouvelle collection de journaux.
   1. Ajoutez un nom à la collection de journaux.
   2. Sélectionnez un site. 
   3. Cochez la case Chargement automatique des fichiers journaux.
   4. Cliquez sur Sélectionner des noeuds, puis choisissez le ou les noeuds.
   5. Cliquez sur Démarrer la collecte.
   6. Les fichiers TechSupport sont téléchargés sur intersight.com  
3. Une fois le téléchargement terminé, informez le TAC que les fichiers sont téléchargés sur Intersight. 
4. L'ingénieur TAC peut déplacer les fichiers d'Intersight vers le dossier TAC pour analyse. 

Déclenchement par l’interface utilisateur du contrôleur APIC

Création d’une politique d’assistance technique à la demande

Remarque : N’indiquez pas de plage de temps pour les fichiers d’assistance technique, sauf si Cisco TAC vous le demande explicitement. Si le taux de résiliation du journal est trop élevé, cela peut entraîner une perte de journaux. Cela a une incidence grave sur la capacité du TAC de fournir une ACR en temps opportun. Si un intervalle de temps TechSupport est fourni, il coupe les journaux en fonction de l'horodatage de dernière modification de fichier et PAS en fonction des horodatages dans le fichier journal lui-même.

1. Dans la barre de menus, cliquez sur Admin > Import/Export > Export Policies > Cliquez avec le bouton droit sur On-demand TechSupport > Create On-demand TechSupport.
2. Entrez les valeurs appropriées dans les champs de la boîte de dialogue Create On-demand TechSupport (créer des fichiers d’assistance technique à la demande).
   • Si aucun emplacement distant n’est disponible, cochez la case Export to Controller (exporter vers le contrôleur). Les TechSupports générés sont téléchargés via l'onglet Opérationnel de l'interface graphique une fois qu'ils ont été générés.
   • Cochez Include All Controllers in TechSupport (inclure tous les contrôleurs dans les fichiers d’assistance technique) pour générer des fichiers d’assistance technique APIC.
   • Le champ Source Nodes vous permet de spécifier les noeuds de commutation qui génèrent un TechSupport.
3. Cliquez sur Submit (soumettre) pour créer la politique d’assistance technique à la demande.

Générez une assistance technique à la demande.

1. Permet d’accéder à une politique d’assistance technique à la demande existante. Les stratégies créées sont disponibles à l'adresse : Admin > Import/Export > Export Policies > On-Demand TechSupport > Expand On-Demand TechSupport Folder > Cliquez avec le bouton droit sur la stratégie à utiliser > Collect Tech Supports.
   
   • Vous pouvez également cliquer avec le bouton gauche sur On-Demand TechSupport Policy pour l'afficher dans le volet principal ; puis cliquez sur l’icône de clé et de marteau et sélectionnez Collect Tech Supports (obtenir des fichiers d’assistance technique).
2. Sélectionnez Yes (oui) pour commencer à obtenir des informations d’assistance technique.

Collectez le support technique généré.

1. Si l'exportation vers le contrôleur n'a pas été activée pendant la génération du support technique, la destination d'exportation (site distant) peut être vérifiée pour tous les fichiers du support technique.
2. Si l’option Export to Controller (exporter vers le contrôleur) a été activée, accédez à la politique d’assistance technique à la demande selon laquelle les fichiers ont été générés. Les stratégies créées sont disponibles dans Admin > Import/Export > Export Policies > On-Demand TechSupport.
   • Les TechSupports générés sont disponibles dans l'onglet Opérationnel de la politique d'assistance technique à la demande. Chaque fichier possède un lien à télécharger via http/https. Chaque noeud comporte trois liens, un lien lié à chaque fichier.

Remarque : Si la version est antérieure à 2.2, vous devez utiliser le compte d'utilisateur admin local pour télécharger TechSupports via l'interface utilisateur. Sinon, utilisez tout autre compte local disposant de privilèges d’administrateur. Les utilisateurs distants ne peuvent pas télécharger TechSupports via l'interface utilisateur. Au lieu de cela, ils peuvent utiliser sftp ou une autre méthode pour extraire les fichiers TechSupport du répertoire /data/techsupport/ sur les APIC correspondants.

Remarque :  Le numéro dans l'URL du bundle TechSupport indique sur quel APIC le fichier réside. Par exemple, files/2/techsupport.tgz indique que ce bundle spécifique se trouve dans le répertoire /data/techsupport/ de l'APIC 2.

Explication des fichiers d’assistance technique à la demande

Si les fichiers TechSupports ont été générés avec l'option Exporter vers le contrôleur, l'interface utilisateur graphique affiche trois URL par noeud ACI (noeud APIC ou noeud Switch). Chaque URL représente un type de fichier journal différent et contient des informations uniques. Le TAC exige généralement que les trois fichiers soient téléchargés par noeud pour recevoir l'ensemble de la journalisation en vue d'une analyse complète.

Chaque URL correspond à l'un des trois types de fichiers suivants :

Catégorie	Suffixe habituel	Utile pour :	Taille du fichier
Exporter	_1of3.tgz	Journaux d’audit/de défaillance	Petit-Moyen
Journaux	_logs_3of3.tgz	Journaux de processus	Le plus grand
DB	_db_2of3.tgz	Vidange MO	Petite entreprise

Remarque :  Si une destination d'exportation a été sélectionnée au lieu de l'option Exporter vers le contrôleur, l'emplacement distant défini crée un dossier qui contient les trois fichiers par noeud.

En cas de problème lors du téléchargement du support technique à l'aide du lien du navigateur, téléchargez directement les fichiers à partir du stockage APIC à l'aide d'un client scp ou sftp tel que WinSCP ou FileZilla.

1. Connectez (sftp) à chaque contrôleur APIC. Les fichiers d'assistance technique collectés sont stockés sur tous les APIC disponibles. Il est donc important de vérifier chaque APIC pour les fichiers d'assistance technique collectés.

2. Accédez au dossier /data/techsupport dans le contrôleur APIC connecté (répétez cette étape dans tous les contrôleurs APIC).

3. Recherchez les fichiers dont le nom contient le nom de la stratégie de support technique à la demande (dans cet exemple, il s'agit de ABCTECH) et téléchargez ces fichiers sur votre ordinateur.

Assistance technique locale

L'assistance technique à la demande est toujours préférée à une assistance technique locale, car elle fournit une image plus complète. Cependant, elle repose sur une grappe APIC entièrement adaptée, car la collecte est déclenchée par l’entremise d’une politique.

Scénarios locaux TechSupport :

• Le module APIC n'est pas entièrement adapté.
• Le commutateur ACI n'est pas encore détecté par le contrôleur APIC.
• Le commutateur ACI a perdu la communication avec le contrôleur APIC.
• Le processus interne ne fonctionne pas correctement, ce qui empêche l'assistance technique à la demande de fonctionner correctement (rare).

Déclenchement par interface CLI du contrôleur APIC

1. Ouvrez une session SSH avec le contrôleur APIC avec des informations d'identification d'administrateur.
   • Si vous ne pouvez pas utiliser les informations d'identification d'administrateur pour vous connecter, utilisez le nom d'utilisateur save-user. Le mot de passe peut être identique à celui de l'utilisateur local admin.
2. Exécutez la commande 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. Téléchargez le fichier d’assistance technique local.
   
   • Option A : Téléchargez le fichier d’assistance technique à l’aide de SCP (secure copy protocol) :
     • WinSCP ou pscp.exe (Utilisateurs Windows).
     • Client SCP natif (utilisateurs MAC).
   • Option B : Téléchargez le fichier d’assistance technique à l’aide de HTTPS :
     1. Ouvrez un navigateur, tel que Chrome ou Firefox.
     2. Naviguez jusqu’à l’adresse : https://<aci.apic.ip.addr>/files/<apic#>/techsupport/<ts_filename>
        • Exemple : https://a.p.i.c/files/1/techsupport/local_apic1_2018-05-29T08-17.tgz
     3. Connectez-vous avec les identifiants admin.
     4. Sur invitation, sélectionnez Save File (enregistrer le fichier) dans l’invite de téléchargement du navigateur.

Déclenchement par interface CLI du commutateur

1. Ouvrez une session SSH avec le commutateur ACI avec les informations d'identification d'administrateur.
   • Si le contrôleur APIC ne détecte pas encore le commutateur, utilisez le nom d'utilisateur admin.
2. Exécutez la commande : "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. Téléchargez le support technique local.

• Option A : Téléchargez le fichier d’assistance technique à partir du commutateur ACI à l’aide de SCP (secure copy protocol) :
  • WinSCP ou pscp.exe (Utilisateurs Windows).
  • Client SCP natif (utilisateurs MAC).
• Option B : Téléchargez le fichier d’assistance technique à l’aide de HTTPS par l’entremise du contrôleur APIC :
  
  1. Connectez-vous à une interface de ligne de commande APIC (notez quelle carte APIC est utilisée pour l'étape 4).
  2. Transférez le fichier techsupport du commutateur ACI vers le contrôleur APIC à l'aide de cette commande :
     • scp <nom_noeud> : /data/techsupport/<nom_fichier_ts> /data/techsupport
     • Exemple : apic1#  scp  fab5-leaf1:/data/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz   /data/techsupport
  3. Ouvrez un navigateur, tel que Chrome ou Firefox.
  4. Naviguez jusqu’à l’adresse : https://<aci.apic.ip.addr>/files/<apic#>/techsupport/<ts_filename>
     • Exemple : https://a.p.i.c/files/1/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz
  5. Connectez-vous avec les identifiants admin.
  6. Sur invitation, sélectionnez Save File (enregistrer le fichier) dans l’invite de téléchargement du navigateur.

Assistance technique du contrôleur CIMC

Déclenchement par l’interface utilisateur du contrôleur CIMC

Un TechSupport du CIMC APIC peut être collecté pour examiner les journaux associés au châssis APIC. Un show tech CIMC peut être capturé localement ou envoyé à un emplacement distant à partir de la section Utilitaires de l'onglet Admin CIMC. 

Déclencheur via CIMC CLI

Sur l’interface CLI du contrôleur APIC CIMC, entrez :

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

Analyse de CIMC TechSupports

Reportez-vous à certains des champs clés des commandes show tech :

Emplacement/fichier TechSupport	Description
var/	Contient des journaux détaillés et un état de tous les services surveillés. Il contient des fichiers d'informations de service tels que les configurations des alarmes de capteur SOL et IPMI.
var/log	Contient les messages du journal volatil en cours.
obfl/	Contient les messages de journal non volatils roulants.
atteint/	Configurations non volatiles et SEL.
mp/	La commande show tech-support text files, ainsi que les fichiers texte du support technique du BIOS. Les fichiers texte contiennent toutes les informations sur le processus, le réseau, le système, la mezzanine et l’état du BIOS.
machine à usiner	Obtenez des informations de base sur l’état du CIMC.
network	Recevez les informations de configuration réseau et de socket actuelles.
impertinent	Obtenir les journaux des défaillances internes (Ofl) en direct.
messages	Recevez le fichier live /var/log/messages.
alarmes	Répertorie les capteurs dans les états d'alarme.
capteurs	Lectures actuelles des capteurs à partir de IPMI.
énergie	État d'alimentation actuel du x86.

Audits, événements, défaillances étendus et plus encore (TacOutput)

Le TAC peut demander des extrants de base supplémentaires, tels que des pannes, des événements et des audits, qui sont généralement requis pour l'architecture RCA.

À l'heure actuelle, les show techs incluent déjà un sous-ensemble de ces objets, mais seulement les 10 000 derniers enregistrements. Dans certains cas, le TAC exige un ensemble complet d'enregistrements, ce qui dépasse les 10 000 enregistrements.

Remarque : À partir de la version 5.2(1g), vous pouvez utiliser la commande CLI trigger tacoutput du contrôleur APIC pour collecter ces objets supplémentaires. Cependant, dans les versions antérieures à 5.3(x) et 6.0(3d), le script intégré peut ne pas collecter toutes les pages d'enregistrements. Dans ce cas, il est recommandé d'utiliser la version la plus mise à jour du script dans le référentiel aci-tac-scripts décrit dans la section suivante.

Trigger via Trigger TACOutput - 5.2/5.3/6.0(3d) et versions ultérieures

Pour les fabrics ACI exécutant la version 5.2/5.3/6.0(3d) et les versions ultérieures, trigger tacoutput fournit une interface de collecte simplifiée pour les événements, les pannes, les audits et autres sorties de dépannage) :

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

Déclencher via Collecter le script TACOutputs

Pour les fabrics ACI exécutant des versions antérieures à 5.2/5.3/6.0(3d), un script Collect TacOutput est disponible dans le référentiel aci-tac-scripts, qui sert une interface similaire à la commande 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

Fichiers crash/principaux

Obtention par l’interface utilisateur du contrôleur APIC

Le noeud de commutation ACI et le contrôleur APIC comportent de nombreux processus qui contrôlent divers aspects fonctionnels du système. Si le système a une défaillance logicielle lors d’un processus en particulier, un fichier principal est généré et le processus est rechargé. Lorsqu'un processus tombe en panne et qu'un fichier de base est généré, une défaillance et un événement sont générés. Lorsque le processus plante sur le commutateur ou sur le contrôleur APIC, le fichier principal est compressé et copié sur le contrôleur APIC.

L'interface utilisateur graphique du contrôleur APIC fournit un emplacement central pour la collecte des fichiers principaux des noeuds du fabric. Une nouvelle stratégie d'exportation peut être créée à partir de Admin > IMPORT/EXPORT dans Politiques d'exportation > Core.

Il existe une stratégie principale par défaut qui permet de télécharger directement des fichiers. Tous les fichiers de coeur générés tentent un transfert vers le contrôleur APIC lorsqu'ils sont générés. En cas de succès, ils se trouvent dans la stratégie principale par défaut.

Journaux d’audit autonomes

Obtention par l’interface utilisateur de NDO/MSO

Les journaux d'audit MSC peuvent être téléchargés en JSON au format CSV :

Historique de révision

Révision	Date de publication	Commentaires
9.0	08-Jun-2026	Mise à jour de l'orthographe, de la grammaire, de la structure des phrases, du texte de remplacement et de l'espacement.
8.0	06-May-2024	Mise à jour des PII, du titre, de la traduction automatique, des conteneurs de notes et du formatage.
7.0	23-Apr-2024	Mise à jour du format et liens vers le guide Device Connector pour APIC et ND
5.0	27-May-2022	La génération et le téléchargement de TechSupport vers Intersight via APIC/ND ont été mis à jour.
4.0	16-Mar-2022	Ajout du chemin au script TacOutput sur GIT.
3.0	22-Feb-2022	Mise à jour mineure.
2.0	17-Dec-2021	Ajout de l'interface de ligne de commande APIC « trigger tacoutput » au document.
1.0	06-Sep-2021	Première publication