Trace components

Use the following trace strings and logger information to gather the information that you need to troubleshoot problems.

For information about how to configure logging and tracing, see Configure logging for runtime environments.

• MustGather information for catalog-related issues

• MustGather information for contract, pricing, and offer-related issues

• MustGather information for installation-related issues

• MustGather information for Management Center-related issues

• MustGather information for marketing-related issues

• MustGather information for Member and User-related issues

• MustGather information for performance-related issues

• MustGather information for promotion-related issues

• MustGather information for runtime-related issues

• MustGather information for Search-related issues

• MustGather information for Sterling integration-related issues

• MustGather information for Store-related issues

• MustGather information for workspaces-related issues

• MustGather information for messaging-related issues

• Customization server logging

• Performance loggers

• JCA connectors

MustGather information for catalog-related issues

• Collecting MustGather data for attribute dictionary issues

• Collecting MustGather data for catalog tool issues

MustGather information for contract, pricing, and offer-related issues

• Collecting MustGather data for store catalog filter issues

• Collecting MustGather data for Catalog filter tool issues

• Collecting MustGather data for price rule issues

MustGather information for installation-related issues

• Collecting MustGather data for initial WebSphere Commerce deployment issues

• Collecting MustGather data for WebSphere Commerce Developer installation issues

• Collecting MustGather data for customization deployment issues

• Collecting MustGather data for runtime update issues

• Collecting MustGather data for database update issues

MustGather information for Management Center-related issues

• Collecting MustGather data for store preview issues

MustGather information for marketing-related issues

• Collecting MustGather data for marketing issues

MustGather information for Member and User-related issues

• Collecting MustGather data for LDAP issues

• Collecting MustGather data for registration and login issues

• Collecting MustGather data for WCintegration wizard issues

MustGather information for order-related issues

• Collecting MustGather data for inventory (non-ATP) and fulfillment issues

• Collecting MustGather data for DOM inventory, pick up in store, or store locator issues

• Collecting MustGather data for general order issues

• Collecting MustGather data for payment plugin issues

• Collecting MustGather data for shipping and tax issues

MustGather information for performance-related issues

• Collecting MustGather data for Out of Memory issues

MustGather information for promotion-related issues

• Collecting MustGather data for promotion issues

MustGather information for runtime-related issues

• Collecting MustGather data for dynamic cache issues

• Collecting MustGather data for optimistic locking issues

• Collecting MustGather data for Scheduler issues

• Collecting MustGather data for service provider (subscriptions and recurring orders) issues

• Collecting MustGather data for session management issues

• Collecting MustGather data for Spring framework issues

MustGather information for Search-related issues

• Collecting MustGather data for search build index issues

• Collecting MustGather data for search cache invalidation issues

• Collecting MustGather data for search core creation issues

• Collecting MustGather data for search facets issues

• Collecting MustGather data for search relevancy issues

• Collecting MustGather data for search replication issues

• Collecting MustGather data for search rule issues

• Collecting MustGather data for search Rules Based Sales Categories issues

• Collecting MustGather data for search term association and landing page issues

MustGather information for security-related issues

• Collecting MustGather data for access control issues

• Collecting MustGather data for business auditing issues

• Collecting MustGather data for cross-site scripting issues

• Collecting MustGather data for MigrateEncryptedInfo utility issues

MustGather information for Sterling integration-related issues

• Collecting MustGather data for Sterling OMS heartbeat issues

• Collecting MustGather data for Sterling inventory issues

• Collecting MustGather data for Sterling order history issues

• Collecting MustGather data for Sterling order transfer issues

MustGather information for Store-related issues

• Collecting MustGather data for Commerce Composer issues

• Collecting MustGather data for SEO issues

• Collecting MustGather data for SEOURLKEYWORDGEN issues

• Collecting MustGather data for Store Management issues

MustGather information for workspaces-related issues

• Collecting MustGather data for authoring workspaces issues

MustGather information for messaging-related issues

• Collecting MustGather data for messaging issues

Customization server logging

Use the java.util.logging.Logger for logging on the Customization server. This logger is used by default for any IBM provided samples.

Logging for the custom packages of clients is based on the packages that are created by the client developers and the loggers that they include within their packages.

Performance loggers

The performance logger produces trace information about the response time when WebSphere Commerce calls out to different servers or external systems. The trace can be used by a monitor to measure response times.

The trace is enabled using the following string: com.ibm.commerce.performance=fine. The following sample entry shows a sample performance trace file entry, in JSON format:

{"timestamp": "2012/10/02 23:56:38:265 EDT", "threadID": "0000009c", "source": "External OMS", "service": "getPage-getOrderList", "serviceTime": "6188 ms"},

The following performance measurement loggers are used by the WebSphere Commerce service servers to trace request and response calls:

Server	Service
Transaction Server	RestServerLogger, RestClientLogger, UELogger, external service logging
Customization server	Use java.util.logging.Loggerservice to log trace.
Search server	RestServerLogger, RestClientLogger, SolrLogger, UELogger
Store server	ServletRequestLogger, RestClientReadEfficiencyLogger, RestClientLogger

The performance logger, com.ibm.commerce.foundation.logging.service.UELogger, is available to gather performance data to help you identify any performance bottlenecks with our customizations. The UELogger is always-on logger for providing a light-weight trace. The UELogger performs the following functions:

• Measures the entire externalized customization extension process.

• Logs the outbound calls to the external REST services when an extension runs.

• Logs the order data persistence when an extension runs.

The logging layer does not measure the following metrics:

• If caching is enabled for the operation.

• If the operation result was a cache hit.

Note: The result size is measured only for the outbound calls to the external rest services.

The com.ibm.commerce.foundation.logging.service.UELogger is implement by the UEExecuteUtils, UEInvoker, and OrderResponseHandler classes.

JCA connectors

The following are the JCA connectors tracing components in WebSphere Commerce service:

Tracing Component	WebSphere JRAS Extensions Trace Logger
JCA Silverpop adapter	com.ibm.websphere.commerce.adapters.jcasilverpop
Watson Content Hub integration	com.ibm.commerce.wc.messaging.adapters.jcawch.*

• Collecting MustGather data for attribute dictionary issues
  Prepare the following MustGather information before you call IBM Support to help with attribute dictionary issues.

• Collecting MustGather data for catalog tool issues
  Prepare the following MustGather information before you call IBM Support to help with catalog tool issues.

• Collecting MustGather data for store catalog filter issues
  Prepare the following MustGather information before you call IBM Support to help with store catalog filter issues.

• Collecting MustGather data for Catalog filter tool issues
  Prepare the following MustGather information before you call IBM Support to help with Catalog filter tool issues.

• Collecting MustGather data for price rule issues
  Prepare the following MustGather information before you call IBM Support to help with price rule issues.

• Collecting MustGather data for initial WebSphere Commerce deployment issues
  Prepare the following MustGather information before you call IBM Support to help with initial WebSphere Commerce deployment issues.

• Collecting MustGather data for WebSphere Commerce Developer installation issues
  Prepare the following MustGather information before you call IBM Support to help with WebSphere Commerce Developer installation issues.

• Collecting MustGather data for customization deployment issues
  Prepare the following MustGather information before you call IBM Support to help with issues related to building and deploying custom Docker images.

• Collecting MustGather data for runtime update issues
  Prepare the following MustGather information before you call IBM Support to help with runtime update issues.

• Collecting MustGather data for database update issues
  Prepare the following MustGather information before you call IBM Support to help with database update issues.

• Collecting MustGather data for store preview issues
  Prepare the following MustGather information before you call IBM Support to help with store preview issues.

• Collecting MustGather data for marketing issues
  Prepare the following MustGather information before you call IBM Support to help with marketing issues.

• Collecting MustGather data for LDAP issues
  Prepare the following MustGather information before you call IBM Support to help with LDAP issues.

• Collecting MustGather data for registration and login issues
  Prepare the following MustGather information before you call IBM Support to help with registration and login issues.

• Collecting MustGather data for WCintegration wizard issues
  Prepare the following MustGather information before you call IBM Support to help with WCintegration wizard issues.

• Collecting MustGather data for inventory (non-ATP) and fulfillment issues
  Prepare the following MustGather information before you call IBM Support to help with inventory (non-ATP) and fulfillment issues.

• Collecting MustGather data for DOM inventory, pick up in store, or store locator issues
  Prepare the following MustGather information before you call IBM Support to help with DOM inventory, BOPIS, or store locator issues.

• Collecting MustGather data for general order issues
  Prepare the following MustGather information before you call IBM Support to help with general order issues.

• Collecting MustGather data for payment plugin issues
  Prepare the following MustGather information before you call IBM Support to help with payment plugin issues.

• Collecting MustGather data for shipping and tax issues
  Prepare the following MustGather information before you call IBM Support to help with shipping and tax issues.

• Collecting MustGather data for Out of Memory issues
  Prepare the following MustGather information before you call IBM Support to help with Out of Memory issues.

• Collecting MustGather data for promotion issues
  Prepare the following MustGather information before you call IBM Support to help with promotion issues.

• Collecting MustGather data for dynamic cache issues
  Prepare the following MustGather information before you call IBM Support to help with dynamic cache issues.

• Collecting MustGather data for optimistic locking issues
  Prepare the following MustGather information before you call IBM Support to help with optimistic locking issues.

• Collecting MustGather data for Scheduler issues
  Prepare the following MustGather information before you call IBM Support to help with Scheduler issues.

• Collecting MustGather data for service provider (subscriptions and recurring orders) issues
  Prepare the following MustGather information before you call IBM Support to help with service provider (subscriptions and recurring orders) issues.

• Collecting MustGather data for session management issues
  Prepare the following MustGather information before you call IBM Support to help with session management issues.

• Collecting MustGather data for Spring framework issues
  Prepare the following MustGather information before you call IBM Support to help with Spring framework issues.

• Collecting MustGather data for search build index issues
  Prepare the following MustGather information before you call IBM Support to help with the troubleshooting process.

• Collecting MustGather data for search cache invalidation issues
  Prepare the following MustGather information before you call IBM Support to help with the troubleshooting process.

• Collecting MustGather data for search core creation issues
  Prepare the following MustGather information before you call IBM Support to help with the troubleshooting process.

• Collecting MustGather data for search facets issues
  Prepare the following MustGather information before you call IBM Support to help with the troubleshooting process.

• Collecting MustGather data for search relevancy issues
  Prepare the following MustGather information before you call IBM Support to help with the troubleshooting process.

• Collecting MustGather data for search replication issues
  Prepare the following MustGather information before you call IBM Support to help with the troubleshooting process.

• Collecting MustGather data for search rule issues
  Prepare the following MustGather information before you call IBM Support to help with the troubleshooting process.

• Collecting MustGather data for search Rules Based Sales Categories issues
  Prepare the following MustGather information before you call IBM Support to help with the troubleshooting process.

• Collecting MustGather data for search term association and landing page issues
  Prepare the following MustGather information before you call IBM Support to help with the troubleshooting process.

• Collecting MustGather data for access control issues
  Prepare the following MustGather information before you call IBM Support to help with access control issues.

• Collecting MustGather data for business auditing issues
  Prepare the following MustGather information before you call IBM Support to help with business auditing issues.

• Collecting MustGather data for cross-site scripting issues
  Prepare the following MustGather information before you call IBM Support to help with cross-site scripting issues.

• Collecting MustGather data for MigrateEncryptedInfo utility issues
  Prepare the following MustGather information before you call IBM Support to help with MigrateEncryptedInfo utility issues.

• Collecting MustGather data for Sterling OMS heartbeat issues
  Prepare the following MustGather information before you call IBM Support to help with Sterling OMS heartbeat issues.

• Collecting MustGather data for Sterling inventory issues
  Prepare the following MustGather information before you call IBM Support to help with Sterling inventory issues; including availability, syncronization, and reservations.

• Collecting MustGather data for Sterling order history issues
  Prepare the following MustGather information before you call IBM Support to help with Sterling order history issues.

• Collecting MustGather data for Sterling order transfer issues
  Prepare the following MustGather information before you call IBM Support to help with Sterling order transfer issues.

• Collecting MustGather data for Commerce Composer issues
  Prepare the following MustGather information before you call IBM Support to help with Commerce Composer issues.

• Collecting MustGather data for SEO issues
  Prepare the following MustGather information before you call IBM Support to help with SEO issues.

• Collecting MustGather data for SEOURLKEYWORDGEN issues
  Prepare the following MustGather information before you call IBM Support to help with SEOURLKEYWORDGEN issues.

• Collecting MustGather data for Store Management issues
  Prepare the following MustGather information before you call IBM Support to help with Store Management issues.

• Collecting MustGather data for authoring workspaces issues
  Prepare the following MustGather information before you call IBM Support to help with authoring workspaces issues.

Related concepts
Logging services