+

Search Tips   |   Advanced Search

WebSphere Portal runtime logs

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

The default runtime log file is shown:

    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 information describes trace loggers for particular situations and problem symptoms. Enable the trace loggers can slow down WebSphere Portal.

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

  • If there are problems with portal administration portlets, the error is not caused by the portlet code itself, but by the underlying function for which the portlet provides the UI. Therefore, the portlet trace strings are not listed here. If there are issues with these portlets, provide the trace strings of the underlying function. If we need traces or logs for portlets, we can learn how to obtain them from support personnel.


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.

    Enable this logger creates 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.

    Enable this logger creates 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

    Enable this logger creates 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


Mail Service

    When to use
    Diagnose problems with the Mail Service.

    Trace string

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


Mapping URLs

    When to use
    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 logs 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
    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
    Diagnose problems with portlets.

    Trace string

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

    Additional comments
    Enable tracing for all portlets. 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.

    Enabling this logger can create large log files fast.


Selfcare

    When to use
    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 that is done 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
    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 turning 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 we use the Security Vault task on the Security page of the Administration pages.


WSRP administration

    When to use
    Diagnose problems that occur 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


consumer

    When to use
    Diagnose problems that occur during the use of WSRP with WebSphere Portal as a Consumer.

    Trace string

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


producer

    When to use
    Diagnose problems that occur 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
    Diagnose problems with the XML import/export of WebSphere Portal configurations.

    Trace string

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


Parent Logging and tracing