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
  • Change Logging (disabled by default)
  • 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>
Parent Topic Administering the Logging Features

© 2001-2023 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.