Fabasoft Tracer

Last update: 8 March 2018

Microsoft Windows

The Fabasoft Tracer "tracer.exe" is a tool for capturing trace messages from various components of a Fabasoft Folio installation , such as the Fabasoft Folio Kernel and the Fabasoft Folio Client .

The file tracer.exe can be found at the following locations:

In the directory "Setup/ComponentsBase/Trace/<platform>/" on the Fabasoft Folio installation disc or image.

In the directory "%ProgramFiles%/Fabasoft/Components/Management/Tools" on any Windows server where a Fabasoft Folio Kernel has been installed.

Commandline Parameters

Usage: tracer.exe [-out <path> [-nogui]]

-out <path>
Redirect the trace messages to a file, this file may be split into multiple parts if the amount of trace messages exceeds a certain limit (100 000 lines).

-nogui
Normally used together with "-out <path>", starts the tracer without a graphical user interface, useful when tracing via a Terminal Server session.

Menus

File->Open
Opens a previously recorded tracefile for analysis.

File->Save
Save the current trace output to a file for later analysis.

File-Redirect
Redirect all new trace messages to a file.

Copy
Copy the currently selected text to the clipboard.

Clear
Remove all currently displayed trace messages.

Select
Search for a specific string inside the trace, select the results by using the + or F3 key to search downwards and the - or F4 key to search upwards.

Run->Start
Restart a previously stopped trace session.

Run->Stop
Stop the current trace session.

Trace->

Processes
Output a list of the currently running processes.

Threads
Output a list of the threads of all currently running processes.

Modules
Output a list of the loaded libraries of all currently running processes.

Windows
Output a list of all currently opened application windows.

Debug...
Start an application and attach the current instance of the Fabasoft Tracer as a debugger.

Attach..
Attach the current instance of the Fabasoft Tracer to an already running application as a debugger.

Any other settings should normally be set to the defaults, special settings that are required will be mentioned in the Service Desk Ticket when requesting the trace.

Linux

The Fabasoft Tracer "tracer" on Linux is a tool, available from Fabasoft Folio 2015 onwards, for capturing trace messages from various components of a Fabasoft Folio installation , such as the Fabasoft Folio Kernel and the Fabasoft Folio Client.

The binary tracer can be found at the following locations:

In the directory "Setup/ComponentsBase/Trace/<platform>/" on the Fabasoft Folio installation disc or image.

In the directory "/opt/fabasoft/bin" on any Linux server where a Fabasoft Folio Kernel, version 15.0 or higher, has been installed.

Commandline Parameters

Usage: tracer [-out <path> [-tee <path>]]

-out <path>
Redirect the trace messages to a file and do not display them in the console, this file may be split into multiple parts if the amount of trace messages exceeds a certain limit (100 000 lines).

-tee <path>
Display trace messages in the console and save them to the specified file , this file may be split into multiple parts if the amount of trace messages exceeds a certain limit (100 000 lines).

Interactive Commands

SPACE
Start/stop the capturing of trace messages.

CTRL+L
Remove all currently displayed trace messages.

Q
Exit the tracer.

Any other settings should normally be set to the defaults, special settings that are required will be mentioned in the Service Desk Ticket when requesting the trace.