WebSphere Portal run-time logs

 

+

Search Tips   |   Advanced Search

 

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

The default run-time log file is:

WP_PROFILE/logs/WebSphere_Portal/trace.log

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.

 

Access Control

If you want...

• permissions for resources to be explained in detail
• verify the correctness of a permissions
• isolate a defect in access control

...set...

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.sso.*=all: com.ibm.wps.services.authentication.*=all

 

Command

Turn on all command trace loggers...

com.ibm.wps.commands.*=all

 

Composition Model

To...

• get more information on how pages are constructed
• verify page lists displayed on WebSphere Portal for correctness
• isolate an error in the WebSphere Portal aggregation component

...set...

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

To confirm 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

If you want 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

• 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

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

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

Logging and tracing