5.5 Logging

Added by Justen Stepka, last edited by admin on May 23, 2007
Crowd 1.0 Documentation

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 1.0 Documentation  

Labels:

CROWD10 CROWD10 Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.