Gestion des traces : Objectif et généralités
Objectif
Les traces permettent d’enregistrer l’ensemble du travail effectué par les produits (exécutable) composant Retail Y2, en fonction d’un niveau.
Par défaut, les fichiers traces contiennent notamment : un niveau d’erreur prédéfini, le répertoire de leur enregistrement, le nombre et la taille du fichier, etc.
Les informations sont classées en fonction des différents niveaux.
Afin de comprendre une erreur ou un comportement des applicatifs, les traces apportent des informations nécessaires pour les diagnostiquer.
Il est difficile d’aiguiller en fonction du message d’erreur ou d’un comportement que telle ou telle trace doit être activée et leurs niveaux. La situation s’apprécie à chaque fois. L’expérience et la connaissance permettent de privilégier telle trace avec tel niveau.
Cette rubrique aborde les sujets suivants :
Généralités sur les traces,
Les fichiers des traces Delphi et .Net pour les paramétrer en manuel ou via un outil,
Les options paramétrables des traces (Activation, Niveau des traces, Catégories, CPOS, etc.),
Stockages des traces partie cliente et des traces partie serveur,
Comment exploiter les traces, quel historique transmettre, comment rechercher une erreur, quel lien entre les traces DELPHI et .NET remontées par la Webapp, etc.
Attention !
Toute modification des fichiers doit être faite en connaissance. Avant toute modification de fichiers, il est fortement recommandé de copier ces derniers dans un autre répertoire afin de pouvoir revenir à l’état initial facilement. Ne pas renommer le fichier d’origine dans son répertoire.
Attention ! La prise en compte des modifications des options des fichiers traces nécessite :
Pour les parties clientes, de fermer l’application et de relancer de nouveau cette dernière.
Pour les traces WebApp du serveur IIS, un arrêt redémarrage du serveur IIS.
Pour les traces liées aux tâches planifiées, l’arrêt et le démarrage de la tâche Windows liée aux tâches.
Pour les traces liées au serveur d’impression, l’arrêt et le démarrage de la tâche Windows liée au serveur d’impression.
Pour les traces du Workerprocess, il faut redémarrer le service CegidRetailProcessLaunche associé.
Si plusieurs serveurs sont concernés, l’opération doit s’effectuer sur chacun d’eux.
Généralités
La gamme Retail Y2 se compose notamment de deux types d’exécutables utilisant des langages de programmation différents. C’est pourquoi les traces se gèrent à deux niveaux : Traces Delphi et Traces .Net.
Un fichier trace contient les paramétrages pour exécuter et sauvegarder les traces.
Lors de l’installation de Retail Y2, les traces sont paramétrées par défaut.
Par défaut, les traces Delphi sont redirigées dans le log des traces .NET en respectant la verbosité choisie dans la configuration des traces .NET.
Par exemple, soit :
Fichier de trace DELPHI a un niveau "4" (errorlevel="4")
Fichier .NET a un niveau "Warning" (level="Warning"),
Les traces DELPHI seront du niveau équivalent à celui du .NET c’est-à-dire "2".
Attention !
Le niveau de traces a un impact sur la performance pour le client. Cette remarque est aussi vraie pour les traitements tracés sur les serveurs IIS, de tâches et d’impression.