NAME

Munin::Node::Client - Client module for munin nodes.

SYNOPSIS

  use Munin::Node::Client;

  my $node = Munin::Node::Client->connect(Host => '127.0.0.1',
                                          Port => '4949');

  my $version    = $node->version;
  my @hostnames  = $node->nodes;   # get the hostnames
  my @items      = $node->list();  # or $node->list($hostnames[0]);

  $node->quit;

DESCRIPTION

Munin::Node::Client is a client module for munin nodes. This helps simple scripts to talk to munin nodes.

FUNCTIONS

Here all functions are specified, for all functions that return in list context (such as with hashes), the scalar context is undocumented and might get a function in the future.

connect(host => $hostname, port => $port)

Connects to a node and returns an Munin::Node::Client object. Currently only support plain connections, ssl and tls are planned. Returns undef if connection fails (and $! probably contains something useful). Returns false if connection is not a munin connection. my $node = Munin::Node::Client->connect(Host => '127.0.0.1:4949');

error();

Returns the last error message. print $node->error();

version()

Returns the node's version my $version = $node->version();

nodes()

Returns the available hostnames on this 'node' in a list. my @hosts = $node->nodes(); print "$_\n" for(@plugins);

hosts()

list($node)

Returns the list of plugins for a host (or default host when left out) my @plugins = $node->list($host); print "$_\n" for(@plugins);

config($plugin)

Returns the configuration settings of a plugin as a hash with hasrefs my %config = config($plugin); my $globals = $config{globals}; my $datasrc = $config{datasource}; print $globals{graph_title}; print $datasrc{system}->{label};

fetch($plugin)

Returns the values of a plugin as a hash my %value = fetch($plugin); print $value{system};

quit()

quits/disconnects the connection to the node. $node->quit();

disconnect()

alias for quit

SEE ALSO

IO::Socket::INET

AUTHOR

Sebastian Stellingwerff <sebastian@expr42.net>

COPYRIGHT AND LICENSE

Copyright (C) 2008 by Sebastian Stellingwerff

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.0 or, at your option, any later version of Perl 5 you may have available.