git.lirion.de

Of git, get, and gud

summaryrefslogtreecommitdiffstats
path: root/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite
diff options
context:
space:
mode:
authormail_redacted_for_web 2019-04-17 19:07:19 +0200
committermail_redacted_for_web 2019-04-17 19:07:19 +0200
commit1e2387474a449452b78520b9ad96a8b4b5e99722 (patch)
tree836889471eec7d2aac177405068e2a8f1e2b1978 /nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite
downloadnagios-plugins-contrib-1e2387474a449452b78520b9ad96a8b4b5e99722.tar.bz2
initial commit of source fetch
Diffstat (limited to 'nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite')
-rw-r--r--nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/Makefile10
-rw-r--r--nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/README.md34
-rwxr-xr-xnagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/check_graphite.py286
-rw-r--r--nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/control4
-rw-r--r--nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/copyright5
5 files changed, 339 insertions, 0 deletions
diff --git a/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/Makefile b/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/Makefile
new file mode 100644
index 0000000..7ae74f4
--- /dev/null
+++ b/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/Makefile
@@ -0,0 +1,10 @@
+PLUGIN := check_graphite
+CLEANFILES := check_graphite
+DOCFILES := README.md
+
+include ../common.mk
+
+check_graphite:
+ cp $@.py $@
+ chmod 755 $@
+
diff --git a/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/README.md b/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/README.md
new file mode 100644
index 0000000..0d86ab9
--- /dev/null
+++ b/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/README.md
@@ -0,0 +1,34 @@
+# Disqus Nagios plugins
+
+This is a collection of Nagios plugins written at Disqus.
+
+## Scripts
+
+* check_graphite.py
+
+## check_graphite.py
+
+ % ./check_graphite.py -h
+ Usage: check_graphite.py [options]
+
+ Options:
+ -h, --help show this help message and exit
+ -U URL, --graphite-url=URL
+ Graphite URL [http://localhost/]
+ -t TARGET, --target=TARGET
+ Target to check
+ --compare=SERIES Compare TARGET against SERIES
+ --from=_FROM From timestamp/date
+ --until=_UNTIL Until timestamp/date [now]
+ -c COUNT, --count=COUNT
+ Alert on at least COUNT metrics [0]
+ --percentile=PERCENT Use nPercentile Graphite function on the target
+ (returns one datapoint)
+ --confidence Use holtWintersConfidenceBands Graphite function on
+ the target
+ --over Over specified WARNING or CRITICAL threshold [True]
+ --under Under specified WARNING or CRITICAL threshold [False]
+ -W VALUE Warning if datapoints beyond VALUE
+ -C VALUE Critical if datapoints beyond VALUE
+
+Mandatory arguments: -U, [-t|--target], --from
diff --git a/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/check_graphite.py b/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/check_graphite.py
new file mode 100755
index 0000000..bedb7c1
--- /dev/null
+++ b/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/check_graphite.py
@@ -0,0 +1,286 @@
+#!/usr/bin/env python
+"""
+check_graphite.py
+~~~~~~~
+
+:copyright: (c) 2012 DISQUS.
+:license: Apache License 2.0, see LICENSE for more details.
+"""
+
+import json
+import optparse
+import urllib
+import urllib2
+import sys
+
+from numbers import Real
+
+NAGIOS_STATUSES = {
+ 'OK': 0,
+ 'WARNING': 1,
+ 'CRITICAL': 2,
+ 'UNKNOWN': 3
+}
+
+class Graphite(object):
+
+ def __init__(self, url, targets, _from, _until):
+ self.url = url.rstrip('/')
+ self.targets = targets
+ self._from = _from
+ self._until = _until
+ params = [('target', t) for t in self.targets] +\
+ [('from', self._from)] +\
+ [('until', self._until)] +\
+ [('format', 'json')]
+ self.full_url = self.url + '/render?' +\
+ urllib.urlencode(params)
+
+ def check_datapoints(self, datapoints, check_func, **kwargs):
+ """Find alerting datapoints
+
+ Args:
+ datapoints (list): The list of datapoints to check
+
+ Kwargs:
+ check_func (function): The function to find out of bounds datapoints
+ bounds (list): Compare against `datapoints` to find out of bounds list
+ compare (list): Used for comparison if `datapoints` is out of bounds
+ threshold (float): `check_func` is called for each datapoint against `threshold`
+ beyond (float): Return datapoint if `beyond` value in bounds list (percentage).
+
+ Returns:
+ The list of out of bounds datapoints
+ """
+ if 'threshold' in kwargs:
+ return [x for x in datapoints if isinstance(x, Real) and check_func(x, kwargs['threshold'])]
+ elif 'bounds' in kwargs:
+ if 'compare' in kwargs:
+ return [datapoints[x] for x in xrange(len(datapoints)) if all([datapoints[x], kwargs['bounds'][x], kwargs['compare'][x]]) and check_func(datapoints[x] / kwargs['bounds'][x], kwargs['beyond']) and check_func(datapoints[x], kwargs['compare'][x])]
+ else:
+ return [datapoints[x] for x in xrange(len(datapoints)) if all([datapoints[x], kwargs['bounds'][x]]) and check_func(datapoints[x], kwargs['bounds'][x])]
+
+ def fetch_metrics(self):
+ try:
+ response = urllib2.urlopen(self.full_url)
+
+ if response.code != 200:
+ return None
+ else:
+ return json.loads(response.read())
+ except urllib2.URLError, TypeError:
+ return None
+
+ def generate_output(self, datapoints, *args, **kwargs):
+ """Generate check output
+
+ Args:
+ datapoints (list): The list of datapoints to check
+ warn_oob (list): Optional list of datapoints considered in warning state
+ crit_oob (list): Mandatory list of datapoints considered in warning state
+
+ Kwargs:
+ count (int): Number of metrics that would generate an alert
+ warning (float): The check's warning threshold
+ critical (float): The check's critical threshold
+ target (str): The target for `datapoints`
+
+ Returns:
+ A dictionary of datapoints grouped by their status ('CRITICAL', 'WARNING', 'OK')
+ """
+ check_output = dict(OK=[], WARNING=[], CRITICAL=[])
+ count = kwargs['count']
+ warning = kwargs.get('warning', 0)
+ critical = kwargs.get('critical', 0)
+ target = kwargs.get('target', 'timeseries')
+
+ if len(args) > 1:
+ (warn_oob, crit_oob) = args
+ else:
+ crit_oob = [x for x in args[0] if isinstance(x, Real)]
+ warn_oob = []
+
+ if self.has_numbers(crit_oob) and len(crit_oob) >= count:
+ check_output['CRITICAL'].append('%s [crit=%f|datapoints=%s]' %\
+ (target, critical, ','.join(['%s' % str(x) for x in crit_oob])))
+ elif self.has_numbers(warn_oob) and len(warn_oob) >= count:
+ check_output['WARNING'].append('%s [warn=%f|datapoints=%s]' %\
+ (target, warning, ','.join(['%s' % str(x) for x in warn_oob])))
+ else:
+ check_output['OK'].append('%s [warn=%0.3f|crit=%f|datapoints=%s]' %\
+ (target, warning, critical, ','.join(['%s' % str(x) for x in datapoints])))
+
+ return check_output
+
+ def has_numbers(self, lst):
+ try:
+ return any([isinstance(x, Real) for x in lst])
+ except TypeError:
+ return False
+
+
+if __name__ == '__main__':
+ parser = optparse.OptionParser()
+ parser.add_option('-U', '--graphite-url', dest='graphite_url',
+ default='http://localhost/',
+ metavar='URL',
+ help='Graphite URL [%default]')
+ parser.add_option('-t', '--target', dest='target',
+ action='append',
+ help='Target to check')
+ parser.add_option('--compare', dest='compare',
+ metavar='SERIES',
+ help='Compare TARGET against SERIES')
+ parser.add_option('--from', dest='_from',
+ help='From timestamp/date')
+ parser.add_option('--until', dest='_until',
+ default='now',
+ help='Until timestamp/date [%default]')
+ parser.add_option('-c', '--count', dest='count',
+ default=0,
+ type='int',
+ help='Alert on at least COUNT metrics [%default]')
+ parser.add_option('--beyond', dest='beyond',
+ default=0.7,
+ type='float',
+ help='Alert if metric is PERCENTAGE beyond comparison value [%default]')
+ parser.add_option('--percentile', dest='percentile',
+ default=0,
+ type='int',
+ metavar='PERCENT',
+ help='Use nPercentile Graphite function on the target (returns one datapoint)')
+ parser.add_option('--empty-ok', dest='empty_ok',
+ default=False,
+ action='store_true',
+ help='Empty data from Graphite is OK')
+ parser.add_option('--confidence', dest='confidence_bands',
+ default=False,
+ action='store_true',
+ help='Use holtWintersConfidenceBands Graphite function on the target')
+ parser.add_option('--over', dest='over',
+ default=True,
+ action='store_true',
+ help='Over specified WARNING or CRITICAL threshold [%default]')
+ parser.add_option('--under', dest='under',
+ default=False,
+ action='store_true',
+ help='Under specified WARNING or CRITICAL threshold [%default]')
+ parser.add_option('-W', dest='warning',
+ type='float',
+ metavar='VALUE',
+ help='Warning if datapoints beyond VALUE')
+ parser.add_option('-C', dest='critical',
+ type='float',
+ metavar='VALUE',
+ help='Critical if datapoints beyond VALUE')
+
+ (options, args) = parser.parse_args()
+
+ if not all([getattr(options, option) for option in ('_from', 'target')]):
+ parser.print_help()
+ sys.exit(NAGIOS_STATUSES['UNKNOWN'])
+
+ real_from = options._from
+
+ if options.under:
+ check_func = lambda x, y: x < y
+ options.over = False
+ else:
+ check_func = lambda x, y: x > y
+
+ if options.confidence_bands:
+ targets = [options.target[0], 'holtWintersConfidenceBands(%s)' % options.target[0]]
+ check_threshold = None
+ from_slice = int(options._from) * -1
+ real_from = '-2w'
+
+ if options.compare:
+ targets.append(options.compare)
+ else:
+ if not all([getattr(options, option) for option in ('critical', 'warning')]):
+ parser.print_help()
+ sys.exit(NAGIOS_STATUSES['UNKNOWN'])
+
+ if options.percentile:
+ targets = ['nPercentile(%s, %d)' % (options.target[0], options.percentile)]
+ else:
+ targets = options.target
+
+ try:
+ warn = float(options.warning)
+ crit = float(options.critical)
+ except ValueError:
+ print 'ERROR: WARNING or CRITICAL threshold is not a number\n'
+ parser.print_help()
+ sys.exit(NAGIOS_STATUSES['UNKNOWN'])
+
+ check_output = {}
+ graphite = Graphite(options.graphite_url, targets, real_from, options._until)
+ metric_data = graphite.fetch_metrics()
+
+ if metric_data:
+ if options.confidence_bands:
+ actual = [x[0] for x in metric_data[0].get('datapoints', [])][from_slice:]
+ target_name = metric_data[0]['target']
+ kwargs = {}
+ kwargs['beyond'] = options.beyond
+
+ if options.over:
+ kwargs['bounds'] = [x[0] for x in metric_data[1].get('datapoints', [])][from_slice:]
+ elif options.under:
+ kwargs['bounds'] = [x[0] for x in metric_data[2].get('datapoints', [])][from_slice:]
+
+ if options.compare:
+ kwargs['compare'] = [x[0] for x in metric_data[3].get('datapoints', [])][from_slice:]
+
+ if not graphite.has_numbers(kwargs['compare']):
+ print 'CRITICAL: No compare target output from Graphite!'
+ sys.exit(NAGIOS_STATUSES['CRITICAL'])
+
+ if graphite.has_numbers(actual) and graphite.has_numbers(kwargs['bounds']):
+ points_oob = graphite.check_datapoints(actual, check_func, **kwargs)
+ check_output[target_name] = graphite.generate_output(actual,
+ points_oob,
+ count=options.count,
+ target=target_name)
+
+ else:
+ print 'CRITICAL: No output from Graphite for target(s): %s' % ', '.join(targets)
+ sys.exit(NAGIOS_STATUSES['CRITICAL'])
+ else:
+ for target in metric_data:
+ datapoints = [x[0] for x in target.get('datapoints', []) if isinstance(x[0], Real)]
+ if not graphite.has_numbers(datapoints) and not options.empty_ok:
+ print 'CRITICAL: No output from Graphite for target(s): %s' % ', '.join(targets)
+ sys.exit(NAGIOS_STATUSES['CRITICAL'])
+
+ crit_oob = graphite.check_datapoints(datapoints, check_func, threshold=crit)
+ warn_oob = graphite.check_datapoints(datapoints, check_func, threshold=warn)
+ check_output[target['target']] = graphite.generate_output(datapoints,
+ warn_oob,
+ crit_oob,
+ count=options.count,
+ target=target['target'],
+ warning=warn,
+ critical=crit)
+ else:
+ if options.empty_ok and isinstance(metric_data, list):
+ print 'OK: No output from Graphite for target(s): %s' % ', '.join(targets)
+ sys.exit(NAGIOS_STATUSES['OK'])
+
+ print 'CRITICAL: No output from Graphite for target(s): %s' % ', '.join(targets)
+ sys.exit(NAGIOS_STATUSES['CRITICAL'])
+
+ for target, messages in check_output.iteritems():
+ if messages['CRITICAL']:
+ exit_code = NAGIOS_STATUSES['CRITICAL']
+ elif messages['WARNING']:
+ exit_code = NAGIOS_STATUSES['WARNING']
+ else:
+ exit_code = NAGIOS_STATUSES['OK']
+
+ for status_code in ['CRITICAL', 'WARNING', 'OK']:
+ if messages[status_code]:
+ print '\n'.join(['%s: %s' % (status_code, status) for status in messages[status_code]])
+
+ sys.exit(exit_code)
diff --git a/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/control b/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/control
new file mode 100644
index 0000000..f871084
--- /dev/null
+++ b/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/control
@@ -0,0 +1,4 @@
+Uploaders: Bernd Zeimetz <bzed@debian.org>
+Description: Plugin to monitor graphite metrics
+Homepage: https://github.com/disqus/nagios-plugins
+Recommends: python
diff --git a/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/copyright b/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/copyright
new file mode 100644
index 0000000..beddebf
--- /dev/null
+++ b/nagios-plugins-contrib-24.20190301~bpo9+1/check_graphite/copyright
@@ -0,0 +1,5 @@
+Copyright: (c) 2012 DISQUS.
+License: Apache License 2.0
+
+On Debian systems, a copy of the Apache License 2.0 can be found in
+/usr/share/common-licenses/Apache-2.0