Linux Virtual Delivery Agent 2201

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.

Traçage activé