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 pouvez définir la journalisation détaillée pour les journaux vpxd.

Procédure

  1. Sélectionnez une instance de vCenter Server.
  2. Cliquez sur l'onglet Configurer.
  3. Cliquez sur Général puis, dans les paramètres du système vCenter Server, cliquez sur MODIFIER.
  4. Dans la fenêtre Modifier les paramètres généraux de vCenter, cliquez sur Paramètres de journalisation et sélectionnez détaillé dans le menu déroulant Niveau de journal.
  5. Cliquez sur ENREGISTRER.

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/vmware.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.
Quick Boot /var/log/loadESX.log Contient tous les événements liés au redémarrage d'un hôte ESXi via Quick Boot.
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.

À partir de vSphere 7.0 Update 2, vous pouvez ajouter des filtres de journaux et activer le filtrage des journaux à l'aide d'ESXCLI. Un filtre de journal, une fois établi, reste en place jusqu'à ce qu'il soit supprimé, même en cas de redémarrage d'ESXi.

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

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.

Les commandes ESXCLI pour configurer les filtres de journaux suivent ce modèle : esxcli system syslog config logfilter {cmd} [cmd options].

Par exemple, pour obtenir la liste des filtres de journaux disponibles, exécutez la commande suivante : [root@xxx-xx-dhcp-xx-xx:~] esxcli system syslog config logfilter list.

Utilisez la commande set pour activer ou désactiver le filtrage de journaux : [root@xxx-xx-dhcp-xx-xx:~] esxcli system syslog config logfilter set.

Utilisez la commande add pour ajouter un filtre de journal et la commande remove pour supprimer un filtre de journal.

Utilisez la commande get pour déterminer si le filtrage des journaux est activé.

Un filtre de journal est spécifié par trois composantes et utilise la syntaxe suivante : numLogs | ident | logRegexp.

Paramètre Description
numLogs Spécifie le nombre de correspondances de l'expression régulière logRegexp Python qui sera autorisé avant le début du filtrage.
ident

La chaîne ident correspond à la manière dont une application s'identifie auprès de l'infrastructure Syslog. Le filtre logRegexp doit être associé à la même application. Vous pouvez trouver la chaîne ident d'une application en inspectant les fichiers journaux dans /var/run/log. Le troisième champ de chaque fichier journal commence par la chaîne ident et se termine par [.

logRegexp Expression régulière Python qui identifie les messages que vous souhaitez filtrer.

Par exemple, pour filtrer tous les messages du démon hostd qui contiennent le mot « mark » après la dixième occurrence, utilisez la commande suivante : esxcli system syslog config logfilter add --filter="10|Hostd|mark".

Pour supprimer le filtre de journal, utilisez la commande esxcli system syslog config logfilter remove --filter="10|Hostd|mark".

Pour plus d'informations, reportez-vous à la section Options Syslog d'ESXi.

Conditions préalables

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.

Installez ESXCLI. Reportez-vous à la section Démarrage avec ESXCLI. Pour le dépannage, exécutez les commandes esxcli dans ESXi Shell.

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.