NAME
Zabbix::Sender - A pure-perl implementation of zabbix-sender.
VERSION
version 0.03
SYNOPSIS
This code snippet shows how to send the value "OK" for the item
"my.zabbix.item" to the zabbix server/proxy at
"my.zabbix.server.example" on port "10055".
use Zabbix::Sender;
my $Sender = Zabbix::Sender->new({
'server' => 'my.zabbix.server.example',
'port' => 10055,
});
$Sender->send('my.zabbix.item','OK');
NAME
Zabbix::Sender - A pure-perl implementation of zabbix-sender.
SUBROUTINES/METHODS
_init_json
Zabbix 1.8 uses a JSON encoded payload after a custom Zabbix header. So
this initializes the JSON object.
_init_hostname
The hostname of the sending instance may be given in the constructor.
If not it is detected here.
zabbix_template_1_8
ZABBIX 1.8 TEMPLATE
a4 - ZBXD b - 0x01 c4 - Length of Request in Bytes (64-bit integer),
aligned left, padded with 0x00 c4 - dito a* - JSON encoded request
This may be changed to a HashRef if future version of zabbix change the
header template.
_encode_request
This method encodes the item and value as a json string and creates the
required header acording to the template defined above.
_decode_answer
This method tries to decode the answer received from the server.
send
Send the given item with the given value to the server.
Takes two arguments: item and value. Both should be scalars.
DEMOLISH
Disconnects any open sockets on destruction.
AUTHOR
"Dominik Schulz", "<"lkml at ds.gauner.org">"
BUGS
Please report any bugs or feature requests to "bug-zabbix-sender at
rt.cpan.org", or through the web interface at
<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Zabbix-Sender>. I will
be notified, and then you'll automatically be notified of progress on
your bug as I make changes.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc Zabbix::Sender
You can also look for information at:
* RT: CPAN's request tracker
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Zabbix-Sender>
* AnnoCPAN: Annotated CPAN documentation
<http://annocpan.org/dist/Zabbix-Sender>
* CPAN Ratings
<http://cpanratings.perl.org/d/Zabbix-Sender>
* Search CPAN
<http://search.cpan.org/dist/Zabbix-Sender/>
ACKNOWLEDGEMENTS
This code is based on the documentation and sample code found at:
http://www.zabbix.com/wiki/doc/tech/proto/zabbixsenderprotocol
http://www.zabbix.com/documentation/1.8/protocols
LICENSE AND COPYRIGHT
Copyright 2011 Dominik Schulz.
This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
AUTHOR
Dominik Schulz <dominik.schulz@gauner.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2012 by Dominik Schulz.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.