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 de collecte des journaux et des technologies

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. Défaillances, événements et audits supplémentaires par l’entremise de TacOutput.	Si les APIC sont divergents et que la collecte de l'assistance technique à la demande échoue, collectez l'assistance technique locale.
Problème de connectivité aléatoire	Assistance technique à la demande à partir du noeud src (où le terminal src est connecté). Assistance technique à la demande à partir du noeud dst (où le point dstendpoint est connecté). Défaillances, événements et audits supplémentaires par l’entremise de TacOutput
Perte totale de connectivité	Fichiers d’assistance technique à la demande à partir de feuillets (src et dst) Fichiers d’assistance technique à la demande à partir de commutateurs dorsaux Fichiers d’assistance technique à la demande à partir de contrôleurs APIC Défaillances, événements et audits supplémentaires par l’entremise de 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 Défaillances, événements et audits supplémentaires par l’entremise de TacOutput	Si les APIC sont divergents et que la collecte de l'assistance technique à la demande échoue, collectez l'assistance technique locale.
Problèmes de routage	Fichiers d’assistance technique à la demande à partir des nœuds ayant un problème de routage. Défaillances, événements et audits supplémentaires par l’entremise de 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. Défaillances, événements et audits supplémentaires par l’entremise de 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 l'application APIC : Nexus Insights Cloud Connector.

1. Accédez à : APIC > Apps > Installed Apps > open NICC app > TAC Assist > cliquez sur Begin
2. Sélectionnez le ou les noeuds, puis cliquez sur Collecter les journaux.
3. Une fois l'état du travail TERMINÉ, cliquez sur Afficher les détails.
4. Dans la page Détails du travail, sous le tableau Journaux, vous recherchez la colonne Cloud. 
5. Cliquez sur Upload pour l'offre TechSupport de chaque périphérique.

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 : Nexus Dashboard Insights.

1. Accédez à : Nexus Dashboard > Admin Console > Services > Open Nexus Dashboard Insights > Troubleshoot > Log Collector.
2. Cliquez sur Nouvelle collection de journaux.
   1. Donnez un nom à la collection de journaux.
   2. Sélectionnez un site. 
   3. Case à cocher Activer pour le 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é, avertissez le TAC que les fichiers sont téléchargés lors de l'analyse. 
4. L'ingénieur du centre d'assistance technique peut déplacer les fichiers de l'analyse vers le dossier du centre d'assistance technique pour analyse. 

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

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

Remarque : ne spécifiez pas d'intervalle de temps TechSupport sauf si le 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 supprime les journaux en fonction de l'horodatage de dernière modification de fichier et NON 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 peuvent ensuite être téléchargés via l'onglet Opérationnel de l'interface utilisateur 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 Noeuds source 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 cliquer sur l'icône Wrench/Hammer et choisir Collect Tech Supports.
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 de Techsupport, la destination d'exportation (emplacement distant) peut être vérifiée pour tous les fichiers de techsupport.
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 fichiers d’assistance technique générés se trouvent dans l’onglet Operational (opérationnel) de cette politique d’assistance technique à la demande. Chaque fichier dispose d'un lien pour le 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 les services d'assistance technique 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 compris dans l’URL des fichiers d’assistance technique indique sur quel contrôleur APIC se trouve le fichier. 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 d’assistance technique ont été générés avec l’option Export to Controller (exporter vers le contrôleur), l’interface graphique affiche trois URL par nœud ACI (nœud APIC ou nœud de commutation). Chaque URL représente un type de fichier journal différent et contient des informations uniques. Cisco TAC exige généralement de charger trois fichiers par nœud afin d’obtenir l’ensemble de la journalisation pour une analyse complète.

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

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).

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

Assistance technique locale

Une assistance technique à la demande est toujours préférée à une assistance technique locale, car une assistance technique à la demande 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 d’assistance technique locale

• 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.
• Dysfonctionnement du processus interne empêchant le fonctionnement du support technique à la demande (rare).

Déclenchement par interface CLI du contrôleur APIC

1. Ouvrez une session SSH à l’aide du contrôleur APIC à l’aide des informations d’authentification de l’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 techsupport à l'aide de SCP :
     • WinSCP ou pscp.exe (utilisateurs Windows)
     • Client SCP natif (utilisateurs MAC)
   • Option B : Téléchargez le fichier techsupport à l'aide de HTTPS :
     1. Ouvrez un navigateur comme Chrome ou Firefox.
     2. Accédez à : 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 à l’aide de votre authentifiant 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 à l’aide des informations d’authentification de l’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 :
  • WinSCP ou pscp.exe (utilisateurs Windows)
  • Client SCP natif (utilisateurs MAC)
• Option B : Téléchargez le fichier techsupport à l'aide de HTTPS via le 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 comme Chrome ou Firefox.
  4. Accédez à : 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 à l’aide de votre authentifiant 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 support technique 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 des supports techniques CIMC

Certains des champs clés de la commande show tech sont répertoriés ici.

Fichier/emplacement Techsup	Description
var/	Contient des journaux détaillés et l'état de tous les services surveillés. Le champ contient également des fichiers de renseignements sur les services tels que la configuration des alarmes des capteurs SOL et IPMI.
var/log	Contient les messages du journal volatil en cours.
obfl/	Contient les messages de journal non volatils roulants.
atteint/	Configuration non volatile 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	Obtient des informations de base sur l’état du CIMC.
network	Obtient la configuration réseau et les informations de socket actuelles.
impertinent	Obtient le journal des défaillances de la carte mère (Ofl).
messages	Obtient le fichier /var/log/messages en direct.
alarmes	Répertorie les capteurs dans les états d'alarme.
capteurs	Lectures actuelles des capteurs à partir de IPMI.
alimentation	État d'alimentation actuel du x86.

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

Cisco TAC peut demander des rapports de base supplémentaires, par exemple des rapports de défaillances, d’événements et de vérifications, qui sont généralement nécessaires pour l’analyse de cause première.

À ce jour, les fichiers d’affichage technique incluent déjà un sous-ensemble de ces objets, mais seulement les 10 000 derniers enregistrements. Dans certains cas, le TAC exige l'ensemble complet des enregistrements, ce qui dépasse largement les 10 000 enregistrements.

Remarque : à partir de la version 5.2(1g), vous pouvez utiliser le résultat de 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.3/6.0(3d) et versions ultérieures

Pour les fabrics ACI exécutant la version 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, l'audit et d'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://<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

Déclencher via le script Collect TacOutputs

Pour les fabrics ACI exécutés avant 5.3/6.0(3d), il existe un script Collect TacOutput 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 nœud de commutation ACI et le contrôleur APIC comportent de nombreux processus contrôlant 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 plante et qu’un fichier principal est généré, un rapport d’erreur et un rapport d’événement sont produits. 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 Export Policies > 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 au format JSON sur CSV.