WebSphere Portal run-time logs

 

+

Search Tips   |   Advanced Search

 

If tracing is enabled, WebSphere Portal generates a log file during run time that contains messages and trace information.

The default run-time log file is:

See the topic on system event logging for details on how to configure logging and for information on the grammar of the "trace string" configuration key.

The following table describes trace loggers for particular situations and problem symptoms. Enabling the trace loggers can slow down WebSphere Portal.

The trace strings beginning with com.ibm.wps.* are extensions in the IBM portlet API.

Area of concern When to use Trace string Additional comments
Access Control Enable this tracer if you want permissions for resources to be explained in detail, need to verify the correctness of a permission, or need to isolate a defect in access control. com.ibm.wps.ac.*=all The traces are easier to evaluate while WebSphere Portal usage is low.

Enabling this logger creates very large log files.

Authentication   com.ibm.wps.engine.*=all:
com.ibm.wps.services.puma.*=all:
com.ibm.wps.puma.*=all:
com.ibm.wps.auth.*=all:
com.ibm.wps.sso.*=all:
com.ibm.wps.um.*=all:
com.ibm.wps.services.authentication.*=all 		 
Command Turn on all command trace loggers. com.ibm.wps.commands.*=all  
Composition Model Enable these messages if you want to get more information on how pages are constructed, need to verify page lists displayed on WebSphere Portal for correctness, or need to isolate an error in the WebSphere Portal aggregation component. com.ibm.wps.model.*=all:
com.ibm.wps.composition.*=all 		The traces are easier to evaluate while WebSphere Portal usage is low.

Enabling this logger creates very large log files.

Credential Vault   com.ibm.wps.sso.credentialvault.*=all:
com.ibm.wps.command.credentialvault.*=all:
com.ibm.wps.portletservice.credentialvault.*=all:
com.ibm.wps.services.credentialvault.*=all:
com.ibm.portal.portlet.service.credentialvault.*=all 		 
Database Deals with generated SQL statements and the internal flow in the WebSphere Portal database layer. com.ibm.wps.datastore.*=all:
com.ibm.wps.services.datastore.*=all 		Enabling this logger will create very large log files.
Engine Enable all engine trace loggers. com.ibm.wps.engine.*=all  
General   com.ibm.wps.*=all

To use general tracing but do not want render times to be displayed for such portlets, selectively disable tracing using the following trace string:

com.ibm.wps.pe.PortletRenderTimeLoggingHelper=info

When general tracing is enabled and parallel portlet rendering is turned on, portlets that are configured to be rendered in parallel will display the render time as part of the portlet content.
Mail Service Diagnose problems with the Mail Service. com.ibm.wps.services.mail.*=all  
Mapping URLs Diagnose problems with the user-defined mappings of URLs com.ibm.wps.mappingurl.*=all:
com.ibm.wps.command.mappingurl.*=all 		 
Personalization   com.ibm.websphere.personalization.*=all:
com.ibm.dm.pzn.ui.*=all 		When Personalization is installed outside of a WebSphere Portal server, Personalization will log using WAS tracing with the same trace strings.
WebSphere Portal Search Turn on all WebSphere Portal Search messages. com.ibm.portal.search=all For detailed information refer to Log and tracing in Portal Search.
Obtain messages about URLs that are discovered by the crawler but could not be fetched and indexed for different reasons.
com.ibm.portal.search.notIndexed=all
Obtain messages about the crawling process.
com.ibm.portal.search.crawler=all
Obtain messages about failures that happen during a crawl.
com.ibm.portal.search.crawler.failure=all
Obtain messages about the indexing process.
com.ibm.portal.search.index=all
Obtain messages about failures that happen during the indexing process.
com.ibm.portal.search.index.failure=all
Portlet Container   com.ibm.wps.pe.pc.*=all: org.apache.jetspeed.portlet.Portlet=all: javax.portlet.Portlet=all  
Portlet Environment   com.ibm.wps.pe.ext.*=all:
com.ibm.wps.pe.factory.*=all:
com.ibm.wps.pe.om.*=all:
com.ibm.wps.pe.util.*=all 		 
Deployment   com.ibm.wps.pe.mgr.*=all:
com.ibm.wps.services.deployment.*=all:
com.ibm.wps.command.applications.*=all:
com.ibm.wps.command.portlets.*=all 		 
Portlets Diagnose problems with portlets. com.ibm.wps.portlets.*=all: org.apache.jetspeed.portlet.PortletLog=all Enables tracing for all portlets. Therefore, place the suspect portlet on a separate page for testing.
Scripting Interface Diagnose problems with the Portal Scripting Interface, or with application interface scripting, and the execution of such scripts. com.ibm.wps.scripting.*=all The traces are easier to evaluate while WebSphere Portal usage is low.

Enabling this logger can create large log files fast.

Selfcare Diagnose problems with user registration and profile editing. com.ibm.wps.services.puma.*=all:
com.ibm.wps.puma.*=all:
com.ibm.wps.um.*=all 		Use this logger if there are errors in the sign-up, Edit My Profile, and the Manage Users and Groups portlets.
Services: EventBroker   com.ibm.wps.services.registry.EventHandlerRegistry=all:
com.ibm.wps.services.events.*=all 		 
Services: Finder Debug the resolution of file names. com.ibm.wps.services.finder.*=all  
Services: Loader Trace the dynamic class loading performed by this service. com.ibm.wps.services.ServiceManager=all  
ServicesNaming Debug the lookup of objects by the naming service. com.ibm.wps.services.naming.*=all  
ServicesNavigator Diagnose problems with parts of page aggregation and display. com.ibm.wps.services.navigator.*=all  
ServicesRegistry View the policies of the internal portlet object caching and watch it reload its content. com.ibm.wps.services.registry.*=all  
Services Switch on tracing for all services. com.ibm.wps.services.*=all  
SSO Turn on all SSO tracer loggers listed after this trace logger. com.ibm.wps.sso.*=all Use this logger if errors occur when use the Security Vault task on the Security page of the Administration pages.
WSRP administration Diagnose problems occurring during the administration of Web Services for Remote Portlets (WSRP) with WebSphere Portal. com.ibm.wps.command.wsrp.*=all:
com.ibm.wps.wsrp.cmd.*=all 		 
WSRP Consumer Diagnose problems occurring during the use of WSRP with WebSphere Portal as a Consumer. com.ibm.wps.wsrp.consumer.*=all  
WSRP Producer Diagnose problems occurring during the use of WSRP with WebSphere Portal as a Producer. com.ibm.wps.wsrp.producer.*=all  
XML configuration interface Diagnose problems with the XML import/export of WebSphere Portal configurations. com.ibm.wps.command.xml.*=all  


Parent topic:

Log and tracing