WebSphere Portal run-time logs

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. Enable 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.

Enable 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 Use to 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.

Enable 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

Important: Enable this logger will create very large log files.
Engine Use to 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 Use to diagnose problems with the Mail Service.
com.ibm.wps.services.mail.*=all   


Mapping URLs Use to 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 Use to turn on all WebSphere Portal Search messages.
com.ibm.portal.search=all 

For detailed information refer to Logging and tracing in Portal Search.
WebSphere Portal Search Enable to 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 

For detailed information refer to Logging and tracing in Portal Search.
WebSphere Portal Search Enable to obtain messages about the crawling process.
com.ibm.portal.search.crawler=all

For detailed information refer to Logging and tracing in Portal Search.
WebSphere Portal Search Enable to obtain messages about failures that happen during a crawl.
com.ibm.portal.search.crawler.failure=all

For detailed information refer to Logging and tracing in Portal Search.
WebSphere Portal Search Enable to obtain messages about the indexing process.
com.ibm.portal.search.index=all

For detailed information refer to Logging and tracing in Portal Search.
WebSphere Portal Search Enable to obtain messages about failures that happen during the indexing process.
com.ibm.portal.search.index.failure=all

For detailed information refer to Logging and tracing in Portal Search.
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


Portlet Load Monitoring Use to diagnose problems with Portlet Load Monitoring (PLM).
com.ibm.wps.pe.pc.waspc.plm.*=all:
com.ibm.wps.command.plm.*=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 Use to 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 Use this trace string to 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. Enable this logger can create large log files fast.
Selfcare Use to 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 Use for debugging the resolution of file names.
com.ibm.wps.services.finder.*=all


Services: Loader Use to trace the dynamic class loading performed by this service.
com.ibm.wps.services.ServiceManager=all


ServicesNaming Use to debug the lookup of objects by the naming service.
com.ibm.wps.services.naming.*=all


ServicesNavigator Use to diagnose problems with parts of page aggregation and display.
com.ibm.wps.services.navigator.*=all


ServicesRegistry Use to view the policies of the internal portlet object caching and watch it reload its content.
com.ibm.wps.services.registry.*=all


Services Use for switching on tracing for all services.
com.ibm.wps.services.*=all


SSO Use to turn on all SSO tracer loggers.
com.ibm.wps.sso.*=all

Use this logger if errors occur when using the Security Vault task on the Security page of the Administration pages.
WSRP administration Use to 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 Use to diagnose problems occurring during the use of WSRP with WebSphere Portal as a Consumer.
com.ibm.wps.wsrp.consumer.*=all


WSRP Producer Use to diagnose problems occurring during the use of WSRP with WebSphere Portal as a Producer.
com.ibm.wps.wsrp.producer.*=all 


XML configuration interface Use to diagnose problems with the XML import/export of WebSphere Portal configurations.
com.ibm.wps.command.xml.*=all



Parent

Logging and tracing

 


+

Search Tips   |   Advanced Search