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;

AUTHOR

Fabrice Gabolde <[email protected]>

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.