HIROSE Masaaki > Ganglia-Gmetric-XS-1.04 > Ganglia::Gmetric::XS

Download:
Ganglia-Gmetric-XS-1.04.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 1.04   Source  

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",
              units => "connection",
             );



    my $gg = Ganglia::Gmetric::XS->new(
        config => "/etc/gmond.conf",
        spoof => 'aServer:192.168.1.3'
    );
    $gg->heartbeat();

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 may have the following keys:

config

Example: "/etc/gmond.conf" - The configuration file to use for finding send channels

spoof

If this object should spoof every metric value sent to gmond, then the spoof IP Address and hostname (colon separated) may be specified here.

send

  $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)

heartbeat

  $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)

SEE ALSO ^

http://ganglia.info

AUTHOR ^

HIROSE Masaaki, <hirose31@gmail.com>

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.

syntax highlighting: