This repo is a Chef cookbook to install and configure JMXTrans and was originally developed by Bryan Berry. Thanks Bryan!!. Since Bryan is no longer maintaining the original repo, this repo was created with his permission and is maintained here.
jmxtrans is an excellent tool for transporting jmx data from your VMs and into a graphing tool like graphite or ganglia. This cookbook only supports writing to graphite but could be easily modified to work with ganglia
- Depends on the ark cookbook
- JMXTrans is java based and Java need to be installed for it to start and
run successfully. So
javacookbook is suggested.
node['jmxtrans']['graphite']['host']- defaults to 'graphite'node['jmxtrans']['graphite']['port']- default to 2003node['jmxtrans']['servers']- array of servers to query for jmx data along with the properties needed to access each onenode['jmxtrans']['root_prefix']- root prefix for the graphite buckets, defaults to "jmx"
You must override the attribute node['jmxtrans']['servers'] with the
list of servers you want monitored and their respective properties
the following example comes from a role
:jmxtrans => {
:servers =>[
{
'name' => 'foo1.example.org',
'port' => "8999",
'type' => 'tomcat',
'username' => 'foobar',
'password' => 'rw'
},
{
'name' => 'foo2.example.org',
'port' => "8999",
'type' => 'tomcat',
'username' => 'foobar',
'password' => 'baz'
}
]
}
chef-bach bcpc_jmxtrans cookbook is an example of how this community cookbook can be used using a wrapper cookbook.
Copyright 2015, Apache 2.0 license
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either expressed or implied. See the license for the specific language governing permissions and limitations under the license.
- Fork the repository on Github
- Create a named feature branch (like add-component-x)
- Make your code changes
- Test that your changes work, for example with Vagrant
- Submit a Pull Request using Github