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 FATAL est le niveau le moins détaillé. 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 TRACE est le niveau le plus détaillé. 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. Localisez la section Default vCloud loggers et modifiez le niveau de journalisation des enregistreurs.
    L'exemple suivant montre le niveau de journal défini sur le niveau le plus détaillé. 
    log4j.logger.com.vmware.vcloud=TRACE 
log4j.logger.com.vmware.ssdc=TRACE
  4. 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.
  5. 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.
    L'exemple suivant modifie la ligne pour correspondre au niveau le plus détaillé. 
    log4j.appender.vcloud.system.debug.threshold=TRACE
  6. 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.
  7. 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.

Contrôler la journalisation des demandes d'API dans VMware Cloud Director

Vous pouvez contrôler le processus de capture et de stockage des informations sur les demandes entrantes dans VMware Cloud Director.

VMware Cloud Director consigne les demandes entrantes envoyées aux cellules VMware Cloud Director dans des journaux de demandes. Les journaux ont des noms au format AAAA_MM_JJ.request.log. Vous trouverez les fichiers VMware Cloud Director request.log dans le répertoire /opt/vmware/vcloud-director/logs/, mais vous ne pouvez pas configurer les journaux via le fichier log4j.properties.

Vous pouvez utiliser la sous-commande manage-config de l'outil de ligne de commande pour contrôler la journalisation des demandes d'API. La sous-commande manage-config modifie les paramètres de l'ensemble du groupe de serveurs. Pour plus d'informations sur les options et les arguments de la sous-commande manage-config, reportez-vous à la section Mise à jour des paramètres de configuration des applications dans VMware Cloud Director.

La rotation des journaux peut se produire au maximum une fois par jour et n'est pas liée à la taille des fichiers journaux individuels ou à la taille totale de tous les fichiers journaux. Vous pouvez contrôler la stratégie de rotation en modifiant le nombre de jours pendant lesquels VMware Cloud Director conserve les journaux.

Procédure

  1. Connectez-vous, directement ou à l'aide d'un client SSH, au système d'exploitation de la cellule VMware Cloud Director en tant qu'utilisateur racine.
  2. Si vous souhaitez modifier la stratégie de rétention des journaux de demandes, utilisez la sous-commande manage-config de l'outil de gestion des cellules.
    La valeur de la stratégie de rétention représente le nombre de jours pendant lesquels VMware Cloud Director conserve le journal de demandes conforme au NCSA (National Center for Supercomputing Applications). La valeur par défaut est 0, où 0 signifie indéfiniment. La suppression de la valeur entraîne également la conservation indéfinie des journaux. La durée minimale pendant laquelle vous pouvez conserver les journaux est de 1 jour. 
    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config --name "vcloud.http.log.retainDays" --value New_Value
  3. Pour que les modifications prennent effet, vous devez redémarrer les cellules.
    Une fois que vous redémarrez une cellule, elle commence à utiliser la valeur mise à jour. Vous pouvez redémarrer une partie des cellules ou toutes les cellules à la fois.