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

Document ID : KB000004464
Last Modified Date : 14/02/2018
Show Technical Document Details
Issue:

 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).

Environment:
Any operating system supported by the agent and Tomcat app server combination.
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.

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.