Traçage activé
Vue d’ensemble
La collecte de journaux et la reproduction des problèmes ralentissent les diagnostics et dégradent l’expérience utilisateur. La fonction de traçage facilite ces efforts. Par défaut, le traçage est activé pour le Linux VDA.
Configuration
Le démon ctxlogd
et l’utilitaire setlog
sont maintenant inclus dans le package du Linux VDA. Par défaut, le démon ctxlogd
démarre après l’installation et la configuration du Linux VDA.
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 Linux VDA 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 racine est autorisé à l’exécuter. Vous pouvez utiliser l’interface utilisateur ou exécuter des commandes pour afficher et modifier les configurations. Pour obtenir de l’aide sur l’utilitaire setlog
, exécutez la commande suivante :
setlog help
<!--NeedCopy-->
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 valeurs setlog
actuelles :
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
<!--NeedCopy-->
Afficher ou définir une valeur setlog
unique :
setlog value <name> [<value>]
<!--NeedCopy-->
Par exemple :
setlog value log_size 100
<!--NeedCopy-->
Niveaux
Par défaut, les niveaux de journalisation sont définis sur warning (non sensibles à la casse).
Pour afficher les niveaux de journalisation définis pour différents composants, exécutez la commande suivante :
setlog levels
<!--NeedCopy-->
Pour définir tous les niveaux de journalisation (y compris Disabled, Inherited, Verbose, Information, Warnings, Errors, et Fatal Errors), exécutez la commande suivante :
setlog level <class> [<level>]
<!--NeedCopy-->
Niveau de journalisation | Paramètre de commande (non sensible à la casse) |
---|---|
Désactivé | aucun |
Inherited | inherit |
Verbose | verbose |
Information | info |
Warnings | warning |
Errors | error |
Fatal Errors | fatal |
La variable <class>
spécifie un composant de l’agent Linux VDA. Pour couvrir tous les composants, définissez-la sur « all » : Par exemple :
setlog level all error
<!--NeedCopy-->
Indicateurs
Par défaut, les indicateurs sont définis comme suit :
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
<!--NeedCopy-->
Afficher les indicateurs actuels :
setlog flags
<!--NeedCopy-->
Afficher ou définir un indicateur de journalisation unique :
setlog flag <flag> [<state>]
<!--NeedCopy-->
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 :
setlog default
<!--NeedCopy-->
Important :
Le service
ctxlogd
est configuré à l’aide du fichier /var/xdl/.ctxlog, que seuls les utilisateurs root peuvent créer. Les autres utilisateurs ne disposent pas d’un accès en écriture à ce fichier. Nous recommandons 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 malveillante, 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 (s’il a été supprimé accidentellement par exemple).
/var/log/messages :
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.
<!--NeedCopy-->
Pour résoudre ce problème, exécutez setlog
en tant qu’utilisateur racine pour créer le fichier /var/xdl/.ctxlog. Redémarrez le service ctxlogd
dont dépendent d’autres services.