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
ctxlogdest 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,ctxlogdpeut ê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.