Fabrice Gabolde > Zabbix-API-0.009 > Zabbix::API::Graph

Download:
Zabbix-API-0.009.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Source  

NAME ^

Zabbix::API::Graph -- Zabbix graph objects

SYNOPSIS ^

  use Zabbix::API::Graph;

  # TODO write the rest

DESCRIPTION ^

Handles CRUD for Zabbix graph objects.

This is a subclass of Zabbix::API::CRUDE.

METHODS ^

items([ITEMS])

Trivial mutator for the gitems array.

push()

This method handles extraneous item => Zabbix::API::Item attributes in the gitems array, transforming them into itemid attributes, and pushing the items to the server if they don't exist already. The original item attributes are kept but hidden from the CRUDE push method, and restored after the pull method is called.

This means you can put Zabbix::API::Item objects in your data and the module will Do The Right Thing (assuming you agree with my definition of the Right Thing). Items that have been created this way will not be removed from the server if they are removed from the graph, however.

Overriden from Zabbix::API::CRUDE.

url([width => WIDTH], [period => PERIOD], [start_time => START_TIME])

This method returns a URL to an image on the Zabbix server. The image of width WIDTH will represent the current graph, plotted for data starting at START_TIME (a UNIX timestamp) over PERIOD seconds. It uses the current connection's host name to guess what path to base the URL on.

All three parameters are optional.

If the current user agent has cookies enabled, you can even fetch the image directly, since your API session is completely valid for all regular requests:

  my $zabbix = Zabbix::API->new(server => ...,
                                ua => LWP::UserAgent->new(cookie_jar => { file => 'cookie.jar' }),
                                ...);
  my $graph = $zabbix->fetch_single('Graph', ...);
  my $response = $zabbix->{ua}->get($graph->url);
  open my $image, '>', 'graph.png' or die $!;
  $image->print($response->decoded_content);
  $image->close;

SEE ALSO ^

Zabbix::API::CRUDE.

AUTHOR ^

Fabrice Gabolde <fabrice.gabolde@uperto.com>

COPYRIGHT AND LICENSE ^

Copyright (C) 2011 SFR

This library is free software; you can redistribute it and/or modify it under the terms of the GPLv3.

syntax highlighting: