How to divide different categories and severities of log files into different files in the Logging section
FIXEdge and FIX Antenna provide the possibility to divide different categories and severities of log files into different files by configuring FIXEdge.properties or engine.properties.
Division by categories (for FE)
To divide log files by categories it is required to add the corresponding property to the FIXEdge.properties.
Below is the list of commonly used categories:
- [FL_Layer]
- [BL_Layer]
- [TransportLayer]
- [CC_Layer]
- [CCAdminApplication]
- [HandlerLayer]
- [FIXMLConverter]
- [BL_RoutingTable]
- [BL_PluginManager]
- [BL_HistoryManager]
- [BL_StrategyFactory]
- [BL_Xml_Parser]
- [BL_Cond]
- [BL_Action]
- [JS_interpreter]
- [BL_RoutingTable_Loader]
- [BusinessLayer_Version]
- [EngineAdaptor]
- [FL_FixEngine]
- [FL_MsgTrace]
- [Engine]
- [FEMsgProcessor]
- [EA_LogsMover]
- [FixEngine_Version]
- [FixLayer_Version]
List of Log Categories can be seen during FE initialization. Not all of them can appear in client's setup because it depends on client's configuration. For example, some may not have any JS scripts, so [JS_interpreter] won't be created.
Please explore your log file to select a category you want to allocate. Refer to Log.File.Format for details regarding the place of log category in log format.
E.g. To allocate the log file with CCAdminApplication category, need to add the following record to properties:
Log.CCAdminApplication.File.Name = FIXEdge1/log/FixEdge_CCAdminApplication.log
All other logging parameters for the allocated log file can be described following the Logging parameters article.
Division by severities (for FE and FIX Antenna)
To divide log files by severities it is required to add the corresponding property to the engine.properties for FIX Antenna or to FIXEdge.properties for FIXEdge.
Below is the list of supported severities:
E.g. To allocate the log file with Debug severity, you need to add the following record to the engine.properties for FIX Antenna:
# FIX Antenna: Log.Debug.File.Name = FIXAntenna/log/engine_Debug.log
and to FIXEdge.properties for FIXEdge:
# FIXEdge: Log.Debug.File.Name = FIXEdge1/log/FixEdge_Debug.log
All other logging parameters for the allocated log file can be described following the Logging parameters article.
It is recommend to keep enabled only FATAL, ERROR, WARN and NOTE level in production for better performance.
Division by severities of category (for FE)
To divide log files by severities of category (i.e. to have separate log files for some severities in any category), need to add the corresponding property to the FIXEdge.properties.
E.g. To allocate the log file with Debug severity of CCAdminApplication category, need to add the following record to properties:
Log.CCAdminApplication.Debug.File.Name = FIXEdge1/log/FixEdge_CCAdminApplication_Debug.log
All other logging parameters for the allocated log file can be described following the Logging parameters article.