WebSphere Portal run-time logs

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

The default run-time log file is:

• AIX Linux Solaris: WP_PROFILE/logs/WebSphere_Portal/trace.log

• IBM i (UserData): WP_PROFILE/logs/WebSphere_Portal/trace.log

See the topic on system event logging for details on how to configure logging and for information 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.

• In case of problems with portal administration portlets, the error is usually not caused by the portlet code itself, but by the underlying functionality for which the portlet provides the UI. Therefore the portlet trace strings are not listed here. In case of issues with these portlets, provide the trace strings of the underlying function. If you need traces or logs for portlets, support personnel will tell you how to obtain them.

Access Control

When to use

Enable this tracer if we 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.

Trace String

com.ibm.wps.ac.*=all

Additional comments

The traces are easier to evaluate while WebSphere Portal usage is low.

Important: Enable this logger creates very large log files.

Authentication

Trace String

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

When to use

Use to turn on all command trace loggers.

Trace String

com.ibm.wps.commands.*=all

Layout Model

When to use

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

Trace String

com.ibm.wps.model.*=all: 
com.ibm.wps.composition.*=all

Additional comments

The traces are easier to evaluate while WebSphere Portal usage is low.

Important: Enable this logger creates very large log files.

Credential Vault

Trace String

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

When to use

Deals with generated SQL statements and the internal flow in the WebSphere Portal database layer.

Trace String

com.ibm.wps.datastore.*=all:   
com.ibm.wps.services.datastore.*=all

Additional comments

Important: Enable this logger will create very large log files.

Engine

When to use

Use to enable all engine trace loggers.

Trace string

com.ibm.wps.engine.*=all

General

Trace string

com.ibm.wps.*=all

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

Additional comments

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

When to use

Use to diagnose problems with the Mail Service.

Trace string

com.ibm.wps.services.mail.*=all   

Mapping URLs

When to use

Use to diagnose problems with the user-defined mappings of URLs

Trace string

com.ibm.wps.mappingurl.*=all:   
com.ibm.wps.command.mappingurl.*=all

Personalization

Trace string

com.ibm.websphere.personalization.*=all: 
com.ibm.dm.pzn.ui.*=all

Additional comments

When Personalization is installed outside of a WebSphere Portal server, Personalization will log using WebSphere Application Server tracing with the same trace strings.

Portlet Container

Trace string

com.ibm.wps.pe.pc.*=all:   
org.apache.jetspeed.portlet.Portlet=all:  
javax.portlet.Portlet=all

Portlet Environment

Trace string

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

When to use

Use to diagnose problems with Portlet Load Monitoring (PLM).

Trace string

com.ibm.wps.pe.pc.waspc.plm.*=all:
com.ibm.wps.command.plm.*=all 

Deployment

Trace string

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

When to use

Use to diagnose problems with portlets.

Trace string

com.ibm.wps.portlets.*=all:   
org.apache.jetspeed.portlet.PortletLog=all

Additional comments

Enables tracing for all portlets. Therefore, place the suspect portlet on a separate page for testing.

Scripting Interface

When to use

Use this trace string to diagnose problems with the Portal Scripting Interface, or with application interface scripting, and the execution of such scripts.

Trace string

com.ibm.wps.scripting.*=all

Additional comments

The traces are easier to evaluate while portal usage is low.

Enable this logger can create large log files fast.

Selfcare

When to use

Use to diagnose problems with user registration and profile editing.

Trace string

com.ibm.wps.services.puma.*=all:   
com.ibm.wps.puma.*=all:
com.ibm.wps.um.*=all 

Additional comments

Use this logger if there are errors in the sign-up, Edit My Profile, and the Manage Users and Groups portlets.

Services: EventBroker

Trace string

com.ibm.wps.services.registry.EventHandlerRegistry=all:   
com.ibm.wps.services.events.*=all

Services: Finder

When to use

Use for debugging the resolution of file names.

Trace string

com.ibm.wps.services.finder.*=all

Services: Loader

When to use

Use to trace the dynamic class loading performed by this service.

Trace string

com.ibm.wps.services.ServiceManager=all

ServicesNaming

When to use

Use to debug the lookup of objects by the naming service.

Trace string

com.ibm.wps.services.naming.*=all

ServicesNavigator

When to use

Use to diagnose problems with parts of page aggregation and display.

Trace string

com.ibm.wps.services.navigator.*=all

ServicesRegistry

When to use

Use to view the policies of the internal portlet object caching and watch it reload its content.

Trace string

com.ibm.wps.services.registry.*=all

Services

When to use

Use for switching on tracing for all services.

Trace string

com.ibm.wps.services.*=all

SSO

When to use

Use to turn on all SSO tracer loggers.

Trace string

com.ibm.wps.sso.*=all

Additional comments

Use this logger if errors occur when using the Security Vault task on the Security page of the Administration pages.

WSRP administration

When to use

Use to diagnose problems occurring during the administration of Web Services for Remote Portlets (WSRP) with WebSphere Portal.

Trace string

com.ibm.wps.command.wsrp.*=all:  
com.ibm.wps.wsrp.cmd.*=all

WSRP Consumer

When to use

Use to diagnose problems occurring during the use of WSRP with WebSphere Portal as a Consumer.

Trace string

com.ibm.wps.wsrp.consumer.*=all

WSRP Producer

When to use

Use to diagnose problems occurring during the use of WSRP with WebSphere Portal as a Producer.

Trace string

com.ibm.wps.wsrp.producer.*=all 

XML configuration interface

When to use

Use to diagnose problems with the XML import/export of WebSphere Portal configurations.

Trace string

com.ibm.wps.command.xml.*=all

Parent: Logging and tracing