VMware Cloud Director a des niveaux de journalisation différents. La configuration de la journalisation par défaut peut ne pas être suffisante pour les environnements très actifs ou pour la capture d'événements lors du dépannage. Vous devrez peut-être modifier le niveau de journalisation et même la taille et le nombre de fichiers conservés.

Important : Assurez-vous de bien connaître les conséquences sur votre groupe de serveurs VMware Cloud Director lorsque vous apportez des modifications à la configuration des journaux sans l'assistance de l'équipe de support global VMware. Si vous modifiez un niveau de journalisation en un niveau plus détaillé, la taille des journaux peut augmenter très rapidement et votre environnement VMware Cloud Director peut manquer d'espace disque.

Les journaux VMware Cloud Director se trouvent dans le répertoire /opt/vmware/vcloud-director/logs/.

Le fichier de configuration des journaux VMware Cloud Director se trouve dans le répertoire /opt/vmware/vcloud-director/etc/. Le nom du fichier de configuration du journal est log4j.properties.

Si vous personnalisez le fichier de configuration du journal log4j.properties, avant une mise à niveau de VMware Cloud Director, vous devez faire une copie de log4j.properties et, après la mise à niveau, insérer manuellement toutes les sections manquantes.

Pour améliorer la conservation des journaux et vous assurer que les journaux VMware Cloud Director sont conservés pendant un certain temps, envisagez d'utiliser un serveur Syslog.

Tableau 1. Niveaux de journalisation
niveau de journalisation Description
FATAL Ce niveau enregistre les événements d'erreur très graves qui peuvent entraîner l'échec de l'application.
ERROR Ce niveau enregistre les événements d'erreur qui peuvent toujours permettre l'exécution de l'application.
WARN Ce niveau enregistre les situations et les avertissements potentiellement dangereux.
INFO Ce niveau enregistre des messages informatifs qui mettent en évidence la progression de l'application à un niveau peu détaillé.
DEBUG Ce niveau enregistre les événements informatifs les plus utiles pour déboguer une application à un niveau détaillé.
TRACE Ce niveau enregistre les événements informatifs à un niveau plus précis que la journalisation du niveau DEBUG.

Conditions préalables

Effectuez une copie de sauvegarde du fichier /opt/vmware/vcloud-director/etc/log4j.properties.

Considérer

Procédure

  1. Connectez-vous directement ou à l'aide d'un client SSH à la console de VMware Cloud Director en tant qu'utilisateur racine.
  2. Ouvrez le fichier /opt/vmware/vcloud-director/etc/log4j.properties dans un éditeur de texte.
  3. Recherchez la définition du fichier journal que vous souhaitez mettre à jour. 
    log4j.appender.Feature.File=logs/File_Name
    Par exemple, vous pouvez modifier le niveau de journalisation de la section # Component appender for container debug. La dernière ligne de la section configure le niveau de journalisation capturé par le fichier.
  4. Définissez le niveau de journalisation sur la valeur souhaitée.
    Important : Assurez-vous de bien connaître les conséquences sur votre groupe de serveurs VMware Cloud Director lorsque vous apportez des modifications à la configuration des journaux sans l'assistance de l'équipe de support global VMware.
    TRACE est le niveau le plus détaillé et FATAL est le niveau le moins détaillé. L'exemple suivant modifie la ligne pour correspondre au niveau le plus détaillé. 
    log4j.appender.vcloud.system.debug.threshold=TRACE
  5. Si vous passez l'enregistrement à un niveau plus détaillé, vous devrez peut-être augmenter le nombre de sauvegardes de journaux et la taille des fichiers journaux.
    1. Recherchez les lignes MaxFileSize et MaxBackupIndex. 
      log4j.appender.vcloud.system.debug.MaxFileSize=
      log4j.appender.vcloud.system.debug.MaxBackupIndex=
    2. Modifiez les paramètres par défaut.
      Par exemple, si vous souhaitez que les fichiers journaux atteignent 50 Mo avant leur rotation et conserver les 18 derniers journaux, modifiez les lignes comme suit. 
      log4j.appender.vcloud.system.debug.MaxFileSize=50000KB
      log4j.appender.vcloud.system.debug.MaxBackupIndex=18
      Lorsqu'un fichier atteint la taille sélectionnée de 50 Mo, VMware Cloud Director continue d'enregistrer les données dans un nouveau fichier et conserve jusqu'à 18 sauvegardes.
    Important : Si vous modifiez un niveau de journalisation en un niveau plus détaillé, la taille des journaux peut augmenter très rapidement et votre environnement VMware Cloud Director peut manquer d'espace disque.
  6. Enregistrez le fichier /opt/vmware/vcloud-director/etc/log4j.properties.
    VMware Cloud Director applique les modifications immédiatement. Le fichier Log4J.properties n'a pas de lignes explicites pour modifier la taille et la quantité de journaux que VMware Cloud Director conserve.