General Info

Vendor	JetBrains
License	Apache 2.0
Type	free, open-source

Plugin Description

Allows to take CPU and memory profiling snapshots of the TeamCity server right from the web UI.

Installation

• Install the plugin (instructions). (The following files are available on the plugin download page.)
  1. copy serverProfile.jar - plugin itself (should be copied to WEB-INF/lib)
  2. copy yjp-controller-api-redist.jar - required library from YourKit Java Profiler (should be copied to WEB-INF/lib)
  3. copy files from the bin/<your platfom> directory to the <TeamCity Home>/bin directory. Here <your platfom> is the name of your platform, like win32 for Windows XP, win-amd64 for Windows XP x64 Edition, etc.
  4. add -agentlib:yjpagent JVM parameter to the TeamCity server startup script. This can be done by adding the parameter to the TEAMCITY_SERVER_OPTS environment variable if you start TeamCity by its scripts. You can check that the parameter is set correctly by making sure the lines starting with "[YourKit Java Profiler 7.0.12]" appear in your server console/output.

Usage

To start the profiling navigate to the Administration > Server Configuration page, TeamCity Server Profiler section

• On capturing the snapshot, the path to the saved snapshot is displayed. The profiling activity is logged into the server's console.
• Send the profiling results to the TeamCity Developers with a description of the problem.

CPU Profiling

• Click "Start" to start profiling
• Perform the action to reproduce the CPU load
• Click "Capture" to capture profiling snapshot, or "Cancel" to cancel profiling.

Memory Profiling

• When you believe that the memory consumption by the TeamCity server process is high, click "Capture" to capture the snapshot.
  Please note the this operation blocks server until the snapshot is fully captured. The UI for all the server users will not be refreshed until the snapshot is taken.

Development links

Sources
Builds at JetBrains public TeamCity instance.

TeamCity Versions Compatibility

The current plugin version is designed to work with TeamCity 3.1 and up.
Tested with TeamCity 3.1.1

History

Date	Build	Changes
April, 24, 2008	17	Added memory capturing ability, UI facelift, better errors reporting
April, 21, 2008	15	Initial release

Download

Directly from public TeamCity server:
last stable build
last nightly build (may be unstable)