User Tools

Site Tools


rocrail-tracing-de

Erweiterte Traces

Inhalt Rocrail-Server → | Konfiguration


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
rocrail-tracing-de.txt · Last modified: 2022/03/01 00:04 by rainerk