Monitoring and Profiling Bamboo
On this page
Summary
This article helps you to setup profiling for Bamboo. Profiling information can be useful for monitoring bamboo's performance, memory consumption, and the server's CPU load
Profiling with JMX after Bamboo version 7.0
- You can enable profiling with JMX using the following steps:
- Edit the file <Bamboo-Install>\bin\setenv.sh
- Change the following line ${JVM_SUPPORT_RECOMMENDED_ARGS:="" and add the below options:
| Java Option | Definition |
|---|---|
com.sun.management.jmxremote.port=portNum | To enable monitoring and management from remote systems, |
com.sun.management.jmxremote.authenticate=<true|false> | To enable/disable password authentication |
com.sun.management.jmxremote.ssl=<true|false> | To enable/disable SSL |
- Restart Bamboo
Example:
Enabling profiling on port 8999 with no SSL or password authentication
${JVM_SUPPORT_RECOMMENDED_ARGS:="-Dcom.sun.management.jmxremote.port=8999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false"}Use Jconsole to test login
For more options on using SSL or password authentication please refer to the following document Monitoring and Management Using JMX Technology
Profiling with JMX prior Bamboo version 7.0
Enabling the profiler
JMX is Sun's native java platform monitor . JConsole can be used to visualize the profiling data.
To enable JMX add -Dcom.sun.management.jmxremote (or -Dcom.sun.management.jmxremote.port=<portNum> for remote monitoring) as a command line argument when starting bamboo.
For Unix : add the parameter to the RUN_CMD line in bamboo.sh
For Windows : add the parameter to the .\conf\wrapper.conf file as wrapper.java.additional.4=-D....
Restart Bamboo.
Does not work when bamboo is run as a windows service
At the moment profiling via JMX only works when bamboo is run as a console application on windows.
Running bamboo as a windows service with profiling is currently not supported.
Monitoring and Controlling the Profiler with JConsole
Please refer to Sun's documentation
Profiling with Yourkit
Installing Yourkit
Yourkit is an alternative (commercial) java profiler.
Follow the installation instructions for your platform.
You do not need a license if you just run the profiling agent with bamboo.
Enabling the profiler
Add -agentlib:yjpagent=onexit=snapshot to the command line in bamboo.sh or as an additional parameter to wrapper.conf
Then follow the instructions on enabling the profiler manually for your platform.
Restart Bamboo.