MustGather: Performance monitoring infrastructure (PMI) and performance tool problems

Technote (FAQ)
Problem
MustGather for problems with the WebSphere® Application Server PMI and Performance Tools component (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.
Solution
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 5.0.

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 are you are monitoring. For example, if you are monitoring connection pool/data source, provide the connection pool/data source configuration.

  2. Identify tools that use PMI:

    • WebSphere-shipped tools: Tivoli Performance Viewer, Performance Advisor or Resource Analyzer

    • Third party tool that interfaces with PMI, such as Wily Introscope, etc.

  3. Identify all monitoring tools that you run in your environment that might alter the behavior of WebSphere. 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/Tivoli Performance Viewer apply this trace specification to the processes that you are attempting to monitor:

    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 Information Center, http://www-3.ibm.com/software/webservers/appserv/infocenter.html to configure tracing for Application Server, node agent, administrative server, application client, and so forth.

    • Instructions for WebSphere Application Server Version 4:

      1. Select WebSphere Application Server V4.0 Information Center.

      2. Select section 8.3: Logs and Traces.
    • Instructions for WebSphere Application Server Version 5:

      1. Select WebSphere Application Server V5.0 Information Center.
        Select WebSphere Application Server V5.1 Information Center.

      2. Search for Logging and tracing.

  9. If you are using Tivoli Performance Viewer or Resource Analyzer as the PMI client, you can trace these tools:

  10. Follow instructions tosend 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












Document Information

Product categories: Software, Application Servers, Distributed Application & Web Servers, WebSphere Application Server, PMI/Performance Tools
Operating system(s): AIX, HPUX, Linux, Multi-Platform, Solaris, Windows
Software version: 3.5, 4.0, 5.0, 5.1, 6.0
Software edition: Edition Independent
Reference #: 1141193
IBM Group: Software Group
Modified date: 2005-01-04