Manages ganglia gmond & gmetad daemons + web front end
This is a puppet module for installation and configuration of the
ganglia gmond & gmetad daemons + web
front end.
This class manages the configurtion of the Ganglia gmond daemon.
Following options/settings are only taken into account for RHEL6/CentOS6 as of now:
- gmond globals: globals_deaf, globals_host_dmax and globals_send_metadata_interval
- udp_send_channel setting: bind_hostname For other OSes, we have the following behavior:
- gmond globals take the default values provided below
- udp_send_channel->bind_hostname is not taken into account
# unicast
$udp_recv_channel = [
{ port => 8649, bind => 'localhost' },
{ port => 8649, bind => '0.0.0.0' },
]
$udp_send_channel = [
{ port => 8649, host => 'test1.example.org', ttl => 2 },
{ port => 8649, host => 'test2.example.org', ttl => 2 },
{ bind_hostname => "yes", host => 'test3.example.org', ttl => 1 },
]
$tcp_accept_channel = [
{ port => 8649 },
]
# multicast
$udp_recv_channel = [
{ mcast_join => '239.2.11.71', port => 8649, ttl => 1 }
]
$udp_send_channel = [
{ mcast_join => '239.2.11.71', port => 8649, bind => '239.2.11.71' }
]
$tcp_accept_channel = [
{ port => 8649 },
]
class{ 'ganglia::gmond':
globals_deaf => 'yes',
globals_host_dmax => '691200',
globals_send_metadata_interval => '60'
cluster_name => 'example grid',
cluster_owner => 'ACME, Inc.',
cluster_latlong => 'N32.2332147 W110.9481163',
cluster_url => 'www.example.org',
host_location => 'example computer room',
udp_recv_channel => $udp_recv_channel,
udp_send_channel => $udp_send_channel,
tcp_accept_channel => $tcp_accept_channel,
}-
globals_deafStringdefaults to:no -
globals_host_dmaxStringdefaults to:0 -
globals_send_metadata_intervalStringdefaults to:300 -
cluster_nameStringdefaults to:unspecified -
cluster_ownerStringdefaults to:unspecified -
cluster_latlongStringdefaults to:unspecified -
cluster_urlStringdefaults to:unspecified -
host_locationStringdefaults to:unspecified -
udp_send_channelArray of Hashdefaults to:[ { mcast_join => '239.2.11.71', port => 8649, ttl => 1 } ] -
udp_recv_channelArray of Hashdefaults to:[ { mcast_join => '239.2.11.71', port => 8649, bind => '239.2.11.71' } ] -
tcp_accept_channelArray of Hashdefaults to:[ { port => 8659 } ]
$clusters = [
{
name => 'test',
address => ['test1.example.org', 'test2.example.org'],
},
]
class{ 'ganglia::gmetad':
clusters => $clusters,
gridname => 'my grid',
}-
clustersArray of Hashdefaults to:[ { 'name' => 'my cluster', 'address' => 'localhost' } ] -
gridnameStringdefaults to:undef
class{ 'ganglia::web': }
class{ 'ganglia::web':
$ganglia_ip = '192.168.0.1',
$ganglia_port = 8652,
}-
ganglia_ipStringdefaults to:127.0.0.1 -
ganglia_portStringdefaults to:8652
It has been tested on:
- el5.x
- el6.x
- ubuntu 12.04
- ubuntu 13.04
- debian 6.07
As of 2012-11-16, the stable EPEL repos for el5 and el6 contain, respectively, packages for ganglia 3.0.7 and 3.1.7. The ganglia UDP protocol for communication between gmond daemons changed incompatibly between 3.0.x and 3.1.x. However, the TCP based protocol gmetad uses to poll gmond agents has remained compatible.
If it's desirable to stick with the EPEL packages, a possible way of dealing with this is divide a group of hosts into two clusters based on $::lsbmajdistrelease (which should imply gmond version without having to install a custom fact). The example below divides the previous "mycluster" into "mycluster_el5" and "mycluster_el6". Note that you will also have to configure gmetad to pull a gmond agent from each of these new clusters.
$udp_recv_channel = [
{ port => 8649, bind => 'localhost' },
{ port => 8649, bind => '0.0.0.0' },
]
case $::lsbmajdistrelease {
5: {
# epel for el5.x has 3.0.x, which will not work with gmond in 3.1.x
$udp_send_channel = [
{ port => 8649, host => 'gmond-3-0_host1.example.org', ttl => 2 },
{ port => 8649, host => 'gmond-3-0_host2.example.org', ttl => 2 },
]
$cluster_name = 'mycluster_el5'
}
6, default: {
# epel for el6.x has 3.1.x
$udp_send_channel = [
{ port => 8649, host => 'gmond-3-1_host1.example.org', ttl => 2 },
{ port => 8649, host => 'gmond-3-1_host2.example.org', ttl => 2 },
]
$cluster_name = 'mycluster_el6'
}
}
$tcp_accept_channel = [
{port => 8649},
]
class{ 'ganglia::gmond':
cluster_name => 'example grid',
cluster_owner => 'ACME, Inc.',
cluster_latlong => 'N32.2332147 W110.9481163',
cluster_url => 'www.example.org',
host_location => 'example computer room',
udp_recv_channel => $udp_recv_channel,
udp_send_channel => $udp_send_channel,
tcp_accept_channel => $tcp_accept_channel,
}This module is versioned according to the Semantic Versioning 2.0.0 specification.
Please log tickets and issues at github