Mit Hilfe des Werkzeugs können die Log-Dateien verschiedener Roblet®-Server "gemischt" ausgegeben werden. Benötigt wird diese Funktionalität in seltenen Fällen, wenn sich komplexe Probleme eines verteilten Systems nicht mehr über andere Mittel lösen lassen.
In diesen Fällen kann für jeden betreffenden Server das Datei-Loggen beim Start aktiviert werden. Sie loggen dann in jeweils eine Datei. Die Server können dabei durchaus auf verschiedenen Rechnern laufen, wobei dann meist berücksichtigt werden muß, daß normalerweise alle Rechner mit einer leicht anderen Zeit laufen, was sich beim Mischen der Log-Einträge teilweise deutlich bemerkbar macht.
Der Aufruf geschieht mit dem ersten Parameter log in folgender Weise (in eine Zeile):
java -jar org.roblet.jar tool
log
Datei1 Datei2 ...
Datei1, Datei2 etc. stellen Namen jeweils einer Log-Datei dar. Jeder Name kann mit absoluten oder relativen Pfadangaben versehen sein. Ist nur ein Name angegeben, so werden die Log-Daten einfach ausgegeben.
Bei Angabe mehrer Namen werden die Inhalte der Dateien zeitlich sortiert gemischt ausgegeben. Um zeitliche Differenzen zwischen den Server ausgleichen zu können, kann jeder (betreffende) Dateiname mit einem Versatz in Millisekunden versehen werden. Der Versatz wird auf die Zeiten, die in der Datei angegeben sind aufaddiert. Ein positiver Versatz muß demnach verwendet werden, wenn die Log-Datei auf einem Rechner mit nachgehender Uhr aufgezeichnet wurde (in eine Zeile):
java -jar org.roblet.jar tool
log
Datei1 Datei2@Versatz ...
Angenommen, die Dateien heißen localhost2001.log, ../eagle2002.log und /nfs/genRob.com/logs/genRobcom2001.log und die letztere Datei wurde auf einem anderen Rechner mit einer um 0,303 Sekunden vorgehenden Uhr aufgezeichnet, dann würde man folgendes schreiben können (in eine Zeile):
java -jar org.roblet.jar tool
log
localhost2001.log
../eagle2002.log
/nfs/genRob.com/logs/genRobcom2001.log@-303
