Initializing help system before first use

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.xml
where 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}&#x9;%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>