mirror of
https://github.com/munin-monitoring/contrib.git
synced 2018-11-08 00:59:34 +01:00
c81c20ab3b
The following issues were fixed: * comparison too broad (e.g. "0" misinterpreted as "true") * python: comparing string with number (is never equal in python) * unwanted non-zero exitcode (compound command "&&" as last command in shell code block (e.g. "case" or "if" branch)) * access to unset variable (shell style issue)
1130 lines
32 KiB
Bash
Executable File
1130 lines
32 KiB
Bash
Executable File
#!/bin/bash
|
|
# -*- sh -*-
|
|
|
|
: << =cut
|
|
|
|
=head1 NAME
|
|
|
|
oracle_sysstat - Munin multi-graph plugin to monitor Oracle Statistics
|
|
|
|
These modules are implemented:
|
|
execute - To monitor Oracle Sysstat SQL Execute Count
|
|
parse - To monitor Oracle Sysstat SQL Parse Count
|
|
tablefetch - To monitor Oracle Sysstat SQL Table Fetch Rows
|
|
tablescan - To monitor Oracle Sysstat SQL Table Scans
|
|
transaction - To monitor Oracle Sysstat SQL Transactions
|
|
sort - To monitor Oracle Sysstat SQL Sorts
|
|
logon - To monitor Oracle Sysstat User Logons
|
|
cursor - To monitor Oracle Sysstat User Opened Cursors
|
|
enqueue - To monitor Oracle Sysstat Enqueues
|
|
redolog - To monitor Oracle Sysstat Redo Entries
|
|
redosize - To monitor Oracle Sysstat Redo Size
|
|
physicaliops - To monitor Oracle Sysstat I/O Physical Requests
|
|
physicalrw - To monitor Oracle Sysstat I/O Physical Bytes
|
|
blockrw - To monitor Oracle Sysstat I/O Blocks
|
|
netrw - To monitor Oracle Sysstat I/O Network Bytes
|
|
sgainfo - To monitor Oracle Memory SGA
|
|
pgastat - To monitor Oracle Memory PGA
|
|
cputime - To monitor Oracle CPU Time
|
|
cachehit - To monitor Oracle Cache Hit Ratio
|
|
sessionuser - To monitor Oracle Session Users
|
|
sessionwait - To monitor Oracle Session Wait
|
|
eventwait - To monitor Oracle Wait Events
|
|
eventwaitapplication - To monitor Oracle Wait Events Application
|
|
eventwaitnetwork - To monitor Oracle Wait Events Network
|
|
eventwaitconcurrency - To monitor Oracle Wait Events Concurrency
|
|
eventwaituserio - To monitor Oracle Wait Events User I/O
|
|
eventwaitsystemio - To monitor Oracle Wait Events System I/O
|
|
eventwaitcluster - To monitor Oracle Wait Events Cluster
|
|
eventwaitadministrative - To monitor Oracle Wait Events Administrative
|
|
eventwaitconfiguration - To monitor Oracle Wait Events Configuration
|
|
tablespace - To monitor Oracle Table Space Usage
|
|
asmusage - To monitor Oracle ASM Disk Group Usage
|
|
|
|
=head1 CONFIGURATION
|
|
|
|
Make symlink:
|
|
cd /path/to/munin/etc/plugins
|
|
ln -s /path/to/munin/lib/plugins/oracle_sysstat .
|
|
ln -s /path/to/munin/lib/plugins/oracle_sysstat oracle_sysstat_asmusage # if necessary
|
|
...
|
|
|
|
The following shows example settings for this plugin:
|
|
|
|
[oracle_sysstat]
|
|
user oracle
|
|
env.ORACLE_SID ORCL
|
|
env.ORACLE_HOME /path/to/oracle/home
|
|
env.oracle_auth / as SYSDBA
|
|
|
|
[oracle_sysstat_asmusage]
|
|
user grid
|
|
env.ORACLE_SID +ASM
|
|
env.ORACLE_HOME /path/to/grid/home
|
|
env.oracle_auth / as SYSASM
|
|
env.include_module asmusage
|
|
env.plugin_name oracle_sysstat
|
|
|
|
=head1 ENVIRONMENT VARIABLES
|
|
|
|
env.ORACLE_SID:
|
|
example: env.ORACLE_SID SOMESID
|
|
default: ORCL
|
|
|
|
env.ORACLE_HOME:
|
|
example: env.ORACLE_HOME /opt/oracle/...
|
|
default: Try to find from oratab file
|
|
|
|
env.oracle_auth:
|
|
example: env.oracle_auth user/pass as SYSDBA
|
|
default: / as SYSDBA
|
|
|
|
env.exclude_module:
|
|
example: env.exclude_module asmusage tablespace
|
|
default: asmusage
|
|
|
|
Module name(s) to exclude seperated by white-space.
|
|
By default, asmusage module is excluded because another privilege
|
|
is necessary to connect ASM instance.
|
|
|
|
env.include_module:
|
|
example: env.include_module asmusage
|
|
default: none
|
|
|
|
Module name(s) to include seperated by white-space.
|
|
If both include_module and exclude_module are set, exclude will be
|
|
ignored.
|
|
|
|
env.plugin_name:
|
|
example: env.plugin_name oracle_sysstat_2
|
|
default: program name (usually oracle_sysstat)
|
|
|
|
Used for internal graph name.
|
|
It will be useful to monitor multi-instance databases.
|
|
|
|
env.db_name:
|
|
example: env.db_name dbname
|
|
default: none
|
|
|
|
Used for graph title.
|
|
It will be useful to monitor multi-instance databases.
|
|
|
|
=head1 NOTES
|
|
|
|
Uses the command "sqlplus".
|
|
Tested with Oracle Database 12c R1.
|
|
|
|
=head1 AUTHOR
|
|
|
|
K.Cima https://github.com/shakemid
|
|
|
|
=head1 LICENSE
|
|
|
|
GPLv2
|
|
|
|
=head1 MAGIC MARKERS
|
|
|
|
#%# family=contrib
|
|
#%# capabilities=autoconf
|
|
|
|
=cut
|
|
|
|
# Include plugin.sh
|
|
. "${MUNIN_LIBDIR:-}/plugins/plugin.sh"
|
|
is_multigraph "$@"
|
|
|
|
# Like perl 'use strict;'
|
|
set -o nounset
|
|
|
|
# Global variables
|
|
: "${ORACLE_SID:=ORCL}"
|
|
: "${ORACLE_HOME:=$( cat /etc/oratab /var/opt/oracle/oratab \
|
|
| awk -F: '$1 == "'$ORACLE_SID'" { print $2 }' 2>/dev/null )}"
|
|
: "${oracle_auth:=/ as SYSDBA}"
|
|
: "${exclude_module:=asmusage}"
|
|
: "${include_module:=}"
|
|
: "${plugin_name:=${0##*/}}"
|
|
[ -n "${db_name:=}" ] && db_name=" ($db_name)"
|
|
|
|
PATH=$PATH:$ORACLE_HOME/bin
|
|
export PATH ORACLE_HOME ORACLE_SID
|
|
|
|
# Graph settings
|
|
declare -A global_attrs # required
|
|
declare -A data_attrs # required (format: field type draw label)
|
|
declare -A getfield_func # optional
|
|
declare -A getvalue_func # required
|
|
|
|
# Note: Bash 4 (or above) is required to use hash.
|
|
|
|
key=execute
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat SQL Execute Count
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count per second
|
|
graph_info Oracle Sysstat SQL Execute Count
|
|
"
|
|
data_attrs[$key]="
|
|
execute_count DERIVE LINE execute count
|
|
user_calls DERIVE LINE user calls
|
|
recursive_calls DERIVE LINE recursive calls
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=parse
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat SQL Parse Count
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count per second
|
|
graph_info Oracle Sysstat SQL Parse Count
|
|
"
|
|
data_attrs[$key]="
|
|
parse_count_total DERIVE LINE parse count (total)
|
|
parse_count_hard DERIVE LINE parse count (hard)
|
|
parse_count_describe DERIVE LINE parse count (describe)
|
|
parse_count_failures DERIVE LINE parse count (failures)
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=tablefetch
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat SQL Table Fetch Rows
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count per second
|
|
graph_info Oracle Sysstat SQL Table Fetch Rows
|
|
"
|
|
data_attrs[$key]="
|
|
table_fetch_by_rowid DERIVE LINE table fetch by rowid
|
|
table_scan_rows_gotten DERIVE LINE table scan rows gotten
|
|
table_fetch_continued_row DERIVE LINE table fetch continued row
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=tablescan
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat SQL Table Scans
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count per second
|
|
graph_info Oracle Sysstat SQL Table Scans
|
|
"
|
|
data_attrs[$key]="
|
|
table_scans_short_tables DERIVE LINE table scans (short tables)
|
|
table_scans_long_tables DERIVE LINE table scans (long tables)
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=transaction
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat SQL Transactions
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count per second
|
|
graph_info Oracle Sysstat SQL Transactions
|
|
"
|
|
data_attrs[$key]="
|
|
user_commits DERIVE LINE user commits
|
|
user_rollbacks DERIVE LINE user rollbacks
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=sort
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat SQL Sorts
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count per second
|
|
graph_info Oracle Sysstat SQL Sorts
|
|
"
|
|
data_attrs[$key]="
|
|
sorts_memory DERIVE LINE sorts (memory)
|
|
sorts_disk DERIVE LINE sorts (disk)
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=logon
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat User Logons
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count per second
|
|
graph_info Oracle Sysstat User Logons
|
|
"
|
|
data_attrs[$key]="
|
|
logon DERIVE LINE logons cumulative
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=cursor
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat User Opened Cursors
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count
|
|
graph_info Oracle Sysstat User Opened Cursors
|
|
"
|
|
data_attrs[$key]="
|
|
open_cursor GAUGE LINE opened cursors current
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=enqueue
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat Enqueues
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count per second
|
|
graph_info Oracle Sysstat Enqueues
|
|
"
|
|
data_attrs[$key]="
|
|
enqueue_requests DERIVE LINE enqueue requests
|
|
enqueue_releases DERIVE LINE enqueue releases
|
|
enqueue_conversions DERIVE LINE enqueue conversions
|
|
enqueue_waits DERIVE LINE enqueue waits
|
|
enqueue_timeouts DERIVE LINE enqueue timeouts
|
|
enqueue_deadlocks DERIVE LINE enqueue deadlocks
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=redolog
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat Redo Entries
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count per second
|
|
graph_info Oracle Sysstat Redo Entries
|
|
"
|
|
data_attrs[$key]="
|
|
redo_entries DERIVE LINE redo entries
|
|
redo_writes DERIVE LINE redo writes
|
|
redo_synch_writes DERIVE LINE redo synch writes
|
|
redo_buffer_allocation_retries DERIVE LINE redo buffer allocation retries
|
|
redo_log_space_requests DERIVE LINE redo log space requests
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=redosize
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat Redo Size
|
|
graph_category db
|
|
graph_args --base 1024 --lower-limit 0 --rigid
|
|
graph_vlabel bytes per second
|
|
graph_info Oracle Sysstat Redo Size
|
|
"
|
|
data_attrs[$key]="
|
|
redo_size DERIVE LINE redo size
|
|
redo_wastage DERIVE LINE redo wastage
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=physicaliops
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat I/O Physical Requests
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel iops
|
|
graph_info Oracle Sysstat I/O Physical Requests
|
|
"
|
|
data_attrs[$key]="
|
|
physical_read_total DERIVE LINE2 physical read total IO requests
|
|
physical_read DERIVE LINE physical read IO requests
|
|
physical_read_total_multi DERIVE LINE physical read total multi block requests
|
|
physical_write_total DERIVE LINE2 physical write total IO requests
|
|
physical_write DERIVE LINE physical write IO requests
|
|
physical_write_total_multi DERIVE LINE physical write total multi block requests
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=physicalrw
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat I/O Physical Bytes
|
|
graph_category db
|
|
graph_args --base 1024 --lower-limit 0 --rigid
|
|
graph_vlabel bytes per second
|
|
graph_info Oracle Sysstat I/O Physical Bytes
|
|
"
|
|
data_attrs[$key]="
|
|
physical_read_total DERIVE LINE2 physical read total bytes
|
|
physical_read DERIVE LINE physical read bytes
|
|
physical_write_total DERIVE LINE2 physical write total bytes
|
|
physical_write DERIVE LINE physical write bytes
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=blockrw
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat I/O Blocks
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel blocks per second
|
|
graph_info Oracle Sysstat I/O Blocks
|
|
"
|
|
data_attrs[$key]="
|
|
db_block_gets DERIVE LINE db block gets
|
|
db_block_changes DERIVE LINE db block changes
|
|
consistent_gets DERIVE LINE consistent gets
|
|
consistent_changes DERIVE LINE consistent changes
|
|
physical_reads DERIVE LINE physical reads
|
|
physical_writes DERIVE LINE physical writes
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
|
|
key=netrw
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Sysstat I/O Network Bytes
|
|
graph_category db
|
|
graph_args --base 1024 --lower-limit 0 --rigid
|
|
graph_vlabel bytes per second
|
|
graph_info Oracle Sysstat I/O Network Bytes
|
|
"
|
|
data_attrs[$key]="
|
|
bytes_sent_via_sql_net_to_client DERIVE LINE bytes sent via SQL*Net to client
|
|
bytes_received_via_sql_net_from_client DERIVE LINE bytes received via SQL*Net from client
|
|
bytes_sent_via_sql_net_to_dblink DERIVE LINE bytes sent via SQL*Net to dblink
|
|
bytes_received_via_sql_net_from_dblink DERIVE LINE bytes received via SQL*Net from dblink
|
|
"
|
|
getvalue_func[$key]=getvalue_sysstat
|
|
|
|
key=sgainfo
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Memory SGA
|
|
graph_category db
|
|
graph_args --base 1024 --lower-limit 0 --rigid
|
|
graph_vlabel bytes
|
|
graph_info Oracle Memory SGA
|
|
"
|
|
data_attrs[$key]="
|
|
fixed_sga_size GAUGE AREASTACK Fixed SGA Size
|
|
redo_buffers GAUGE AREASTACK Redo Buffers
|
|
shared_pool_size GAUGE AREASTACK Shared Pool Size
|
|
large_pool_size GAUGE AREASTACK Large Pool Size
|
|
java_pool_size GAUGE AREASTACK Java Pool Size
|
|
streams_pool_size GAUGE AREASTACK Streams Pool Size
|
|
shared_io_pool_size GAUGE AREASTACK Shared IO Pool Size
|
|
buffer_cache_size GAUGE AREASTACK Buffer Cache Size
|
|
in_memory_area_size GAUGE AREASTACK In-Memory Area Size
|
|
maximum_sga_size GAUGE LINE Maximum SGA Size
|
|
"
|
|
getvalue_func[$key]=getvalue_sgainfo
|
|
|
|
key=pgastat
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Memory PGA
|
|
graph_category db
|
|
graph_args --base 1024 --lower-limit 0 --rigid
|
|
graph_vlabel bytes
|
|
graph_info Oracle Memory PGA
|
|
"
|
|
data_attrs[$key]="
|
|
pga_inuse GAUGE AREA total PGA inuse
|
|
pga_allocated GAUGE LINE total PGA allocated
|
|
pga_target GAUGE LINE aggregate PGA target parameter
|
|
pga_auto_target GAUGE LINE aggregate PGA auto target
|
|
"
|
|
getvalue_func[$key]=getvalue_pgastat
|
|
|
|
key=cputime
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name CPU Time
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel seconds
|
|
graph_info Oracle CPU Time
|
|
"
|
|
data_attrs[$key]="
|
|
db_time DERIVE LINE2 DB time
|
|
db_cpu DERIVE LINE2 DB CPU
|
|
background_elapsed_time DERIVE LINE2 background elapsed time
|
|
background_cpu_time DERIVE LINE2 background cpu time
|
|
connection_management_call_elapsed_time DERIVE LINE connection management call elapsed time
|
|
sequence_load_elapsed_time DERIVE LINE sequence load elapsed time
|
|
sql_execute_elapsed_time DERIVE LINE sql execute elapsed time
|
|
parse_time_elapsed DERIVE LINE parse time elapsed
|
|
hard_parse_elapsed_time DERIVE LINE hard parse elapsed time
|
|
hard_parse_sharing_criteria_elapsed_time DERIVE LINE hard parse (sharing criteria) elapsed time
|
|
hard_parse_bind_mismatch_elapsed_time DERIVE LINE hard parse (bind mismatch) elapsed time
|
|
failed_parse_elapsed_time DERIVE LINE failed parse elapsed time
|
|
failed_parse_out_of_shared_memory_elapsed_time DERIVE LINE failed parse (out of shared memory) elapsed time
|
|
pl_sql_execution_elapsed_time DERIVE LINE PL/SQL execution elapsed time
|
|
inbound_pl_sql_rpc_elapsed_time DERIVE LINE inbound PL/SQL rpc elapsed time
|
|
pl_sql_compilation_elapsed_time DERIVE LINE PL/SQL compilation elapsed time
|
|
java_execution_elapsed_time DERIVE LINE Java execution elapsed time
|
|
repeated_bind_elapsed_time DERIVE LINE repeated bind elapsed time
|
|
rman_cpu_time_backup_restore DERIVE LINE RMAN cpu time (backup/restore)
|
|
"
|
|
getvalue_func[$key]=getvalue_cputime
|
|
|
|
key=cachehit
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Cache Hit Ratio
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --upper-limit 100 --rigid
|
|
graph_vlabel %
|
|
graph_info Oracle Cache Hit Ratio - The graph shows cache hit ratio between munin-update intervals (5 minutes in most cases).
|
|
graph_scale no
|
|
|
|
buf_hitratio.cdef 100,1,buf_physical,buf_logical,/,-,*
|
|
lib_hitratio.cdef 100,1,lib_reloads,lib_pins,/,-,*
|
|
dict_hitratio.cdef 100,dict_gets,dict_getmisses,-,dict_gets,/,*
|
|
"
|
|
# Note:
|
|
# buf_hitratio = 1 - physical_reads / ( db_block_gets + consistent_gets )
|
|
# lib_hitratio = 1 - reloads / pins
|
|
# dict_hitratio = ( gets - misses ) / gets
|
|
data_attrs[$key]="
|
|
buf_physical DERIVE LINE dummy
|
|
buf_logical DERIVE LINE dummy
|
|
lib_pins DERIVE LINE dummy
|
|
lib_reloads DERIVE LINE dummy
|
|
dict_gets DERIVE LINE dummy
|
|
dict_getmisses DERIVE LINE dummy
|
|
buf_hitratio GAUGE LINE Buffer Cache Hit Ratio
|
|
lib_hitratio GAUGE LINE Library Cache Hit Ratio
|
|
dict_hitratio GAUGE LINE Dictionary Cache Hit Ratio
|
|
"
|
|
getvalue_func[$key]=getvalue_cachehit
|
|
|
|
key=sessionuser
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Session Users
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count
|
|
graph_info Oracle Session Users
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]=getfield_sessionuser
|
|
getvalue_func[$key]=getvalue_sessionuser
|
|
|
|
key=sessionwait
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Session Wait
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel count
|
|
graph_info Oracle Session Wait
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]=getfield_sessionwait
|
|
getvalue_func[$key]=getvalue_sessionwait
|
|
|
|
key=eventwait
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Wait Events
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel microseconds
|
|
graph_info Oracle Wait Events - It may look wierd that Y-axis indicates 'microseconds per second'. Although number of times of wait event looks easier to understand, in many cases the number of events does not matter, but wait time become more important to analyze bottle necks.
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]=getfield_eventwait
|
|
getvalue_func[$key]=getvalue_eventwait
|
|
|
|
key=eventwaitapplication
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Wait Events Application
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel microseconds
|
|
graph_info Oracle Wait Events Application
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]="getfield_eventwait2 Application"
|
|
getvalue_func[$key]="getvalue_eventwait2 Application"
|
|
|
|
key=eventwaitnetwork
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Wait Events Network
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel microseconds
|
|
graph_info Oracle Wait Events Network
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]="getfield_eventwait2 Network"
|
|
getvalue_func[$key]="getvalue_eventwait2 Network"
|
|
|
|
key=eventwaitconcurrency
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Wait Events Concurrency
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel microseconds
|
|
graph_info Oracle Wait Events Concurrency
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]="getfield_eventwait2 Concurrency"
|
|
getvalue_func[$key]="getvalue_eventwait2 Concurrency"
|
|
|
|
key=eventwaituserio
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Wait Events User I/O
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel microseconds
|
|
graph_info Oracle Wait Events User I/O
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]="getfield_eventwait2 User I/O"
|
|
getvalue_func[$key]="getvalue_eventwait2 User I/O"
|
|
|
|
key=eventwaitsystemio
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Wait Events System I/O
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel microseconds
|
|
graph_info Oracle Wait Events System I/O
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]="getfield_eventwait2 System I/O"
|
|
getvalue_func[$key]="getvalue_eventwait2 System I/O"
|
|
|
|
key=eventwaitcluster
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Wait Events Cluster
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel microseconds
|
|
graph_info Oracle Wait Events Cluster
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]="getfield_eventwait2 Cluster"
|
|
getvalue_func[$key]="getvalue_eventwait2 Cluster"
|
|
|
|
key=eventwaitadministrative
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Wait Events Administrative
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel microseconds
|
|
graph_info Oracle Wait Events Administrative
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]="getfield_eventwait2 Administrative"
|
|
getvalue_func[$key]="getvalue_eventwait2 Administrative"
|
|
|
|
key=eventwaitconfiguration
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Wait Events Configuration
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --rigid
|
|
graph_vlabel microseconds
|
|
graph_info Oracle Wait Events Configuration
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]="getfield_eventwait2 Configuration"
|
|
getvalue_func[$key]="getvalue_eventwait2 Configuration"
|
|
|
|
key=tablespace
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name Table Space Usage
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --upper-limit 100 --rigid
|
|
graph_vlabel %
|
|
graph_info Oracle Table Space Usage
|
|
warning ${warning:=92}
|
|
critical ${critical:=98}
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]=getfield_tablespace
|
|
getvalue_func[$key]=getvalue_tablespace
|
|
|
|
key=asmusage
|
|
global_attrs[$key]="
|
|
graph_title Oracle$db_name ASM Disk Group Usage
|
|
graph_category db
|
|
graph_args --base 1000 --lower-limit 0 --upper-limit 100 --rigid
|
|
graph_vlabel %
|
|
graph_info Oracle ASM Disk Group Usage
|
|
warning ${warning:=92}
|
|
critical ${critical:=98}
|
|
"
|
|
data_attrs[$key]=""
|
|
getfield_func[$key]=getfield_asmusage
|
|
getvalue_func[$key]=getvalue_asmusage
|
|
|
|
# End of Graph Settings
|
|
|
|
# sqlplus options
|
|
: "${sqlplus:=sqlplus -S -L}"
|
|
sqlplus_variables="
|
|
whenever sqlerror exit sql.sqlcode
|
|
set pagesize 0
|
|
set feed off
|
|
set head off
|
|
set linesize 256
|
|
set numwidth 30
|
|
"
|
|
|
|
# Functions
|
|
|
|
autoconf() {
|
|
if which sqlplus >/dev/null ; then
|
|
echo yes
|
|
else
|
|
echo "no (failed to find executable 'sqlplus')"
|
|
fi
|
|
}
|
|
|
|
config() {
|
|
for module in $( module_list )
|
|
do
|
|
do_config
|
|
done
|
|
}
|
|
|
|
fetch() {
|
|
for module in $( module_list )
|
|
do
|
|
do_fetch
|
|
done
|
|
}
|
|
|
|
do_config() {
|
|
local label_max_length=45
|
|
local field type draw label
|
|
local fields=
|
|
|
|
getfield
|
|
echo "multigraph ${plugin_name}_${module}"
|
|
|
|
# print global attributes
|
|
echo "${global_attrs[$module]}" | sed -e 's/^ *//' -e '/^$/d'
|
|
|
|
# print data source attributes
|
|
# split line into field,type,draw,label
|
|
while read -r field type draw label
|
|
do
|
|
[ -z "$field" ] && continue
|
|
fields="${fields} ${field}"
|
|
|
|
echo "${field}.type ${type}"
|
|
echo "${field}.draw ${draw}"
|
|
echo "${field}.label ${label:0:${label_max_length}}"
|
|
if [ "$type" = 'DERIVE' ]; then
|
|
echo "${field}.min 0"
|
|
fi
|
|
if [ "$label" = 'dummy' ]; then
|
|
echo "${field}.graph no"
|
|
fi
|
|
done <<< "${data_attrs[$module]}"
|
|
|
|
echo graph_order "$fields"
|
|
echo
|
|
}
|
|
|
|
do_fetch() {
|
|
echo "multigraph ${plugin_name}_${module}"
|
|
getvalue
|
|
echo
|
|
}
|
|
|
|
module_list() {
|
|
local i
|
|
|
|
if [ -n "$include_module" ]; then
|
|
echo "$include_module"
|
|
else
|
|
for i in $exclude_module
|
|
do
|
|
# remove excluded modules
|
|
unset -v "global_attrs[$i]"
|
|
done
|
|
|
|
# print hash keys as available module names
|
|
echo "${!global_attrs[@]}"
|
|
fi
|
|
}
|
|
|
|
# wrapper for getfield_*
|
|
getfield() {
|
|
local func arg
|
|
if [ -n "${getfield_func[$module]:-}" ]; then
|
|
# call getfield_* function with argument if necessary
|
|
read -r func arg <<< "${getfield_func[$module]}"
|
|
$func "$arg"
|
|
fi
|
|
}
|
|
|
|
# wrapper for getvalue_*
|
|
getvalue() {
|
|
local func arg
|
|
# call getvalue_* function with argument if necessary
|
|
read -r func arg <<< "${getvalue_func[$module]}"
|
|
$func "$arg"
|
|
}
|
|
|
|
getvalue_sysstat() {
|
|
local field type draw label
|
|
while read -r field type draw label
|
|
do
|
|
[ -z "$field" ] && continue
|
|
|
|
echo "${sqlplus_variables}
|
|
VAR vf VARCHAR2(64)
|
|
VAR vl VARCHAR2(64)
|
|
EXEC :vf := '${field}'
|
|
EXEC :vl := '${label}'
|
|
SELECT
|
|
:vf || '.value ' || value
|
|
FROM
|
|
v\$sysstat
|
|
WHERE
|
|
name = :vl;
|
|
"
|
|
done <<< "${data_attrs[$module]}" | ${sqlplus} "${oracle_auth}"
|
|
}
|
|
|
|
getvalue_sgainfo() {
|
|
local field type draw label
|
|
while read -r field type draw label
|
|
do
|
|
[ -z "$field" ] && continue
|
|
|
|
echo "${sqlplus_variables}
|
|
VAR vf VARCHAR2(64)
|
|
VAR vl VARCHAR2(64)
|
|
EXEC :vf := '${field}'
|
|
EXEC :vl := '${label}'
|
|
SELECT
|
|
:vf || '.value ' || bytes
|
|
FROM
|
|
v\$sgainfo
|
|
WHERE
|
|
name = :vl;
|
|
"
|
|
done <<< "${data_attrs[$module]}" | ${sqlplus} "${oracle_auth}"
|
|
}
|
|
|
|
getvalue_pgastat() {
|
|
local field type draw label
|
|
while read -r field type draw label
|
|
do
|
|
[ -z "$field" ] && continue
|
|
|
|
echo "${sqlplus_variables}
|
|
VAR vf VARCHAR2(64)
|
|
VAR vl VARCHAR2(64)
|
|
EXEC :vf := '${field}'
|
|
EXEC :vl := '${label}'
|
|
SELECT
|
|
:vf || '.value ' || value
|
|
FROM
|
|
v\$pgastat
|
|
WHERE
|
|
name = :vl;
|
|
"
|
|
done <<< "${data_attrs[$module]}" | ${sqlplus} "${oracle_auth}"
|
|
}
|
|
|
|
getvalue_cputime() {
|
|
local field type draw label
|
|
while read -r field type draw label
|
|
do
|
|
[ -z "$field" ] && continue
|
|
|
|
echo "${sqlplus_variables}
|
|
VAR vf VARCHAR2(64)
|
|
VAR vl VARCHAR2(64)
|
|
EXEC :vf := '${field}'
|
|
EXEC :vl := '${label}'
|
|
SELECT
|
|
:vf || '.value ' || ROUND( value / 1000000 )
|
|
FROM
|
|
v\$sys_time_model
|
|
WHERE
|
|
stat_name = :vl;
|
|
"
|
|
done <<< "${data_attrs[$module]}" | ${sqlplus} "${oracle_auth}"
|
|
}
|
|
|
|
getvalue_cachehit() {
|
|
${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT
|
|
'buf_physical.value ' || value
|
|
FROM
|
|
v\$sysstat
|
|
WHERE
|
|
name = 'physical reads cache'
|
|
;
|
|
SELECT
|
|
'buf_logical.value ' || ( sd.value + sc.value )
|
|
FROM
|
|
v\$sysstat sd, v\$sysstat sc
|
|
WHERE
|
|
sd.name = 'db block gets from cache' AND sc.name = 'consistent gets from cache'
|
|
;
|
|
SELECT 'lib_pins.value ' || SUM(pins) FROM v\$librarycache;
|
|
SELECT 'lib_reloads.value ' || SUM(reloads) FROM v\$librarycache;
|
|
SELECT 'dict_gets.value ' || SUM(gets) FROM v\$rowcache;
|
|
SELECT 'dict_getmisses.value ' || SUM(getmisses) FROM v\$rowcache;
|
|
SELECT 'buf_hitratio.value 0' FROM dual;
|
|
SELECT 'lib_hitratio.value 0' FROM dual;
|
|
SELECT 'dict_hitratio.value 0' FROM dual;
|
|
EOF
|
|
}
|
|
|
|
getfield_sessionuser() {
|
|
data_attrs[$module]=$( ${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT
|
|
REGEXP_REPLACE( username, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) ||
|
|
' GAUGE LINE ' || username
|
|
FROM
|
|
dba_users
|
|
WHERE
|
|
account_status = 'OPEN'
|
|
ORDER BY
|
|
username;
|
|
EOF
|
|
)
|
|
}
|
|
|
|
getvalue_sessionuser() {
|
|
${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT
|
|
REGEXP_REPLACE( du.username, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) || '.value ' ||
|
|
count(vs.username)
|
|
FROM
|
|
( SELECT
|
|
username
|
|
FROM
|
|
dba_users
|
|
WHERE
|
|
account_status = 'OPEN'
|
|
) du
|
|
LEFT JOIN v\$session vs
|
|
ON
|
|
du.username = vs.username
|
|
GROUP BY
|
|
du.username;
|
|
EOF
|
|
}
|
|
|
|
getfield_sessionwait() {
|
|
data_attrs[$module]=$( ${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT 'CPU GAUGE AREASTACK CPU' from dual;
|
|
SELECT
|
|
REGEXP_REPLACE( wait_class, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) ||
|
|
' GAUGE AREASTACK ' || wait_class
|
|
FROM
|
|
v\$event_name
|
|
WHERE
|
|
wait_class NOT IN ( 'Other', 'Idle' )
|
|
GROUP BY
|
|
wait_class
|
|
ORDER BY
|
|
wait_class;
|
|
SELECT 'Other GAUGE AREASTACK Other' from dual;
|
|
SELECT 'Idle GAUGE AREASTACK Idle' from dual;
|
|
EOF
|
|
)
|
|
}
|
|
|
|
getvalue_sessionwait() {
|
|
${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT
|
|
'CPU.value ' || count(wait_class)
|
|
FROM
|
|
v\$session
|
|
WHERE
|
|
wait_time != 0
|
|
;
|
|
SELECT
|
|
REGEXP_REPLACE( en.wait_class, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) || '.value ' ||
|
|
count(se.wait_class)
|
|
FROM
|
|
( SELECT
|
|
wait_class
|
|
FROM
|
|
v\$event_name
|
|
GROUP BY
|
|
wait_class
|
|
) en
|
|
LEFT JOIN v\$session se
|
|
ON
|
|
en.wait_class = se.wait_class AND
|
|
se.username is not null AND
|
|
se.wait_time = 0
|
|
GROUP BY
|
|
en.wait_class
|
|
;
|
|
EOF
|
|
}
|
|
|
|
getfield_eventwait() {
|
|
data_attrs[$module]=$( ${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT
|
|
REGEXP_REPLACE( wait_class, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) ||
|
|
' DERIVE LINE ' || wait_class
|
|
FROM
|
|
v\$event_name
|
|
WHERE
|
|
wait_class NOT IN ( 'Other', 'Idle' )
|
|
GROUP BY
|
|
wait_class
|
|
ORDER BY
|
|
wait_class;
|
|
SELECT 'Other DERIVE LINE Other' from dual;
|
|
EOF
|
|
)
|
|
}
|
|
|
|
getvalue_eventwait() {
|
|
${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT
|
|
REGEXP_REPLACE( en.wait_class, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) || '.value ' ||
|
|
NVL( SUM(se.time_waited_micro), 0 )
|
|
FROM
|
|
( SELECT
|
|
wait_class
|
|
FROM
|
|
v\$event_name
|
|
WHERE
|
|
wait_class NOT IN ( 'Idle' )
|
|
GROUP BY
|
|
wait_class
|
|
) en
|
|
LEFT JOIN v\$system_event se
|
|
ON
|
|
en.wait_class = se.wait_class
|
|
GROUP BY
|
|
en.wait_class;
|
|
EOF
|
|
}
|
|
|
|
getfield_eventwait2() {
|
|
local waitclass="$1"
|
|
|
|
data_attrs[$module]=$( ${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
VAR vl VARCHAR2(64)
|
|
EXEC :vl := '${waitclass}'
|
|
SELECT
|
|
REGEXP_REPLACE( name, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) ||
|
|
' DERIVE LINE ' || name
|
|
FROM
|
|
v\$event_name
|
|
WHERE
|
|
wait_class = :vl
|
|
ORDER BY
|
|
name;
|
|
EOF
|
|
)
|
|
}
|
|
|
|
getvalue_eventwait2() {
|
|
local waitclass="$1"
|
|
|
|
${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
VAR vl VARCHAR2(64)
|
|
EXEC :vl := '${waitclass}'
|
|
SELECT
|
|
REGEXP_REPLACE( en.name, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) || '.value ' ||
|
|
NVL( se.time_waited_micro, 0 )
|
|
FROM
|
|
v\$event_name en LEFT JOIN v\$system_event se
|
|
ON
|
|
en.name = se.event
|
|
WHERE
|
|
en.wait_class = :vl;
|
|
EOF
|
|
}
|
|
|
|
getfield_tablespace() {
|
|
data_attrs[$module]=$( ${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT
|
|
REGEXP_REPLACE( tablespace_name, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) ||
|
|
' GAUGE LINE ' || tablespace_name
|
|
FROM
|
|
dba_data_files
|
|
ORDER BY
|
|
tablespace_name;
|
|
EOF
|
|
)
|
|
}
|
|
|
|
getvalue_tablespace() {
|
|
${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT
|
|
REGEXP_REPLACE( tablespace_name, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) || '.value ' ||
|
|
ROUND( (total_bytes - free_total_bytes) / total_bytes * 100, 0 )
|
|
FROM
|
|
( SELECT
|
|
tablespace_name,
|
|
SUM(bytes) total_bytes
|
|
FROM
|
|
dba_data_files
|
|
GROUP BY
|
|
tablespace_name
|
|
),
|
|
( SELECT
|
|
tablespace_name free_tablespace_name,
|
|
SUM(bytes) free_total_bytes
|
|
FROM
|
|
dba_free_space
|
|
GROUP BY
|
|
tablespace_name
|
|
)
|
|
WHERE
|
|
tablespace_name = free_tablespace_name;
|
|
EOF
|
|
}
|
|
|
|
getfield_asmusage() {
|
|
data_attrs[$module]=$( ${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT
|
|
REGEXP_REPLACE( name, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) ||
|
|
' GAUGE LINE ' || name
|
|
FROM
|
|
v\$asm_diskgroup
|
|
ORDER BY
|
|
name;
|
|
EOF
|
|
)
|
|
}
|
|
|
|
getvalue_asmusage() {
|
|
${sqlplus} "${oracle_auth}" <<EOF
|
|
${sqlplus_variables}
|
|
SELECT
|
|
REGEXP_REPLACE( name, '^[^A-Za-z_]|[^A-Za-z0-9_]', '_' ) || '.value ' ||
|
|
ROUND( ( total_mb - free_mb ) / total_mb * 100 )
|
|
FROM
|
|
v\$asm_diskgroup
|
|
ORDER BY
|
|
name;
|
|
EOF
|
|
}
|
|
|
|
# Main
|
|
case ${1:-} in
|
|
autoconf)
|
|
autoconf
|
|
;;
|
|
config)
|
|
config
|
|
if [ "${MUNIN_CAP_DIRTYCONFIG:-0}" = "1" ]; then fetch; fi
|
|
;;
|
|
*)
|
|
fetch
|
|
;;
|
|
esac
|
|
|
|
exit 0
|