NAME

Ganglia::Gmetric::XS - send a metric value to gmond with libganglia C library

SYNOPSIS

    use Ganglia::Gmetric::XS;

    my $gg = Ganglia::Gmetric::XS->new(config => "/etc/gmond.conf");
    $gg->send(name  => "db_conn",
              value => 32,
              type  => "uint32",
              unit  => "connection",
             );

DESCRIPTION

Ganglia::Gmetric::XS can send a metric value to gmond with libganglia C library.

METHODS

new

  $gg = Ganglia::Gmetric::XS->new( %option );

This method constructs a new "Ganglia::Gmetric::XS" instance and returns it. %option is following:

  KEY    VALUE
  ----------------------------
  config "/etc/gmond.conf"

send

  $gg->send( %param ) or carp "failed to send metric";

do 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"

SEE ALSO

http://ganglia.info

AUTHOR

HIROSE Masaaki, <hirose@klab.org>

REPOSITORY

http://github.com/hirose31/ganglia-gmetric-xs/tree/master

BUGS

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.

COPYRIGHT & LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.