This page last changed on Apr 02, 2007 by rosie@atlassian.com.

Logging

A common task when identifying Crowd problems is to turn up the log level. This section describes how to adjust the various Crowd log settings.

Background

Crowd's logging output is classified by importance, with the levels being:

  • DEBUG: low-level details most people never need to know about.
  • INFO: Informational messages on what Crowd is doing. Usually not interesting.
  • WARN: Warnings that something may have gone wrong, or other messages a sysadmin may wish to know.
  • ERROR: Something went wrong in Crowd. The person responsible for configuring Crowd should be notified.

The default level is WARN, meaning warnings and errors are displayed. Sometimes it is useful to adjust this level to see more details.

Change the Logging Level

  1. With a text editor, open crowd-webapp/WEB-INF/classes/log4j.properties.
  2. Adjust the output level to the expected level of importance listed above in the Background section.
  3. Save the log4j.properties file.
  4. Restart Crowd to have the new log settings take affect.

When diagnosing a server problem you need to adjust Crowd's package logging be:

log4j.logger.com.atlassian.crowd=DEBUG

XFire / Web Services Messages

Crowd has specific loggers that allow you to review the incoming and outgoing messages to the Crowd security framework. This is useful in debugging your applications or to monitor how much traffic is being used by an integrated application.

To turn on the XFire in and out logging handler, add uncomment the following lines in your log4.properties file:

# Uncomment the line below to have the Crowd server output the incoming SOAP request method and parameters.
log4j.logger.com.atlassian.crowd.integration.service.soap.xfire.XFireOutLoggingMethodHandler=DEBUG

# Uncomment the line below to have the Crowd server output the outgoing SOAP request method and parameters.
log4j.logger.com.atlassian.crowd.integration.service.soap.xfire.XFireInLoggingMethodHandler=DEBUG


Related Topics  


Crowd Documentation  

Document generated by Confluence on Jun 20, 2007 20:58