S’applique à :
- Winshuttle Foundation
AddLogging
L'opération Error Log de l'outil SVAdm permet d'enregistrer l'exécution du produit sur le serveur. La journalisation système peut être utile pour suivre les performances et les erreurs système.
Par défaut, les fichiers journaux (Sharevis.log) sont stockés dans le répertoire ..\Program Files\Winshuttle Workflow\logs.
Le niveau de journalisation le plus courant est Info. Les autres niveaux de journalisation sont Débogage, Avertissement et Erreur. En cas d'exceptions, si le niveau de journalisation n'est pas Erreur, cela implique que l'exception était attendue par le système et qu'elle peut être ignorée. Si le niveau de journalisation est Erreur, il s'agit d'une exception inattendue et cela indique que la condition était une exception réelle dans le système.
Conseil : si vous tentez de suivre une erreur, répliquez-la pendant que la journalisation est active, puis accédez à \Program Files\ShareVis\logs et consultez le fichier sharevis.log pour la vérifier.
Remarque : certaines exceptions sont normales lors de l’exécution de Workflow. Pour déterminer si une exception est attendue ou non, identifiez le niveau de journalisation vers le début de la ligne de journalisation.
Types de journalisation
Type |
Description |
Core |
Type de journalisation par défaut. Consigne les tâches internes du produit qui s’exécute dans le contexte de SharePoint. La journalisation Core est le journal général utilisé pour résoudre la majorité des problèmes de fonctionnement dans l’environnement Workflow. |
Minuteur |
Il s’agit du journal utilisé pour résoudre les problèmes fonctionnels liés au service de minuterie des workflows. Les marques dans le produit de base peuvent être utiles pour résoudre les problèmes de performances. |
SVService |
Ce journal permet de résoudre les problèmes fonctionnels avec des notifications et des actions de workflow automatiques. |
SVAdm |
Cette journalisation consigne l’exécution des outils de ligne de commande Workflow Admin. |
Central Admin |
Cette journalisation consigne l’exécution du site Workflow Central Administration. |
Niveaux de détail de journal
Workflow prend en charge quatre niveaux de consignation :
Niveau |
Description |
Impact sur les performances du système |
Erreur |
Consigne la génération d'une exception grave |
Minimal |
Avertiseement |
Consigne les erreurs qui ne sont pas nécessairement irrémédiables Si le système détecte une condition inattendue, mais pas suffisamment grave pour générer une exception, la description de l'erreur est enregistrée dans le journal dans le niveau de journalisation Avertissement. Les erreurs sont également incluses à ce niveau. |
Bas |
Infos |
Suit les messages dans le code. Aucune composition de chaîne (et donc aucune donnée variable) n’est consignée à ce niveau. Les erreurs et les avertissements sont également inclus dans ce niveau. |
Élevé |
Déboguer |
Niveau de journalisation le plus détaillé. Inclut les données variables. Par conséquent la composition de chaîne est exécutée de manière intensive, ce qui peut déclencher des nettoyages plus fréquents de la mémoire, etc. Les erreurs, les avertissement et les messages d’information sont également inclus dans ce niveau. Ce niveau de journalisation a le plus fort impact sur les performances. |
Plus élevé |
Recherche dans les journaux
Pour rechercher aisément un niveau de journalisation avec un éditeur de texte, recherchez une barre verticale ("|") suivie immédiatement du nom de niveau de journalisation. Par exemple, si vous analysez un journal pour rechercher l'emplacement d'une erreur, recherchez « |Error ». Si vous n'obtenez pas de résultat, recherchez « |Warn » en notant que les exceptions interceptées et consignées sous le niveau Warn sont attendues et n'indiquent probablement pas la source de l'erreur.
Remarque : il est vivement conseillé de désactiver la journalisation dès que vous avez terminé, La laisser active impactera négativement les performances du système.
Activer la journalisation avec SVAdm
Pour activer le journal système/principal SVAdm, exécutez la commande suivante :
svadm -o addlogging
Nom |
Description |
-async |
Se connecte à une unité d’exécution différente afin de ne pas trop ralentir le système pour les utilisateurs. |
-classes |
Liste de classes séparées par une virgule à laquelle vous voulez limiter la journalisation. |
-clear |
Efface le fichier journal existant du type donné, s'il existe. |
-level |
Peut être DEBUG, INFO, WARN ou ERROR |
-stacktrace |
Inclut la trace de pile dans le fichier journal (ralentit davantage le système). |
-type |
Type de consignation. Peut être CORE, SVSERVICE, CA, SVADM ou TIMER. -Le type peut être abrégé sous la forme -t (voir les exemples, ci-dessous). |
-verbose |
Affiche des informations sur les fichiers de configuration de journalisation mis à jour. |
Des exemples de certaines de ces commandes peuvent aussi se trouver dans la section relative au démarrage d’un vidage.
Remarque : veillez à exécuter IISRESET si la commande le demande.
Exemples de commandes
svadm –o addlogging -t svservice (active la journalisation pour SVService)
svadm –o addlogging -t timer (active la journalisation pour le minuteur)