Controling Handler Logging

Controling Logging in the Handler

The Handler logs an important aspects of its execution into the directory specified by the OnixS::Euronext::XDP::Settings::logDirectory member value. Logging includes FIX messages received and processed by the Handler, states of books and, of cause, errors occurred at execution time.

Since Handler outputs logging data into regular files, this affects its performance and sometimes requires significant system resources like space on hard drive. Handler exposes several parameters which allows to suppress certain kind of logging data and thus reduce load to the filesystem as well as to increase general performance.

Following table describes logging-related parameters exposed by the OnixS::Euronext::XDP::Settings structure:

Settings Member	Default value	Description
logSettings	LogSettings::Default	Specifies the logging settings as a set of following bitwise flags. TraceProtocol - Trace binary protocol data. TraceFullBook - Trace Order Book changes. TraceToFile - Trace to the log file. TraceToConsole - Duplicate log messages to console. Messages with LogLevel::Trace and LogLevel::Debug are not duplicated to console. Default - TraceToFile | TraceFullBook.
logLevel	LogLevel::Info	Specifies the level of logged messages. Fatal - Fatal error, cannot continue. Error - System error, but we can go on. Warning - User or logic error, just say about it. Info - Information message. Trace - Used for tracing, usually including functions' names and args. Debug - Used for debugging.