Appboard/2.6/admin/log files: Difference between revisions

imported>Jason.nicholls
imported>Jason.nicholls
Line 46: Line 46:
* Items requested by the application that could not be located on the server<br>
* Items requested by the application that could not be located on the server<br>
* User session information
* User session information
* Application-level access log. This logs individual accesses to enPortal Channels, AppBoard Stacks, and AppBoard Boards per user.
* Application-level access log. This logs per-user accesses to enPortal Channels, AppBoard Stacks, and AppBoard Boards.
|-
|-
| <tt>tomcat.log</tt>
| <tt>tomcat.log</tt>

Revision as of 06:13, 24 July 2015

Overview

AppBoard provides a number of log files to record activity and to assist with monitoring and troubleshooting. By default these log files are set to be automatically compressed and rotated to prevent run-away disk usage.

Log files are stored in the following location: [INSTAL_HOME]/server/logs/


Log Files

The following table summarizes each log file and the information it provides:

Log File Description
appBoard.log All messages related to client-server communications
Information about data queries made to the server
Java runtime error messages
Other errors and warnings
error.log Subset of appBoard.log, containing only Error messages
ldap.log Messages related to LDAP
localhost_access_log.[date].txt Log of individual HTTP requests serviced by the system including proxied requests. For application access information covering enPortal channel, and AppBoard Stack and Board usage refer to the system.log.
session.log Detail of all User sessions in the system, including:
  • Timestamp
  • Role
  • Domain
  • Username
  • Transaction Result
  • Session ID
  • Total number of concurrent logins
  • Total number of concurrent logins in the User's Domain
  • IP address
system.log All errors, warnings, and informational messages related to the enPortal server. including:
  • Expired license errors
  • Items requested by the application that could not be located on the server
  • User session information
  • Application-level access log. This logs per-user accesses to enPortal Channels, AppBoard Stacks, and AppBoard Boards.
tomcat.log The standard log file for the Tomcat web application container

Configuring Rotation

Log file rotation is configured in the config.properties (most log files) and appboard.properties (appBoard.log) property files under [INSTALL_HOME]/server/webapps/enportal/WEB-INF/config/.

The default configuration is as follows:

[ini,N]

  1. Log cleanup settings

logwatch.error.prefix=${logger.logs.path}/error.log logwatch.error.numberToKeep=7 logwatch.error.compress=true

logwatch.system.prefix=${logger.logs.path}/system.log logwatch.system.numberToKeep=7 logwatch.system.compress=true

logwatch.session.prefix=${logger.logs.path}/session.log logwatch.session.numberToKeep=7 logwatch.session.compress=true

logwatch.ldap.prefix=${logger.logs.path}/ldap.log logwatch.ldap.numberToKeep=7 logwatch.ldap.compress=true

logwatch.access.prefix=${logger.logs.path}/localhost_access_log logwatch.access.numberToKeep=7 logwatch.access.compress=true logwatch.access.skiplast=true

  1. Log cleanup settings

logwatch.appBoard.prefix=${logger.logs.path}/appBoard.log logwatch.appBoard.numberToKeep=7 logwatch.appBoard.compress=true

This background job can be used to clean up any files that always have the same prefix. It assumes either the files are names: (<logname>, <logname><suffix1>, <logname><suffix2>) or (<logname><suffix1>, <logname><suffix2>, and so on). In the first case, the one without the suffix is assumed to be the current log, while in the latter a flag “skiplast” is used to not archive/delete the last (in alpha-numeric ordering). This is only used for the tomcat access log.

numberToKeep does not include the current log, and compress will put the old log in a file named the same with ".zip" added. The process runs every 30 minutes to look for old files that need to be processed.

Log File Configuration

The standard log files above are written using the log4j library and can be configured through the enportal/WEB-INF/classes/log4j.xml file. For information on configuring log4j, please see: http://en.wikipedia.org/wiki/Log4j#Configuration

Of note, the following settings will change the verbosity of the log files and how long each daily log is kept.

[xml,N] <param name="Threshold" value="INFO"/> <param name="MaxBackupIndex" value="15"/>

Threshold can have values from most verbose to least of: TRACE, DEBUG, INFO, WARN, ERROR and FATAL.

The MaxBackupIndex is the number of daily logs to keep for each log file type, which is 15 by default.

Additional enPortal Logging

Refer to the enPortal Log File documentation for further information.

Submitting Log Files to Technical Support

For information on submitting a support ticket, see the Technical Support page.

For instructions on sending information to the Technical Support team, see the Submitting Files for Technical Support page.