Le support technique de VMware pourra vous demander plusieurs fichiers pour l'aider à résoudre les problèmes techniques. Les sections suivantes décrivent les processus de script permettant de générer et de récupérer certains de ces fichiers.

Définir la journalisation détaillée

Vous pouvez définir la spécification de journalisation détaillée.

Vous ne pouvez définir la journalisation détaillée que pour les journaux vpxd.

Procédure

  1. Sélectionnez Administration > Paramètres vCenter Server.
  2. Sélectionnez Options journalisation.
  3. Sélectionnez Commentaires dans le menu instantané.
  4. Cliquez sur OK.

Collecter les fichiers journaux de vSphere

Vous pouvez collecter les fichiers journaux de vSphere dans un emplacement unique.

Vous pouvez télécharger le bundle de journaux à partir du vSphere Client connecté à un système vCenter Server.

Procédure

  1. Dans le menu du vSphere Client, sélectionnez Administration > Déploiement > Configuration système.
  2. Sélectionnez un nœud vCenter Server et cliquez sur Exporter le bundle de support.
  3. Sélectionnez le type de bundle de support :
    • Bundle de support complet : contient des informations sur tous les services.
    • Bundle de support minimal : contient des informations de base sur le produit et la configuration.
    • Bundle de support personnalisé : contient des informations personnalisées. Sélectionnez l'une des propriétés du manifeste pour télécharger les fichiers journaux correspondants.
  4. Cliquez sur EXPORTER.
  5. (Facultatif) Vous pouvez également télécharger le bundle de journaux vCenter à l’aide d’une autre méthode :
    1. Cliquez avec le bouton droit sur l'instance vCenter Server, puis cliquez sur Actions > Exporter les journaux système....
    2. Cliquez sur Sélectionner des hôtes pour placer les journaux d'hôtes sélectionnés dans un bundle d'exportation. Cochez la case Inclure les journaux de client d'interface utilisateur vCenter Server et vSphere pour inclure, si vous le souhaitez, les journaux d'interface utilisateur vCenter Server et vSphere dans le bundle. Cliquez sur SUIVANT.
    3. Cliquez sur Sélectionner les journaux pour sélectionner des journaux système spécifiques à exporter. Cliquez sur EXPORTER LES JOURNAUX.
    Note : La liasse de journaux est générée sous la forme d'un fichier .zip. Par défaut, les journaux vpxd de la liasse sont compressés en fichiers .tgz. Vous devez utiliser gunzip pour décompresser ces fichiers.

Recueillir les fichiers journaux ESXi

Vous pouvez récupérer et rassembler toutes les informations pertinentes sur le système et la configuration ESXi, ainsi que les fichiers journaux ESXi. Ces informations peuvent être utiles pour analyser les problèmes.

Procédure

  • ♦ Exécutez le script suivant sur ESXi Shell : /usr/bin/vm-support
    Le fichier qui en résulte est au format suivant : esx-date-unique-xnumber.tgz

Emplacements des fichiers journaux ESXi

ESXi enregistre l'activité de l'hôte dans des fichiers journaux en utilisant un outil syslog.

Tableau 1. Emplacements des fichiers journaux ESXi
Composant Emplacement Objectif
Authentification /var/log/auth.log Contient tous les événements relatifs à l'authentification pour le système local.
Journal de l'agent hôte ESXi /var/log/hostd.log Contient des informations sur l'agent gérant et configurant les hôtes ESXi et leurs machines virtuelles.
Journal du shell /var/log/shell.log Contient un enregistrement de toutes les commandes tapées dans ESXi Shell et les événements de shell (par exemple, le moment où le shell a été activé).
Messages système /var/log/syslog.log Contient tous les messages généraux du journal et peut être utilisé en cas de dépannage. Ces informations étaient précédemment situées dans le fichier journal des messages.
Journal de l'agent vCenter Server /var/log/vpxa.log Contient des informations sur l'agent communiquant avec vCenter Server (si l'hôte est géré par vCenter Server).
Machines virtuelles Le même répertoire que les fichiers de configuration de la machine virtuelle, appelés vmware.log et vmware*.log. Par exemple, /vmfs/volumes/datastore/virtual machine/vwmare.log Contient les événements d'alimentation de la machine virtuelle, les informations relatives aux défaillances système, la synchronisation horaire, les modifications virtuelles du matériel, les migrations vMotion, les clones de machines, etc.
VMkernel /var/log/vmkernel.log Enregistre les activités relatives aux machines virtuelles et à ESXi.
Résumé VMkernel /var/log/vmksummary.log Utilisé pour déterminer les statistiques de temps de fonctionnement et de disponibilité pourESXi (virgule séparée).
Avertissements VMkernel /var/log/vmkwarning.log Enregistre les activités relatives aux machines virtuelles.
Démarrage rapide /var/log/loadESX.log Contient tous les événements liés au redémarrage d'un hôte ESXi via le démarrage rapide.
Agent d'infrastructure approuvé /var/run/log/kmxa.log Enregistre les activités liées au service client sur l'hôte approuvé ESXi.
Service de fournisseur de clés /var/run/log/kmxd.log Enregistre les activités liées au service de fournisseur de clés de vSphere Trust Authority.
Service d'attestation /var/run/log/attestd.log Enregistre les activités liées au service d'attestation de vSphere Trust Authority.
Service de jeton ESX /var/run/log/esxtokend.log Enregistre les activités liées au service de jeton ESX de vSphere Trust Authority.
Redirecteur d'API ESX /var/run/log/esxapiadapter.log Enregistre les activités liées au redirecteur d'API de vSphere Trust Authority.

Configurer le filtrage de journaux sur les hôtes ESXi

La fonctionnalité de filtrage de journaux vous permet de modifier la stratégie de journalisation du service syslog exécutée sur un hôte ESXi. Vous pouvez créer des filtres de journaux pour réduire le nombre d'entrées répétitives dans les journaux ESXi et inscrire des événements de journal spécifiques sur la liste d'exclusion.

Les filtres de journaux affectent les événements de journaux traités par le programme fantôme vmsyslogd de l'hôte ESXi, qu'ils soient inscrits dans un répertoire journal ou sur un serveur syslog distant.

Lorsque vous créez un filtre de journal, vous définissez un nombre maximal d’entrées de journal pour les messages de journaux. Les messages de journaux sont générés par un ou plusieurs composants système spécifiés et qui correspondent à une phrase spécifiée. Il vous faut activer la fonctionnalité de filtrage de journaux et recharger le programme fantôme syslog pour activer les filtres de journaux sur l'hôte ESXi.
Important : La définition d’une limite quant à la quantité d’informations de journalisation restreint votre capacité à résoudre correctement les éventuelles pannes du système. Si une rotation des fichiers de journaux se produit une fois le nombre maximum d'entrées atteint, vous pourriez perdre toutes les instances d'un message filtré.

Procédure

  1. Connectez-vous au shell ESXi en tant qu'utilisateur racine.
  2. Dans le fichier /etc/vmware/logfilters, ajoutez l'entrée suivante pour créer un filtre de journal. 
    numLogs | ident | logRegexp
    où :
    • numLogs définit le nombre maximum d'entrées pour les messages de journaux spécifiés. Une fois ce nombre atteint, les messages de journaux spécifiés sont filtrés et ignorés. Utilisez 0 pour filtrer et ignorer tous les messages de journaux spécifiés.
    • ident spécifie un ou plusieurs composants système dont les messages de journaux générés seront traités par le filtre. Pour plus d’informations sur les composants du système qui génèrent des messages de journal, consultez les valeurs des paramètres idents dans les fichiers de configuration syslog. Les fichiers se trouvent dans le répertoire /etc/vmsyslog.conf.d. Utilisez une liste d'éléments séparés par une virgule pour appliquer un filtre à plusieurs composants système. Utilisez * pour appliquer un filtre à tous les composants système.
    • logRegexp spécifie une phrase sensible à la casse avec une syntaxe d'expression Python standard pour filtrer les messages de journaux selon leur contenu.
    Par exemple, pour définir une limite du nombre maximal d’entrées à partir du composant hostd pour les messages qui ressemblent à la phrase Échec de connexion de SOCKET, erreur 2 : Aucun fichier ou répertoire de ce type avec n’importe quel numéro d’erreur, ajoutez l’entrée suivante : 
    2 | hostd | SOCKET connect failed, error .*: No such file or directory
    Note : Une ligne commençant par # indique un commentaire et est ignorée.
  3. Dans le fichier /etc/vmsyslog.conf, ajoutez l'entrée suivante pour activer la fonctionnalité de filtrage de journaux. 
    enable_logfilters = true
  4. Exécutez la commande esxcli system syslog reload pour recharger le programme fantôme syslog et appliquer les modifications de configuration.

Désactiver la compression des fichiers journaux vpxd

Par défaut, les fichiers journaux vpxd de vCenter Server sont cumulés et compressés en fichiers .gz. Vous pouvez désactiver ce paramètre pour laisser les journaux vpxd non compressés.

Procédure

  1. Connectez-vous à vCenter Server en utilisant vSphere Client.
  2. Sélectionnez Administration > Paramètres vCenter Server.
  3. Sélectionnez Paramètres avancés.
  4. Dans le champ Clé, tapez log.compressOnRoll.
  5. Dans le champ Valeur, tapez faux.
  6. Cliquez sur Ajouter, puis sur OK.

Fichiers VMkernel ESXi

Si le noyau VMkernel se met en défaut, un message d'erreur apparaît, puis la machine virtuelle redémarre. Si vous avez désigné une partition de vidage de mémoire VMware quand vous avez configuré votre machine virtuelle, le noyau VMkernel génère également un vidage de mémoire et un journal d'erreurs.

Des problèmes plus graves dans le noyau VMkernel peuvent figer la machine sans message d'erreur ni vidage de mémoire.