Table of Contents
Suivi avancé
Sommaire → Serveur Rocrail → | Configuration
-
- Fichier de suivi avancé
Dans des cas spéciaux, plus d'options de protocole que le standard peuvent être nécessaires pour aider l'administrateur.
Une part de ces options ne sont pas modifiables par une fenêtre de dialogue et ne s'adressent qu'aux experts.
Description XML: http://www.rocrail.net/doc/rocrail-wrappers/wrapper-en.html#trace
Options
Ces attributs peuvent être utilisé dans le nœud <trace…/> du fichier rocrail.ini.
Option | Par défaut | Description |
---|---|---|
protpath | . | Chemin du protocole; Où écrire les fichiers de suivi. (Utiliser les chemins relatifs seulement si vous utilisez le service http.) Le chemin est relatif pour pwd¹! |
unique | faux | Créer un fichier de suivi unique au démarrage. |
size | 100 | Taille des fichiers de suivi en KB. |
nr | 10 | Nombre de fichiers de suivi. En cas de valeur 0 ou 1: Tous les suivis sont écrits dans un seul fichier sans prendre en compte la taille du fichier. |
exceptionfile | faux | Créer un fichier supplémentaire pour les exceptions. |
invoke | ./xmail.pl | Programme externe ou script à invoquer à la création du fichier d'exception. |
invokeasync | faux | L'appel aura lieu dans un thread séparé. |
dumpsize | 128 | Taille en octect du vidage. |
¹) pwd = répertoire de travail du processus
Unique
Pour éviter l'écrasement des suivis existants, au cas ou il ne serait pas facile de trouver le problème, ce drapeau veillera à ce que les fichiers de suivi obtiennent toujours un nom de fichier unique.
Invoke
L'option invoke, en conjonction avec exceptionfile, fournit un mécanisme pour notifier à quelqu'un ou à quelque chose la première exception écrite dans le fichier d'exception nouvellement créé.
Après l'examen de ce fichier d'exception il peut être déplacé ou effacé pour obtenir n nouvel événement déclencheur lorsqu'une exception est déclenchée. (si voulu.)
Le script ou le programme invoqué est défini par l'utilisateur, mais le programme externe peut bloquer le serveur Rocrail il est recommandé de définir le invokeasync à true pour éviter cela.
xmail.pl
L'exemple de script Perl qui enverra un courriel en cas de création du fichier d'exception:
#!/usr/bin/perl require 5.000; $mailaddr = $ARGV[0]; open(SENDMAIL, "| /usr/sbin/sendmail -t -n") || die "Unable to open sendmail"; print SENDMAIL "From: Rocrail\n"; print SENDMAIL "To: $mailaddr\n"; print SENDMAIL "Reply-To: Rocrail\n"; print SENDMAIL "Subject: Exception file created.\n"; print SENDMAIL "This email is sended to notify you because an exception file is created.\n"; close(SENDMAIL);
Valeurs du niveau
TRCLEVEL_EXCEPTION=0x0001 ,TRCLEVEL_INFO =0x0002 ,TRCLEVEL_WARNING =0x0004 ,TRCLEVEL_DEBUG =0x0008, TRCLEVEL_BYTE =0x0010 ,TRCLEVEL_METHOD =0x0020 ,TRCLEVEL_MEMORY =0x0040 ,TRCLEVEL_PARAM =0x0080, TRCLEVEL_PROTOCOL =0x0100 ,TRCLEVEL_ERROR =0x0200 ,TRCLEVEL_PARSE =0x0400 ,TRCLEVEL_WRAPPER =0x0800, TRCLEVEL_USER1 =0x1000 ,TRCLEVEL_USER2 =0x2000 ,TRCLEVEL_MONITOR =0x4000 ,TRCLEVEL_XMLH =0x8000, TRCLEVEL_USER =0xF000 ,TRCLEVEL_CALC =0x10000 ,TRCLEVEL_STATUS =0x20000 ,TRCLEVEL_XMLSCRIPT=0x40000, TRCLEVEL_FIND =0x80000,TRCLEVEL_CLNTCON=0x100000,TRCLEVEL_ROUTER =0x200000,TRCLEVEL_ALL =0xFFFFFF