Initial version

plugins/other/ag241-adsl

@@ -0,0 +1,132 @@
+#!/usr/bin/ruby
+# munin plugin to retrieve connection statistics from the web admin interface
+# on a Linksys AG241v2 ADSL modem
+# Makes use of the http://modemaddress/ADSLCStatus.htm page
+
+#This plugin has only been tested on a Debian testing system
+
+# This modem also has some basic SNMP support so you can configure it
+# as per the instructions on the munin wiki
+# http://munin.projects.linpro.no/wiki/Using_SNMP_plugins
+# By default the SNMP server is disabled, you can enable it in the web admin
+# You will need to set up the "virtual node" configuration as detailed 
+# for snmp plugins
+
+# Plugin will require some configuration in /etc/munin/plugin-conf.d/ag241_MODEMADDRESS
+# e.g.
+# [ag241_vocume.stargate_*]
+# env.user admin
+# env.pass password
+# #env.port 80
+
+# Once you have the above config set you will need to symlink the plugin to
+# /etc/munin/plugins/ag241_MODEMADDRESS_syncrate
+# /etc/munin/plugins/ag241_MODEMADDRESS_attenutation
+# /etc/munin/plugins/ag241_MODEMADDRESS_noise
+# now restart munin-node.
+# hopefully in 20-30mins you will have some nice graphs
+
+
+#Some magical munin foo...
+#%# family=manual
+#%# capabilities=
+
+# Require this module, it is part of the standard ruby lib AFAIK
+require 'net/http'
+
+#default parameters
+host = nil 
+port = ENV['port'] || 80
+user = ENV['user'] || 'admin'
+pass = ENV['pass'] || 'forhax' #dont remember what the default admin password was
+stat = nil
+
+# Check executeable "name" for parameter count
+params = $0.split('_')
+if params.size != 3
+	puts "Incorrect number of parameters"
+	exit 1
+end
+
+# first param after the plugin name is the host to query
+# second is the statistic to query
+host = params[1]
+stat = params[2]
+
+unless ENV['debug'].nil?
+	puts "user = "+ user
+	puts "pass = "+ pass
+	puts "host = "+ host
+	puts "port = "+ port
+	puts "stat = "+ stat
+end
+
+# Dump the graph configuration data
+if ARGV[0] == 'config'
+	puts 'host_name ' + host
+	puts 'graph_category network'
+
+	case stat
+		when 'syncrate'
+			puts 'graph_info This graph shows the ADSL line sync rate.'
+			puts 'graph_title ADSL line sync rate'
+		        puts 'graph_vlabel connection rate bits / second'
+			puts 'graph_args --base 1000 -l 0 '
+		when 'attenuation'
+			puts 'graph_info This graph shows the ADSL line attenuation.'
+			puts 'graph_title ADSL line attenuation'
+		        puts 'graph_vlabel attenuation dB'
+		when 'margin','noise'
+			puts 'graph_info This graph shows the ADSL SNR margin.'
+			puts 'graph_title ADSL line SNR margin'
+		        puts 'graph_vlabel noise margin dB'
+	end
+        puts 'down.label downstream'
+        puts 'up.label upstream'
+	exit 0
+end
+
+# Connect to the webadmin
+http = Net::HTTP.start(host,port)
+req = Net::HTTP::Get.new('/ADSLCStatus.htm')
+# send the login info
+req.basic_auth user, pass
+response = http.request(req)
+s = response.body
+
+#Make sure we got the page successfully
+if response.code != '200'
+	puts "Getting web page failed:"
+	case response.code
+		when '401'
+			puts 'Probably because the username and password are incorrect'
+		#Looks like the modem respons with 200 when you try to access a page that doesnt exist >_>
+		#when '404'
+		#	puts 'Looks like the page this plugin needs isn\'t availible...'
+		#	puts 'Check your modem make/model/version'
+	end
+	puts s
+	exit 1
+end
+
+# Apply voodoo regex to the result HTML to get the data we want.
+case stat
+     when 'syncrate'
+          a = s.scan(/.*share\.curstate.*\n.*share\.downstr[^0-9]*([0-9]+).*share\.upstr[^0-9]*([0-9]+).*$/)
+          b,c = a[0]
+          puts  'down.value '+ (b.to_i*1000).to_s + "\n" + 'up.value '+ (c.to_i*1000).to_s
+	  exit 0
+     when 'attenuation'
+          a = s.scan(/.*share\.lineatt.*\n.*share\.down[^0-9]*([0-9]+).*share\.up[^0-9]*([0-9]+).*$/)
+          b,c = a[0]
+          puts 'down.value '+ (b.to_i).to_s + "\n" + 'up.value '+ (c.to_i).to_s
+	  exit 0
+     when 'margin','noise'
+          a = s.scan(/.*share\.noise.*\n.*share\.down[^0-9]*([0-9]+).*share\.up[^0-9]*([0-9]+).*$/)
+          b,c = a[0]
+          puts 'down.value '+ (b.to_i).to_s + "\n" + 'up.value '+ (c.to_i).to_s
+	  exit 0
+     else
+	puts 'Statistic ' + stat.to_s + ' not known, would you like me to fabricate it for you?'
+	exit 1
+end