Enabling the YourKit Profiler with tc Server running in SpringSource Tool Suite (2000980)

Products

• VMware

Issue/Introduction

The YourKit profiler is a popular way to profile a Java applications.  In addition to plain Java applications, YourKit can be used to profile a web application running in tc Server.  This article outlines the instructions for configuring tc Server & YourKit when tc Server is running inside of SpringSource Tool Suite.

Environment

Resolution

For the purposes of this article, it will be assumed that YourKit is installed into the /opt/yjp-9.5.4 directory.  The exact installation path and version number may vary based on the installation of YourKit.

The following steps document how to integrate the YourKit profiler with a tc Server instance running inside of STS.

1. Go to the Servers tab in STS, double-click on your tc Server instance.

2. Click the Open launch configuration link.

3. Click on the Arguments tab.

4. Add one of these lines to the beginning of the VM arguments textbox.  Please note that the following examples are specific for 32-bit and 64-bit Linux, if using a different OS, look into the bin directory of the YourKit installation for the specific path to the YourKit agent library.
   
   Example for the Linux 32-bit Java:

   -agentpath:/opt/yjp-9.5.4/bin/linux-x86-32/libyjpagent.so=disablestacktelemetry,disableexceptiontelemetry,builtinprobes=none,delay=10000

   Example for the Linux 64-bit Java:

   -agentpath:/opt/yjp-9.5.4/bin/linux-x86-64/libyjpagent.so=disablestacktelemetry,disableexceptiontelemetry,builtinprobes=none,delay=10000

5. Restart the tc Server instance.  After restarting, ensure the first line of the Console tab displays, a message similar to this:

   [YourKit Java Profiler 9.5.4] Loaded. Log file: /home/user/.yjp/log/7191.log

   This means that the YourKit profiler has been enabled for the tc Server instance running inside of STS.  If you do not see this line in the log file, please check that the VM arguments were correctly edited in step number four.

6. Start the YourKit application.  The Monitor Local Applications panel should now contain an entry for the tc Server instance (Note: it is actually labeled as Tomcat). Click the link to start profiling an application deployed to the tc Server instance.

 For additional details, please see the manual installation instruction page in the YourKit documentation.

Note: The information provided in this link is provided as is and VMware does not guarantee the accuracy or applicability of this information. The preceding link was correct as of June 25, 2011. If you find the link is broken, provide feedback and a VMware employee will update the link.

 

Additional Information

The content of this article is provided "as-is," and to the maximum extent permitted by applicable law, VMware disclaims all other representations and warranties, express or implied, regarding this content, including their fitness for a particular purpose, their merchantability, or their non-infringement. VMware shall not be liable for any damages arising out of or in connection with the use of this content, including direct, indirect, consequential damages, loss of business profits or special damages, even if VMware has been advised of the possibility of such damages.

©VMware 2013