Ganglia::Gmetric::XS - send a metric value to gmond with libganglia C library
use Ganglia::Gmetric::XS; my $gg = Ganglia::Gmetric::XS->new(config => "/etc/gmond.conf"); $gg->send(name => "db_conn", value => 32, type => "uint32", units => "connection", ); my $gg = Ganglia::Gmetric::XS->new( config => "/etc/gmond.conf", spoof => 'aServer:192.168.1.3' ); $gg->heartbeat();
Ganglia::Gmetric::XS can send a metric value to gmond with libganglia C library.
$gg = Ganglia::Gmetric::XS->new( %option );
This method constructs a new "Ganglia::Gmetric::XS" instance and returns it. %option may have the following keys:
Example: "/etc/gmond.conf" - The configuration file to use for finding send channels
If this object should spoof every metric value sent to gmond, then the spoof IP Address and hostname (colon separated) may be specified here.
$gg->send( %param ) or carp "failed to send metric";
send a metric value. %param is following:
KEY VALUE ---------------------------- name name of the metric value value of the metric type either string|int8|uint8|int16|uint16|int32|uint32|float|double units unit of measure for the value e.g. "Kilobytes", "Celcius" group group name of metric. (optional) desc description of metric. (optional) title title of metric. (optional) spoof IP address and hostname (colon separated) of the host to spoof (optional)
$gg->heartbeat( %param )
If you are spoofing the existence of a host, you will need to periodically send heartbeat messages to tell gmond that the host is up.
send a heartbeat. %param is following:
KEY VALUE ---------------------------- spoof IP address and hostname (colon separated) of the host to spoof (optional)
http://ganglia.info
HIROSE Masaaki, <hirose31@gmail.com>
<hirose31@gmail.com>
http://github.com/hirose31/ganglia-gmetric-xs/tree/master
Please report any bugs or feature requests to bug-ganglia-gmetric-xs@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-ganglia-gmetric-xs@rt.cpan.org
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Ganglia::Gmetric::XS, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Ganglia::Gmetric::XS
CPAN shell
perl -MCPAN -e shell install Ganglia::Gmetric::XS
For more information on module installation, please visit the detailed CPAN module installation guide.