Product Documentation

Traçage activé

Feb 26, 2018

Généralités

La collecte de journaux et la reproduction des problèmes ralentissent les diagnostics et dégradent l’expérience utilisateur. Cette version offre une fonctionnalité de traçage afin de faciliter ces tâches. Par défaut, le traçage est activé pour le VDA Linux.

Configuration

Le démon ctxlogd et l'utilitaire setlog sont maintenant inclus dans le package du VDA Linux. Par défaut, le démon ctxlogd démarre après l'installation et la configuration du VDA Linux. 

Démon ctxlogd

Tous les autres services qui font l'objet d'un suivi dépendent du démon ctxlogd. Vous pouvez arrêter le démon ctxlogd si vous ne souhaitez pas que le VDA Linux fasse l'objet d'un suivi.

Utilitaire setlog

La fonctionnalité de traçage est configurée à l’aide de l'utilitaire setlog, qui se trouve sous /opt/Citrix/VDA/bin/. Seul l’utilisateur root est autorisé à l’exécuter. Vous pouvez utiliser l’interface utilisateur ou exécuter des commandes pour afficher et modifier les configurations. Exécutez la commande suivante pour obtenir de l'aide sur l'utilitaire setlog :

Commande Copier

$ setlog help

Valeurs

Par défaut, Log Output Path est défini sur /var/log/xdl/hdx.log, Max Log Size est défini sur 200 Mo, et vous pouvez enregistrer jusqu'à deux anciens fichiers journaux sous Log Output Path

Afficher les valeur actuelles de setlog :

Commande Copier

$ setlog values 

log_path (Log Output Path) = /var/log/xdl/hdx.log

log_size (Max Log Size (MiB)) = 200

log_count (Max Old Log Files) = 2

Afficher ou définir une seule valeur setlog :

Commande Copier

$ setlog value <name> [<value>]

Par exemple :

Commande Copier

$ setlog value log_size 100  

Niveaux

Par défaut, le niveau de journalisation est défini sur Warnings

Afficher les niveaux de journalisation définis pour différents composants :

Commande Copier

$ setlog levels  

Vous pouvez définir tous les niveaux de journalisation (y compris Disable, Inherited, Verbose, Information, Warnings, Errors, et Fatal Errors) avec la commande suivante :

Commande Copier

$ setlog level <class> [<level>]  

La variable spécifie un composant du Linux VDA. Pour couvrir tous les composants, définissez-la sur All :

Commande Copier

$ setlog level all error 

Résultat Copier

Setting log class ALL to ERROR. 

Indicateurs

Par défaut, les indicateurs sont définis comme suit :

Commande Copier

$ setlog flags

DATE = true

TIME = true

NAME = true

PID = true

TID = false

SID = true

UID = false

GID = false

CLASS = false

LEVEL = false

FUNC = true

FILE = false

Afficher les indicateurs actuels :

Commande Copier

$ setlog flags

Afficher ou définir un indicateur de journal unique :

Commande Copier

$ setlog flag <flag> [<state>]

Restaurer paramètres par défaut

Rétablir les paramètres par défaut de tous les niveaux, de tous les indicateurs et de toutes les valeurs :

Commande Copier

$ setlog default

Important

Le service ctxlogd est configuré à l’aide du fichier /var/xdl /.ctxlog, quei seuls les utilisateurs root peuvent créer. Les autres utilisateurs ne disposent pas d’un accès en écriture à ce fichier. Citrix recommande aux utilisateurs root de ne pas accorder l'accès en écriture à d’autres utilisateurs. Si cette consigne n'est pas respectée, ctxlogd peut être configuré de manière arbitraire ou maveillante, ce qui peut affecter les performances des serveurs et par conséquent l’expérience utilisateur.

Résolution des problèmes

Le démon ctxlogd échoue et vous ne pouvez pas redémarrer le service ctxlogd lorsque le fichier /var/xdl /.ctxlog est manquant (supprimé par accident, par exemple).

/var/log/messages : 

Erreur Copier

Apr 1 02:28:21 RH72 citrix-ctxlogd[17881]: Failed to open logging configuration file.

Apr 1 02:28:21 RH72 systemd: ctxlogd.service: main process exited, code=exited, status=1/FAILURE

Apr 1 02:28:21 RH72 systemd: Unit ctxlogd.service entered failed state.

Apr 1 02:28:21 RH72 systemd: ctxlogd.service failed.

Pour résoudre ce problème, exécutez setlog en tant qu’utilisateur root pour recréer le fichier /var/xdl /.ctxlog. Redémarrez le service ctxlogd dont dépendent d’autres services.