Configuring Logging
The location, format and file management policy of the log files generated by Xpress Insight is governed by settings in an XML configuration file.
These logs include:
- Audit logging (disabled by default).
- Change Logging
- Server Log
- Job Log
The default location of the XML configuration file is:
wildfly-x.y.z/standalone/configuration/standalone.xmlwhere x.y.z are the version, subversion, and patch numbers.
Configuring the Audit Log
To disable audit logging, search for the following fragment and change INFO to OFF:
<logger category="com.fico.xpress.insight-audit"> <level name="INFO"/> <handlers> <handler name="INSIGHT_AUDIT_FILE"/> </handlers> </logger>
After changing the audit log configuration, restart the Xpress Insight server to ensure it is updated and uses the modified settings.
To configure the audit log rotation policy, search for the following fragment and perform two tasks:
- Change the <max-backup-index value> element to edit the number of retained log files.
- Change the <rotate-size value> to update the size at which the file is archived.
<size-rotating-file-handler name="FILE"> <formatter> <pattern-formatter pattern="%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/> </formatter> <file relative-to="jboss.server.log.dir" path="server.log"/> <append value="true"/> <max-backup-index value="18"/> <rotate-size value="50m"/> </size-rotating-file-handler>
Configuring Change Logging
To enable change logging, search for the following fragment and change
OFF to
INFO:
<logger category="com.fico.xpress.insight-data-changes"> <level name="OFF"/> <handlers> <handler name="INSIGHT_DATA_CHANGE_FILE"/> </handlers> </logger>To configure the log file rotation policy, search for the following fragment:
<size-rotating-file-handler name="INSIGHT_DATA_CHANGE_FILE"> <formatter> <pattern-formatter pattern="%d{yyyy.MM.dd HH:mm:ss} %s%E%n"/> </formatter> <file relative-to="jboss.server.log.dir" path="insight-data-changes.log"/> <append value="true"/> <max-backup-index value="6"/> <rotate-size value="5m"/> </size-rotating-file-handler>
Configuring the Server Log
The Server log is enabled by default. It is not advisable to disable this feature. The settings can be changed by editing the following fragment:
<logger category="com.fico.xpress.insight"> <level name="INFO"/> </logger>
To configure the audit log rotation policy, search for the following fragment and perform two tasks:
- Change the <max-backup-index value> element to edit the number of retained log files.
- Change the <rotate-size value> to update the size at which the file is archived.
<size-rotating-file-handler name="FILE"> <formatter> <pattern-formatter pattern="%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/> </formatter> <file relative-to="jboss.server.log.dir" path="server.log"/> <append value="true"/> <max-backup-index value="18"/> <rotate-size value="50m"/> </size-rotating-file-handler>
Configuring the Job Log
The Job log is enabled by default. To disable job logging, search for the following fragment and change
INFO to
OFF:
<logger category="com.fico.xpress.insight-jobs"> <level name="INFO"/> <handlers> <handler name=" INSIGHT_JOBS_FILE"/> </handlers> </logger>
To configure the job log rotation policy, search for the following fragment and perform two tasks:
- Change the <max-backup-index value> element to edit the number of retained log files.
- Change the <rotate-size value> to update the size at which the file is archived.
<size-rotating-file-handler name="INSIGHT_JOBS_FILE"> <formatter> <pattern-formatter pattern="%d{yyyy-MM-dd HH:mm:ss}	%s%n"/> </formatter> <file relative-to="jboss.server.log.dir" path="insight-jobs.log" /> <append value="true"/> <max-backup-index value="6"/> <rotate-size value="5m"/> </size-rotating-file-handler>