Controlling Logging in the Handler

The Handler logs important aspects of its execution. Logs are stored into the directory specified by the OnixS::EuroTLX::MarketData::Mitch::HandlerSettings::logDirectory member value. Logging includes network data received and processed by handler and, of course, errors occurred at execution time.

Since handlers output logging data into regular files, this affects their performance and sometimes requires significant system resources like space on a hard drive. The Handler exposes several parameters which allow to suppress certain kinds of logging data and thus to reduce load on the file system and increase general performance.

Following table describes logging-related parameters exposed by the OnixS::EuroTLX::MarketData::Mitch::HandlerSettings structure:

Settings Member	Default value	Description
logLevel	OnixS::EuroTLX::MarketData::Mitch::LogLevel::Info	Specifies whether handler's instance must output informational messages about its state as well as which kind of information must be put into the log. For more information, please, take a look at description of OnixS::Eurex::MarketData::LogLevel enumeration entries.
logSettings	OnixS::EuroTLX::MarketData::Mitch::LogSettings::Default	If logging is activated, this member specifies which additional data must be put into the log. For more information, please, take a look at description of OnixS::Eurex::MarketData::LogSettings enumeration entries.

Activating Logging Example

Following example demonstrates how to enable logging:

settings.logLevel = OnixS::EuroTLX::MarketData::Mitch::LogLevel::Debug;

settings.logDirectory = "./logs";

// Log messages will be stored in the file, as well as received binary packets and full state of updated order books.
settings.logSettings = LogSettings::TraceToFile|LogSettings::LogPackets|LogSettings::LogBooks;