Linux Virtual Delivery Agent

Collecte de journaux

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.

Le 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.

L’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 du journal Paramètre de commande (non sensible à la casse)
Désactivé none
Inherited inherit
Détaillé détaillé
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 « tous ». 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.

Collecte de journaux

Vous pouvez exécuter la commande bash /opt/Citrix/VDA/bin/xdlcollect.sh pour collecter des journaux. Le script Bash xdlcollect utilisé pour collecter les journaux est intégré dans le logiciel Linux VDA et se trouve dans /opt/Citrix/VDA/bin.

Une fois la collecte des journaux terminée, un fichier journal compressé est généré dans le même dossier que le script. Le script Bash xdlcollect peut vous demander s’il faut charger le fichier journal compressé sur Citrix Insight Services (CIS). Si vous acceptez, xdlcollect renvoie upload_ID une fois le chargement terminé. Le téléchargement ne supprime pas le fichier journal compressé de votre machine locale. Les autres utilisateurs peuvent utiliser upload_ID pour accéder au fichier journal dans CIS.

Dépannage

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.

Collecte de journaux