Tracy. Live Remote File Tracing.

tracy -f:server.log
=> http://localhost:8080/tracy

tracy -f:server.log -h:"ERROR,WARNING"
=> http://localhost:8080/tracy
Färbt ERROR und WARNING rot ein.

tracy -p:8081 -f:"C:\Power Client\client.log"
=> http://localhost:8081/tracy

tracy -p:8080 -f:one.cs -u:fileone -l:true -c:f
=> http://sirius:8080/tracy/fileone

tracy -f:my*.log -k:time -o:d
=> http://localhost:8080/tracy
Zeigt im Append-Modus aktuellste Datei aus der Gruppe my*.log

Erläuterung:

-f: Name der zu überwachenden Datei. Wildcard "*" im Dateinamen ist als Filter möglich. Es wird dann die in der Sortierordnung erste Datei angezeigt. Der Filter ist "live": Werden Dateien im betrachteten Verzeichnis hinzugefügt oder gelöscht, so schaltet Tracy auf die nächste zum Filter passende Datei um.

-p: Portnummer für die Kommunikation zwischen Webbrowser und Tracy. Der Default-Wert ist 8080. Ports dürfen auf Betriebssystemebene nicht blockiert sein. Ggf. Firewall anpassen.

-u: Teilpfad (subpath) zur Bildung alternativer URLs für unterschiedliche Trace-Szenarien. Der Default-Wert ist leer. Die angegebene Zeichenkette wird im URL an "tracy/" angehängt. Beispiel: Aus -u:myfile wird http://localhost:8080/tracy/myfile

-l: Schalter für die Anzeige der Zeilennummern. Default-Wert ist false. Bei true wird den Textzeilen [<Zeilennummer>] vorangestellt.

-c: Darstellungs- und Updatemodus für den Inhalt (content). Zwei Varianten: append und full. "append" ist der klassische Log-Modus. Es werden lediglich neue Textzeilen angehängt. Bereits dargestellte Zeilen bleiben unverändert. "full" wird für kleinere Dateien verwendet, die sich inhaltlich an jeder Position verändern können. Der Default-Wert ist a.

-k: Sortierschlüssel bei der Auswahl der darzustellenden Datei, wenn der Wildcard-Filter mehrere Dateien zulässt. "name" ist der Dateiname, "time" (Default-Wert) ist der Zeitpunkt des letzten Schreibzugriffs. Das Default-Verhalten ist für die meisten Anwendungsfälle optimal.

-o: Sortierlogik bei der Auswahl der darzustellenden Datei, wenn der Wildcard-Filter mehrere Dateien zulässt. "a" ist ascending, "d" ist descending (Default-Wert). Nach Sortierung wird die in der sortierten Liste erste Datei angezeigt. Das Default-Verhalten ist für die meisten Anwendungsfälle optimal.

-h: Kommagetrennte Liste der hervorzuhebenden Schlüsselworte. Z.B.: "ERROR,WARNING". Die Begriffe werden in roter Farbe dargestellt.

A: Prüfen Sie Fehlermeldung auf weitere Informationen. Starten Sie Tracy mit Administratorrechten und prüfen Sie, ob die Webseite dann erreichbar ist.

Alternativ kann der URL auch freigegeben werden, indem als Administrator folgendes CMD-Kommando ausgeführt wird:
netsh http add urlacl url=http://+:8080/tracy/ user=<DOMAIN>/<USERNAME>

Stellen außerdem Sie sicher, dass Sie zulässige Aufrufparameter übergeben haben. Fragen Sie ggf. bei uns an (E-Mail), wenn Sie nicht weiterkommen und Unterstützung benötigen.

A: Normalerweise wird das Anzeigepanel geleert. Es wird dann kein Inhalt mehr angezeigt. Falls jedoch ein Filter angegeben wurde, der auf mehrere Dateien passt, so wird die nächste passende Datei und in der Sortierung am weitesten vorne liegende Datei angezeigt.

A: Ja. Es können mehrere Instanzen von Tracy parallel ausgeführt werden. Dateien können an unterschiedliche Ports gebunden werden oder auch an unterschiedliche Sub-Pfade. Die Dateien können auf diese Weise über die unterschiedlichen Tabs Ihres Webbrowsers eingesehen werden.

Beispiel 1 - Unterschiedliche Ports:
tracy -f:datei1.txt -p:8081 ermöglicht das Überwachen der datei1.txt mit http://localhost:8081/tracy
tracy -f:datei2.txt -p:8082 ermöglicht das Überwachen der datei2.txt mit http://localhost:8082/tracy

Beispiel 2 - Unterschiedliche Sub-Pfade:
tracy -f:datei1.txt -s:datei1 ermöglicht das Überwachen der datei1.txt mit http://localhost:8080/tracy/datei1
tracy -f:datei2.txt -s:datei2 ermöglicht das Überwachen der datei2.txt mit http://localhost:8080/tracy/datei2

A: Nach einer Aktualisierung des Webbrowsers befindet sich der Scrollbalken im Append-Modus (-c:a) ganz unten. Die Darstellung wird bei dieser Einstellung im Webbrowser bei hinzukommenden Log-Inhalten immer automatisch nach untern weiter gescrollt. Schiebt man den Scrollbalken allerdings nach oben, z.B. um frühere Log-Einträge betrachten zu können, so wird die automatische Aktualisierung temporär deaktiviert. Wenn man im Anschluss wieder nach untern blättert (Scrollbalken unten), wird die Aktualisierung und das automatische Scrollen fortgesetzt.

A: Ja. Es werden aktuell bis zu 1000 Zeilen angezeigt. Im Append-Modus sind dies die letzten 1000 Zeilen der Log-Datei.

A: Die Webseite wird im Sekundenbereich zyklisch informiert, wenn sich ein Dateiinhalt geändert hat. Dann erfolgt die Aktualisierung der Darstellung. Je nach Größe der zu beobachtenden Textdatei, kann dies auch etwas länger dauern, da dann Dateiinhalte vollständig geladen werden müssen.

A: Prüfen Sie die eingegebene URL. Stellen Sie außerdem sicher, dass die von Ihnen angegebenen Ports (Parameter -p:) nicht durch die Firewall oder durch andere Programme blockiert sind.

A: Logdateien sind typischerweise sehr groß, ändern sich aber nur durch hinzukommende Log-Einträge. Für solche Log-Dateien wurde der append-Modus entwickelt, da er nur die neue hinzugekommenen Zeilen aus der beobachteten Datei ausliest. Dies reduziert die Systemlast und ist auch schneller.

Es gibt allerdings auch Textdateien, die sich an beliebigen Positionen verändern können. Das sind z.B. Quellcode-Dateien oder auch Statusdateien, die visualisiert werden sollen.

Wenn möglich, dann sollten Sie den append-Modus bevorzugen.

A: Der interaktive Start von Tracy mit Kommandozeilenparametern ermöglicht die einfache und schnelle Nutzung des Programms, ohne Installation und ohne komplexe Konfiguration. Darüber hinaus lassen sich so ohne Umwege eine oder mehrere Instanzen starten und beenden.

Soll Tracy dauerhaft ausgeführt werden, auch unabhängig von Benutzeranmeldungen, dann kann die Installation als Dienst sinnvoll sein. Eine solche Installation kann auf einfache Weise z.B. unter Verwendung der Windows Resource Kits und dem Programm svrany durchgeführt werden. Schritte:

1. srvany.exe aus den Windows Resource Kits (von Microsoft) lokalisieren/herunterladen
2. Tracy als Dienst installieren. Z.B. als Admin per "sc create tracyservice binPath=C:\tracy\srvany.exe"
3. Tracy in Registry konfigurieren. Hierzu in "Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\tracyservice" den Ordner "Parameters" anlegen. Darin die Zeichenfolge "Application" neu anlegen mit dem Aufruf von Tracy. Z.B. "C:\tracy\tracy.exe -f:C:\log\server.log".
4. Dienst starten.

Bei Fragen hierzu kontaktieren Sie uns gerne.