diff --git a/plugins/other/oracle-pga-monitor b/plugins/other/oracle-pga-monitor new file mode 100755 index 00000000..4b710935 --- /dev/null +++ b/plugins/other/oracle-pga-monitor @@ -0,0 +1,122 @@ +#! /usr/bin/ruby +# +# Munin Plugin for PGA memory components monitoring +# +# Author: Wilfred Chau +# Date: 2011-05-13 +# Version: 1.0 +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License version 2 +# as published by the Free Software Foundation. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License along +# with this program; if not, write to the Free Software Foundation, Inc., +# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. +# +# +# Prerequistes: +# 1) env.ORACLE_HOME set in munin-node +# 2) rubygems +# 3) oci8 - DBI gem for connecting to Oracle +# * instruction of installing oci8 is available here: +# http://ruby-oci8.rubyforge.org/en/InstallBinaryPackage.html +# +# Usage: +# 1) copy this script to the munin install plugins directory (e.g. /usr/share/munin/plugins) +# 2) chmod to allow executable to others +# 3) create symbolic link in /etc/munin/plugins +# ln -s /usr/share/munin/plugins/oracle__pga.rb /etc/munin/plugins/oracle__pga.rb +# ** replace with your oralce sid +# +# Parameters: +# autoconf +# config (required) +# +# Configurable variables: +# orauser : oracle user who has select priviledge to query v$pgastat view +# orapass : password for the oracle user +# dbport : port used by the monitored instance (notice: numeric value) +# dbname : database to be monitored +# dbhost : host or ip address of db instance +# +# +#%# family=auto +#%# capabilities=autoconf + +require 'rubygems' +require 'oci8' + +orauser = 'munin' +orapass = 'munin' +dbport = 1522 +dbname = 'orcl' +dbhost = 'localhost' + +tnsname = "(DESCRIPTION = + (ADDRESS = (PROTOCOL = TCP)(HOST = #{dbhost})(PORT = #{dbport})) + (CONNECT_DATA = (SID = #{dbname})))" + +def runQuery (name,query) + rows = $conn.exec(query) + puts "#{name}.value #{rows.fetch().to_s}" + rows.close +end + + +# +# Queries +# +pga_target_query = "SELECT TO_CHAR(ROUND(decode(unit,'bytes',(value)/(1024*1024),value),2)) pga_target + from V$PGASTAT where name = 'aggregate PGA target parameter'" + +pga_query = "SELECT TO_CHAR(ROUND(decode(unit,'bytes',(value)/(1024*1024),value),2)) pga + from V$PGASTAT where name = 'total PGA inuse'" + +pga_components = { "pga_target" => pga_target_query, + "pga_in_use" => pga_query + } + +# +# autoconf +# +if ARGV[0] == "autoconf" + if tnsname.length > 1 && orauser.length > 1 && orapass.length > 1 + puts "yes" + else + puts "no" + puts "Usage: #{__FILE__} autoconf|conf" + end + exit 0 +# +# config definition +# +elsif ARGV[0] == "config" + puts "graph_args --base 1024k -r --lower-limit 0" + puts "graph_title Oracle PGA from #{dbname}" + puts "graph_category Oracle" + puts "graph_info This graph shows the PGA memory usage (in MB)" + puts "graph_vlabel MB" + puts "graph_scale no" + puts "graph_period second" + + pga_components.keys.each do |p| + puts "#{p}.label #{p}" + puts "#{p}.info PGA: #{p}" + puts "#{p}.type GAUGE" + puts "#{p}.draw LINE1" + end + + exit 0 +end + +$conn = OCI8.new(orauser, orapass, tnsname) +pga_components.each do |pc, query| + runQuery(pc, query) +end +$conn.logoff