MustGather: Performance monitoring infrastructure (PMI) and performance tool problems
 Technote (troubleshooting)
 
Problem(Abstract)
Collecting data for problems with the WebSphere® Application Server PMI and Performance Tools (for example, Tivoli® Performance Viewer, Resource Analyzer, Performance Advisors). Gathering this information before calling IBM® support helps familiarize you with the troubleshooting process and saves you time.
 
Resolving the problem

1. Learning more 2. Troubleshooting 3. Collecting data

If you have already contacted support, continue to the component-specific MustGather information. Otherwise, click: MustGather: Read first for all WebSphere Application Server products.
PMI/Performance Tools specific MustGather information
Process for capturing diagnostic data to resolve problems with the Performance Monitoring Infrastructure (PMI), or tools shipped by WebSphere Application Server that use the PMI (for example, Tivoli Performance Viewer, Resource Analyzer, Performance Advisors).

PMI service is available in application servers and node agents in WebSphere Application Server V5.0, 5.1, 6.0 and 6.1.

When diagnosing problems with the PMI or related tools:
  1. Indicate what you are attempting to monitor (for example, connection pooling activity, JVMPI). Provide configuration about the component that you are monitoring. For example, if you are monitoring connection pool or data source, provide the connection pool or data source configuration.

  2. Identify tools that use PMI:
    • WebSphere Application Server provided tools: Tivoli Performance Viewer, Performance Advisor or Resource Analyzer

    • Third-party tool that interfaces with PMI, such as Wily Introscope, and so on.

  3. Identify all monitoring tools that you run in your environment that might alter the behavior of WebSphere Application Server. This includes plug-ins and applications that replace or augment the classes shipped with WebSphere Application Server.

  4. Identify any configuration changes, like adding a generic server to the configuration.

  5. For PMI apply this trace specification to the processes that you are attempting to monitor. Both the application server and node agent should be traced in a Network Deployment environment:

    com.ibm.ws.pmi.*=all=enabled:
    com.ibm.websphere.pmi.*=all=enabled

  6. For Runtime Performance Advisor, apply this trace specification to the Application Server processes that has performance advisor enabled:

    com.ibm.ws.performance.tuning.*=all=enabled

  7. Indicate if security is enabled. If it is, provide security authentication mechanism configuration. Provide details about any firewalls that you have.

  8. Collect the following information if you are using Tivoli Performance Viewer:
    • Indicate the process to which you are connecting: Deployment manager, Application server, or Node agent.

    • Is Tivoli Performance Viewer running locally or remotely?

    • Is Tivoli Performance Viewer installed using the Custom installation option or is the full WebSphere Application Server image installed?

    • Which connector are you using, SOAP or RMI?

    • If you have connectivity issues, did you try running wsadmin? Is wsadmin able to connect using the SOAP or RMI connector?

      Follow the directions in the appropriate WebSphere Application Server Information Center to configure tracing for Application Server, node agent, administrative server, application client, and so forth (search the information center for Logging and tracing).

  9. If you are using Tivoli Performance Viewer or Resource Analyzer as the PMI client, you can trace these tools:
    • Version 6.0 and 6.1, trace the Deployment Manager with this trace specification (single line):

      UI.TivoliPerformanceViewer=all=enabled:
      TivoliPerformanceViewer=all=enabled:
      com.ibm.ws.performance.tuning.*=all=enabled:
      com.ibm.ws.console.tpv.*=all=enabled:
      com.ibm.ws.tpv.*=all=enabled

    • Version 5.0 and 5.1:

      tperfviewer debug localhost <8880> <SOAP>

  10. Follow instructions to send diagnostic information to IBM support.

For a listing of all technotes, downloads, and educational materials specific to the PMI/Performance tools component, search the WebSphere Application Server support site.
 
Related information
Submitting information to IBM support
Steps to getting support
MustGather: Read first
Troubleshooting guide
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers WebSphere Application Server - Express AIX, HP-UX, Linux, Solaris, Windows 6.1, 6.0, 5.1, 5.0
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > PMI/Performance Tools
Operating system(s): Windows
Software version: 6.1
Software edition:
Reference #: 1141193
IBM Group: Software Group
Modified date: Feb 1, 2007