No JMX metrics from Tomcat after Deploying the "AllAppserver" agent.

book

Article ID: 4464

calendar_today

Updated On:

Products

APP PERF MANAGEMENT CA Application Performance Management Agent (APM / Wily / Introscope) CUSTOMER EXPERIENCE MANAGER INTROSCOPE

Issue/Introduction

 When a new Introscope Java agent is deployed to a Tomcat app server from the "allappserver" tarball package and Tomcat is configured to use the agent and to report JMX data, then JMX metric data is not visible within the Introscope Investigator.  This is true regardless of the PBD selection (typical versus full) with agent-side JMX functions fully enabled (introscope.agent.jmx.enable=true and no filter specified in introscope.agent.jmx.name.filter).

Cause

 The "allappserver" flavor of the Introscope agent tarball is, as the name implies, all-encompassing to include configurations suitable for the many application servers that the agent supports.  It is shipped with a directory structure and file content suitable for use on many different app servers.  One side-effect of this is that the one extension needed for JMX metric functionality is not in the directory location that the Tomcat agent requires: WebAppSupport.jar.  This jar is shipped in the "allappserver" tarball within the wily/common/ directory.  However for JMX metrics from a Tomcat agent to report to Introscope, this jar must reside within the wily/core/ext/ directory instead.

Environment

Any operating system supported by the agent and Tomcat app server combination.

Resolution

  1. If the agent is running, stop the agent by stopping Tomcat.
  2. Move WebAppSupport.jar from the agent's wily/common/ directory to the agent's wily/core/ext/ directory.
  3. Start the agent by starting Tomcat.
  4. Within Introscope Investigator, confirm that you can see JMX metrics for this agent.

Additional Information

  • This is not an issue if deploying a Tomcat agent from the interactive installer as the WebAppSupport.jar will be properly placed in the wily/core/ext/ directory.
  • This is not an issue if deploying a Tomcat agent from the Tomcat-specific "no installer" agent tarball as the WebAppSupport.jar is properly located within the wily/core/ext/ directory within the tarball.