Table of Contents
Erweiterte Traces
Inhalt → Rocrail-Server → | Konfiguration
-
- Erweiterte Traces
In speziellen Fällen werden ggf. über den Standard hinaus mehr Protokollmöglichkeiten benötigt, um dem Administrator zu helfen.
Ein Teil dieser Optionen ist nicht durch Dialoge änderbar und nur für Experten.
XML-Beschreibung: http://www.rocrail.net/doc/rocrail-wrappers/wrapper-en.html#trace
Optionen
Diese Attribute können im <trace…/> - Knoten der rocrail.ini verwendet werden.
| Option | Standard | Beschreibung |
|---|---|---|
| protpath | . | Protokoll Pfad; Wohin die Protokolldateien gespeichert werden. (Relative Pfade nur bei Verwendung des http Dienst benutzen.) Der Pfad ist relativ zum pwd¹! |
| unique | false | Erstellen einer einzigen Protokolldatei beim Start. |
| size | 100 | Dateigröße der Protokolldatei in KB. |
| nr | 10 | Anzahl der aufeinanderfolgenden Protokolldateien. Im Falle von 0 oder 1 werden alle Ergebnisse in eine Datei geschrieben ohne Berücksichtigung der Dateigröße |
| exceptionfile | false | Erstellen einer zusätzlichen Datei für Ergebnisse. |
| invoke | ./xmail.pl | Externes Programm oder Skript aufrufen, um eine Ergebnis-Datei zu erstellen. |
| invokeasync | false | Der Aufruf wird in einem eigenen Thread behandelt. |
| dumpsize | 128 | Max. byte dump Größe. |
¹) pwd = process working directory=Arbeitsverzeichnis
Unique
Um das Überschreiben bereits bestehender Protokolldateien bei einer Problemsuche zu verhindern, sorgt diese Einstellung dafür, dass immer ein einzigartiger Dateiname vergeben wird.
Invoke
Die invoke Option, in Verbindung mit exceptionfile, stellt einen Mechanismus dar, um jemanden oder etwas vom ersten Ergebnis zu informieren, das in eine neue Datei geschrieben wird.
Nach Durchsicht der Datei sollte diese verschoben oder gelöscht werden, um die Möglichkeit der Erstellung einer neuen Datei zu ermöglichen. (Wenn gewünscht.)
Das Skript oder Programm zur Überwachung ist benutzerdefiniert, wenn das externe Progamm aber den Rocrail-Server stoppen kann, sollte invokeasync auf true gesetzt werden.
xmail.pl
Das Beispiel Skript sendet eine Email wenn ein Protokoll erstellt wird:
#!/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);
Ebenen-Werte
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