File check-sar-perf-0.1+git.1272298931.4878d0c.obscpio of Package monitoring-plugins-sar-perf
07070100000000000081A40000000000000000000000014BD5BDB30000024F000000000000000000000000000000000000003100000000check-sar-perf-0.1+git.1272298931.4878d0c/READMEThis plug-in was written to get performance data from sar. It was developed for use with Zenoss but should work with other NRPE compatible NMS.
You may need to tweak the profiles to be compatible with your version of sysstat. Please make modifications to the myOpts section.
Example output:
check_sar_perf.py cpu
sar OK| CPU=all user=59.90 nice=0.00 system=4.46 iowait=0.00 steal=0.00 idle=35.64
check_sar_perf.py disk sda
sar OK| DEV=sda tps=0.00 rd_sec/s=0.00 wr_sec/s=0.00 avgrq-sz=0.00 avgqu-sz=0.00 await=0.00 svctm=0.00 util=0.00
check_sar_perf.py foo
ERROR: option not defined
07070100000001000081ED0000000000000000000000014BD5BDB300001A41000000000000000000000000000000000000003C00000000check-sar-perf-0.1+git.1272298931.4878d0c/check_sar_perf.py#!/usr/bin/env python
# Copyright (c) 2010, Nick Anderson <nick@cmdln.org>
# All rights reserved.
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
# * Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
# * Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
# DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
# DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
import os
import sys
import re
from subprocess import *
os.environ['PATH'] = '/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/bin'
#Nagios return code level
# 0 - OK - The plugin was able to check the service and it appeared to be functioning properly
# 1 - WARNING - The plugin was able to check the service, but it appeared to be above some "warning"
# threshold or did not appear to be working properly
# 2 - CRITICAL - The plugin detected that either the service was not running or it was above some "critical" threshold
# 3 - UNKNOWN - Invalid command line arguments were supplied to the plugin or low-level failures
# internal to the plugin (such as unable to fork, or open a tcp socket) that prevent
# it from performing the specified operation. Higher-level errors (such as name
# resolution errors, socket timeouts, etc) are outside of the control of plugins and
# should generally NOT be reported as UNKNOWN states.
ERR_OK = 0
ERR_WARN = 1
ERR_CRIT = 2
ERR_UNKN = 3
class SarNRPE:
'''Call sar and parse statistics returning in NRPE format'''
def __init__(self, command, device=None):
sar=Popen(command, shell=True, stdout=PIPE, stderr=PIPE)
(sout,serr) = sar.communicate()
if device == None:
(columns, data) = self.SortOutput(sout)
else:
(columns, data) = self.SortCombinedOutput(sout, device)
self.Formatter(columns, data)
def SortOutput(self, sarout):
'''Sort output of sar command, return column and data tuple'''
data = sarout.split('\n')[-2].split()
# remove 'Average:'
data.pop(0)
columns = sarout.split('\n')[-4].split()
# Remove Timestamp
columns.pop(0)
columns.pop(0)
return (columns, data)
def SortCombinedOutput(self, sarout, device):
'''Sorts column and data output from combined report and displays
only relevant information returns column and data tuple'''
find_columns = True
mycolumns = []
mydata = []
# Find the column titles
search = re.compile('^Average:')
for line in sarout.split('\n'):
if search.match(line):
if find_columns:
mycolumns.append(line)
find_columns = False
else:
mydata.append(line)
# Find the only Average line with the device we are looking for
search = re.compile('^Average:\s.*%s\s.*' %device)
for line in mydata[:]:
if not search.match(line):
mydata.remove(line)
mycolumns = mycolumns[0].split()
mydata = mydata[0].split()
mycolumns.pop(0)
mydata.pop(0)
return (mycolumns,mydata)
def Formatter(self, columns, data):
'''Construct nrpe format performance data'''
search = re.compile('^[a-zA-Z]+$')
self.stats = []
# Create dictionary
for i in range(len(columns)):
# Remove first column if data contains only letters
if i != 0 or not search.match(data[i]):
# Remove characters that cause issues (%/)
badchars=['%','/']
columns[i] = ''.join(j for j in columns[i] if j not in badchars)
string = "%s=%s" %(columns[i].strip('%/'), data[i].strip())
self.stats.append(string)
#print "Appended data: ", data[i]
def CheckBin(program):
'''Ensure the program exists in the PATH'''
for path in os.environ.get('PATH', '').split(':'):
if os.path.exists(os.path.join(path, program)) and \
not os.path.isdir(os.path.join(path, program)):
return os.path.join(path, program)
#return True
return False
def Main(args):
# Ensure a profile (aka myOpts) is selected
if not len(args) > 1:
print 'ERROR: no profile selected'
sys.exit(ERR_UNKN)
if not CheckBin('sar'):
print 'ERROR: sar not found on PATH (%s), install sysstat' %os.environ['PATH']
sys.exit(ERR_CRIT)
# Profiles may need to be modified for different versions of the sysstat package
# This would be a good candidate for a config file
myOpts = {}
myOpts['pagestat'] = 'sar -B 1 1'
myOpts['cpu'] = 'sar 1 1'
myOpts['memory_util'] = 'sar -r 1 1'
myOpts['memory_stat'] = 'sar -R 1 1'
myOpts['io_transfer'] = 'sar -b 1 1'
myOpts['queueln_load'] = 'sar -q 1 1'
myOpts['swap_util'] = 'sar -S 1 1'
myOpts['swap_stat'] = 'sar -W 1 1'
myOpts['task'] = 'sar -w 1 1'
myOpts['kernel'] = 'sar -v 1 1'
myOpts['disk'] = 'sar -d -p 1 1'
# If profile uses combined output you must pick one device to report on ie sda for disk
if args[1] in myOpts:
if args[1] == 'disk':
if len(args) > 2:
sar = SarNRPE(myOpts[args[1]],args[2])
else:
print 'ERROR: no device specified'
sys.exit(ERR_UNKN)
else:
sar = SarNRPE(myOpts[args[1]])
else:
print 'ERROR: option not defined'
sys.exit(ERR_UNKN)
# Output in NRPE format
print 'sar OK|', ' '.join(sar.stats)
if __name__ == '__main__':
Main(sys.argv)
07070100000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000B00000000TRAILER!!!16 blocks
