contrib-munin/plugins/synology/snmp__synology_ups

#!/usr/bin/perl -w
# -*- cperl -*-
# vim: ft=perl

=head1 NAME

snmp__syno_ups - Munin plugin to retrieve various information of the
UPS attached to a Synology NAS.

=head1 APPLICABLE SYSTEMS

Any Synology NAS device which provides the synoUPS MIB.

=head1 CONFIGURATION

As a rule SNMP plugins need site specific configuration.  The default
configuration (shown here) will only work on insecure sites/devices.

   [snmp_*]
        env.version 2
        env.community public

In general SNMP is not very secure at all unless you use SNMP version
3 which supports authentication and privacy (encryption).  But in any
case the community string for your devices should not be "public".

Please see 'perldoc Munin::Plugin::SNMP' for further configuration
information.

=head1 INTERPRETATION

The plugin reports the following stats about the UPS attached:
 - Load in %
 - Charge in %

=head1 MIB INFORMATION

This plugin requires support for the synoUPS MIB by Synology.

=head1 MAGIC MARKERS

  #%# family=snmpauto
  #%# capabilities=snmpconf

=head1 VERSION

  $Id$

=head1 BUGS

None known.

=head1 AUTHOR

Copyright (C) 2015 Thomas Arthofer

=head1 LICENSE

GPLv2 or (at your option) any later version.

=cut

use strict;
use Munin::Plugin::SNMP;

if (defined $ARGV[0] and $ARGV[0] eq "snmpconf") {
        print "require 1.3.6.1.4.1.6574.4.3.1.1.0 [0-9]\n"; # Charge
        print "require 1.3.6.1.4.1.6574.4.2.12.1.0 [0-9]\n"; # Load
        exit 0;
}

if (defined $ARGV[0] and $ARGV[0] eq "config") {
    my ($host) = Munin::Plugin::SNMP->config_session();
        print "host_name $host\n" unless $host eq 'localhost';
        print "graph_title UPS
graph_args --base 1000 -l 0
graph_vlabel Status of UPS
graph_category sensors
graph_info This graph shows the status of the attached UPS.
charge.label Charge
charge.info Charge status of battery.
charge.draw LINE2
load.label Load
load.info Load on the UPS
";
        exit 0;
}

my $session = Munin::Plugin::SNMP->session(-translate =>
                                           [ -timeticks => 0x0 ]);

my $charge = $session->get_single (".1.3.6.1.4.1.6574.4.3.1.1.0") || 'ERROR';
$charge = unpack "f", reverse pack "H*", $charge;

my $load = $session->get_single (".1.3.6.1.4.1.6574.4.2.12.1.0") || 'ERROR';
$load = unpack "f", reverse pack "H*", $load;

print "Retrived charge '$charge'\n" if $Munin::Plugin::SNMP::DEBUG;
print "Retrived load '$load'\n" if $Munin::Plugin::SNMP::DEBUG;

print "charge.value ", $charge, "\n";
print "load.value ", $load, "\n";