Plugin-Gallery: Better 2nd level headings

plugins/synology/snmp__synology_temperature

@@ -0,0 +1,91 @@
+#!/usr/bin/perl -w
+# -*- cperl -*-
+# vim: ft=perl
+
+=head1 NAME
+
+snmp__syno_temperature - Munin plugin to retrieve current temperature from a 
+Synology NAS.
+
+=head1 APPLICABLE SYSTEMS
+
+Any Synology NAS device which provides the synoSystem 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
+
+This plugin queries the current temperature of the NAS.
+
+=head1 MIB INFORMATION
+
+This plugin requires support for the synoSystem MIB by Synology.
+It reports the contents of the temperature OID.
+
+=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.1.2.0 [0-9]\n"; # Number
+        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 Temperatures
+graph_args --base 1000 -l 0
+graph_vlabel Degrees Celsius
+graph_category sensors
+graph_info This graph shows the temperature of the diskstation.
+temp.label CPU
+temp.info The temperature of the onboard CPU.
+";
+        exit 0;
+}
+
+my $session = Munin::Plugin::SNMP->session(-translate =>
+                                           [ -timeticks => 0x0 ]);
+
+my $temp = $session->get_single (".1.3.6.1.4.1.6574.1.2.0") || 'ERROR';
+
+print "Retrived uptime is '$temp'\n" if $Munin::Plugin::SNMP::DEBUG;
+
+print "temp.value ", $temp, "\n";