Repository
Munin (contrib)
Last change
2020-08-25
Graph Categories
Family
auto
Capabilities
Keywords
Language
Bash
License
GPL-2.0-only
Authors

oracle_connections

Sadly there is no documentation for this plugin.

#!/bin/bash
#
# Munin plugin to monitor oracle connections w/o DBD::Oracle, or perl for that
# matter ;-)
#
# Author: Kevin Kunkel (kunkel.kevin@gmail.com) on December 11, 2007
# (Based off the perl munin plugin by Joan Carles Soler)
#
# Licensed under GPL v2.
#
# Usage:
#
#       If required, give username, password and/or oracle server
#       host through environment variables.
#
# Parameters:
#	autoconf
#       config   (required)
#
# Config variables:
#
#       ORACLE_SID        - Which database to use. Defaults to orcl
#       oracle_user       - A oracle user account with read permission to
#                           the v$session view. Defaults to
#                           'oracle'. Anyway, Munin must be told which user
#                           this plugin should be run as.
#       oracle_pass       - The corresponding password, if
#                           applicable. Default to undef.
#
#	SHOW_ORACLE_USERS - If set to 1 show usernames and num. of connections.
#		     Default is not show users (0).
# Magic markers
#%# family=auto
#%# capabilities=autoconf


# Hard-code environment variables here

#oracle_user=
#oracle_pass=
#ORACLE_SID=
#ORACLE_HOME=
#SHOW_ORACLE_USERS=

# End variable hard-code



if [ -z "$ORACLE_HOME" ] ; then
	# Adjust to your oratab locations
	for oratab in /var/opt/oracle/oratab /etc/oratab
	do
		[ ! -f $oratab ] && continue
		IFS=:
		while read SID HOME STARTUP;
		do
			if [ "$SID" = "*" ]
			then
				ORACLE_HOME=$HOME
				break
			fi
		done < $oratab
	[ -n "$ORACLE_HOME" ] && break
	break
	done
fi

if [ -z "$ORACLE_SID" ]
then
	ORACLE_SID="orcl"
fi

if [ -z "$oracle_user" ]
then
	oracle_user="oracle"
fi

if [ -z "$SHOW_ORACLE_USERS" ]
then
	SHOW_ORACLE_USERS=0
else
	if [ $SHOW_ORACLE_USERS -ne 1 ]
	then
		SHOW_ORACLE_USERS=0
	fi
fi

PATH=$PATH:$ORACLE_HOME/bin
export ORACLE_HOME PATH ORACLE_SID

if [ "$1" = "autoconf" ]
then
	echo yes
	exit 0
fi
if [ "$1" = "config" ]
then
	WARN_CRIT=`sqlplus -s ${oracle_user}/${oracle_pass}@$ORACLE_SID << EOF | \
		grep -v '^$' | awk '{print $1 * 0.7 " " $1 * 0.8 }'
set pagesize 0
select value from v\\$parameter where name = 'sessions';
EOF`
	echo "graph_title Oracle active connections to $ORACLE_SID"
	echo "graph_args -l 0 --base 1000"
	echo "graph_vlabel Connections"
	echo "graph_category db"
	echo "graph_info Shows active oracle connections to $ORACLE_SID"
	echo "graph_scale no"
	if [ $SHOW_ORACLE_USERS -eq 1 ]
	then
		sqlplus -s ${oracle_user}/${oracle_pass}@$ORACLE_SID << EOF | \
			grep -v '^$' | awk '{ print $1 ".label " $1 " active connections"
					print $1 ".info " $1 " active connections"
					print $1 ".type GAUGE" }; END {
					print "total.label active connections"
					print "total.info active connections"
					print "total.type GAUGE"
				}'
set pagesize 0
select username, count(username) from v\$session where username is not null group by username;
EOF
		echo $WARN_CRIT| awk '{ print "total.warning " $1 "\ntotal.critical " $2 }'
	else
		echo "connections.label active connections"
		echo "connections.info active connections"
		echo "connections.type GAUGE"
		echo $WARN_CRIT| awk '{ print "connections.warning " $1 "\nconnections.critical " $2 }'
	fi
fi


if [ $SHOW_ORACLE_USERS -eq 1 ]
then
		sqlplus -s ${oracle_user}/${oracle_pass}@$ORACLE_SID << EOF | \
			grep -v '^$'|awk 'BEGIN { total=0 } {
				print $1 ".value " $2
				total=total+$2 } END { print "total.value " total }'
set pagesize 0
select username, count(username) from v\$session where username is not null group by username;
EOF
else
	sqlplus -s ${oracle_user}/${oracle_pass}@$ORACLE_SID << EOF | grep -v '^$'|\
			awk '{ print "connections.value " $1 }'
set pagesize 0
select count(username) from v\$session where username is not null;
EOF
fi

echo "max_connections.value" "`sqlplus -s ${oracle_user}/${oracle_pass}@$ORACLE_SID << EOF | \
	grep -v '^$' | awk '{print $1 }'
set pagesize 0
select value from v\\$parameter where name = 'sessions';
EOF`"