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.

perl v5.14.2                                       2013-04-28                            Zabbix::API::Graph(3pm)