Utilisation de vemlog pour déboguer les problèmes de Nexus 1000v

Introduction

La partie Virtual Ethernet Module (VEM) du Nexus 1000v comporte des commandes de débogage intégrées que vous pouvez utiliser pour faciliter le dépannage. Ces commandes vemlog vous permettent d'avoir une idée de ce que font certains processus du VEM, des commandes qu'ils envoient et du type de réponse qu'ils reçoivent. Par exemple, vous pouvez les utiliser dans les situations suivantes :

• Un canal de port LACP ne monte pas entre le commutateur Nexus 1000v et le commutateur en amont. Vous utiliseriez une combinaison de “ ” vemlog sur l'hôte et “ ” de débogage sur le commutateur en amont pour résoudre le problème.

• QoS ne fonctionne pas correctement et vous voulez vérifier que le VEM définit correctement les valeurs.

• Vous voulez voir les modifications apportées à la communication VSM-VEM.

Le cas d'utilisation le plus courant pour exécuter ces commandes est le débogage de LACP. En utilisant les modules debug « sflacp » et « debug lacp » sur le commutateur en amont, vous pouvez détecter quel périphérique est défectueux, ou si la liaison entre les deux périphériques est en train de supprimer les BPDU LACP.

Les niveaux par défaut ont généralement assez d'informations pour que le journal puisse être collecté et analysé sans activer de débogages supplémentaires.

Conditions préalables

Conditions requises

Aucune spécification déterminée n'est requise pour ce document.

Components Used

Ce document n'est pas limité à des versions de matériel et de logiciel spécifiques.

Conventions

Pour plus d'informations sur les conventions utilisées dans ce document, reportez-vous à Conventions relatives aux conseils techniques Cisco.

Exécution des commandes vemlog

Si vous avez des questions sur la syntaxe de ces commandes, vous pouvez taper “ vemlog ” dans l'interface de ligne de commande ESXi et recevoir une sortie d'aide. Aucun onglet n'est terminé ou « ? » pour ces commandes. Vous devez les taper complètement ou ils ne fonctionneront pas correctement. Pour exécuter les commandes vemlog, vous devez utiliser l'une des commandes suivantes :

• Accès par console SSH/local à l’hôte ESXi en question. L'accès SSH est préférable car vous pouvez facilement faire défiler vers le haut.

• L'accès à la console SSH/locale au VSM et le module doit être actif dans le VSM. Encore une fois, l'accès SSH est préférable. Si vous utilisez cette méthode, vous devez préfacer chaque commande avec module vem # execute, où # est le numéro de module du VEM.

Niveaux de débogage du journal virtuel

Vemlog sur le VEM est similaire au Syslog sur un commutateur normal. Comme un commutateur normal, il existe des niveaux de gravité :

e – Error 
n – Notification
w – Warning
i – Information
d – Debug
p – Print
t – Temporary

Cette valeur est classée de la plus grave au moins (les messages les moins sévères étant beaucoup plus nombreux). Par défaut, le vemlog est défini sur ENW (Erreur, Notification, Avertissement).

Étape 1 : Effacement des paramètres de capture actuels

Pour résoudre un problème particulier, il est utile de désactiver les captures par défaut.

vemlog stop
vemlog clear
vemlog debug all none

Ces commandes arrêtent toutes les commandes vemlog actuelles qui se produisent et réinitialisent les paramètres de capture vierges. Vous pouvez le vérifier à l'aide de la commande suivante :

Comme vous le voyez ici, la commande vemlog show debug affiche les paramètres de débogage actuels. La valeur par défaut de tous les modules pour “ Impression ” est 0 ou non.

Étape 2 : Définition des paramètres de capture du journal virtuel

Maintenant que vous avez une ardoise propre à commencer, il est temps de configurer les cookies pour la capture. Pour cet exemple, les journaux de port généraux sont capturés :

La deuxième commande présente la syntaxe suivante :

vemlog debug [module|all] [-][all|none|default|e|w|n|i|d|p|t]

Où “ debug_module ” est le paquet vemlog que vous voulez capturer. Généralement, “ ” de débogage est suffisant pour le dépannage.

Si vous ajoutez [-] à la commande, le niveau de débogage sera supprimé pour ce module. Cette capture d'écran présente des exemples de ceci :

Vous pouvez afficher tous les modules de débogage disponibles avec une commande vemlog show debug.

Une fois que vous avez spécifié les packages à surveiller, démarrez le vemlog avec une commande vemlog start :

Étape 3 : Affichage du résultat

Une fois que vous êtes prêt à afficher le journal, émettez une commande vemlog show all. Cela imprime toutes les entrées du journal sur la console (ou la session SSH). Si vous êtes directement connecté à l'hôte, vous pouvez également l'envoyer à un fichier afin de pouvoir le copier et l'analyser ultérieurement :

Si vous déplacez ce fichier vers le répertoire /vmfs/volumes/[datastore_name], vous pouvez le déplacer de l'hôte à l'aide du navigateur de data store dans ESXi.

Le vemlog est également stocké dans le journal vmkernel.

Étape 4 : Restauration des niveaux de journalisation normaux du journal virtuel

~ # vemlog stop
Suspended log
~ # vemlog clear
Cleared log
~ # vemlog debug all default
~ # vemlog start
Started log

Ces commandes restaureront la configuration standard du journal virtuel. Ceci est important pour s'assurer que les informations de débogage sont capturées correctement pour les problèmes futurs.

Comme le vemlog est stocké à la fois dans les journaux vmkernel et dans la mémoire tampon de vemlog, un débogage particulièrement chatty peut inonder ces deux fichiers d'informations inutiles, surtout s'ils sont laissés activés.

Informations connexes

• Support et documentation techniques - Cisco Systems

Revision History