add check_nut
This commit is contained in:
parent
6d7174ad63
commit
7c559a689a
|
|
@ -0,0 +1,250 @@
|
|||
#!/usr/bin/env python3
|
||||
import argparse
|
||||
import subprocess
|
||||
import sys
|
||||
import traceback
|
||||
from pathlib import Path
|
||||
|
||||
from checker import print_icinga2_check_status, nagios
|
||||
from checker.linuxfabric.base import get_state
|
||||
from checker.types import try_float
|
||||
|
||||
UPSC_PATH = '/usr/bin/upsc'
|
||||
UNWANTED_STATS = [
|
||||
'ups.mfr',
|
||||
'ups.productid',
|
||||
'device.serial',
|
||||
'ups.vendorid',
|
||||
'device.type',
|
||||
'battery.type',
|
||||
'ups.serial',
|
||||
'device.mfr',
|
||||
'battery.mfr.date'
|
||||
]
|
||||
UNWANTED_STATS_STARTSWITH = [
|
||||
'ups.beeper.',
|
||||
'ups.delay.',
|
||||
'ups.timer.',
|
||||
]
|
||||
STATS_LEVELS = [
|
||||
'battery.charge.low',
|
||||
'battery.charge.warning',
|
||||
'input.transfer.high',
|
||||
'input.transfer.low',
|
||||
'input.voltage.nominal',
|
||||
'ups.realpower.nominal',
|
||||
'battery.runtime.low',
|
||||
'battery.voltage.nominal',
|
||||
]
|
||||
VALUE_COMPARISONS = {
|
||||
'load': 'ge',
|
||||
'battery_charge': 'le',
|
||||
'battery_runtime': 'le',
|
||||
'battery_voltage': 'le',
|
||||
'input_voltage': 'le',
|
||||
'output_voltage': 'le'
|
||||
}
|
||||
|
||||
|
||||
def parse_ups_status(status: str):
|
||||
# https://networkupstools.org/docs/developer-guide.chunked/new-drivers.html#_status_data
|
||||
status = status.lower()
|
||||
if status == 'ol':
|
||||
return 'on line', nagios.STATE_OK
|
||||
elif status == 'ob':
|
||||
return 'on battery', nagios.STATE_CRIT
|
||||
elif status == 'lb':
|
||||
return 'low battery', nagios.STATE_WARN
|
||||
elif status == 'hb':
|
||||
return 'high battery', nagios.STATE_CRIT
|
||||
elif status == 'rb':
|
||||
return 'replace battery', nagios.STATE_WARN
|
||||
elif status == 'chrg':
|
||||
return 'battery charging', nagios.STATE_OK
|
||||
elif status == 'dischrg':
|
||||
# inverter is providing load power
|
||||
return 'battery discharging', nagios.STATE_WARN
|
||||
elif status == 'bypass':
|
||||
return 'battery bypass', nagios.STATE_WARN
|
||||
elif status == 'cal':
|
||||
return 'calibrating', nagios.STATE_WARN
|
||||
elif status == 'off':
|
||||
return 'off', nagios.STATE_CRIT
|
||||
elif status == 'trim':
|
||||
return 'trimming incoming voltage', nagios.STATE_WARN
|
||||
elif status == 'boost':
|
||||
return 'boosting incoming voltage', nagios.STATE_WARN
|
||||
elif status == 'fsd':
|
||||
return 'forced shutdown', nagios.STATE_CRIT
|
||||
else:
|
||||
return 'unknown', nagios.STATE_UNKNOWN
|
||||
|
||||
|
||||
def calc_voltage_wiggle(percent: float, nominal_voltage):
|
||||
deviation = nominal_voltage * percent
|
||||
return nominal_voltage - deviation
|
||||
|
||||
|
||||
def parse_upsc(output: str):
|
||||
return [y for y in output.split('\n') if not y.startswith('Init SSL without certificate database') and y != '']
|
||||
|
||||
|
||||
def main(args):
|
||||
if not Path('/usr/bin/upsc').is_file():
|
||||
print_icinga2_check_status(f'Could not find "{UPSC_PATH}". Make sure "nut-client" is installed.', nagios.STATE_UNKNOWN)
|
||||
sys.exit(nagios.STATE_UNKNOWN)
|
||||
|
||||
try:
|
||||
cmd = subprocess.check_output(f'{UPSC_PATH} {args.path} > /dev/stdout 2> /dev/stdout', shell=True)
|
||||
ups_stats = {x[0]: x[1] for x in [y.split(': ') for y in parse_upsc(cmd.decode())]}
|
||||
except Exception as e:
|
||||
if isinstance(e, subprocess.CalledProcessError):
|
||||
lines = parse_upsc(e.output.decode())
|
||||
if len(lines) and 'data stale' in lines[0].lower():
|
||||
print_icinga2_check_status(f'Failed to get UPS status: data stale', nagios.STATE_CRIT)
|
||||
sys.exit(nagios.STATE_CRIT)
|
||||
print_icinga2_check_status(f'Failed to get UPS status: {e}', nagios.STATE_UNKNOWN)
|
||||
sys.exit(nagios.STATE_UNKNOWN)
|
||||
|
||||
# Remove unwanted stats.
|
||||
for k, v in ups_stats.copy().items():
|
||||
if k.startswith('driver.'):
|
||||
del ups_stats[k]
|
||||
for x in UNWANTED_STATS:
|
||||
if ups_stats.get(x):
|
||||
del ups_stats[x]
|
||||
for x in UNWANTED_STATS_STARTSWITH:
|
||||
for k, v in ups_stats.copy().items():
|
||||
if k.startswith(x):
|
||||
del ups_stats[k]
|
||||
|
||||
# Grab the levels from the stats.
|
||||
levels = {}
|
||||
for level in STATS_LEVELS:
|
||||
for k, v in ups_stats.copy().items():
|
||||
if k == level:
|
||||
levels[k] = try_float(v)
|
||||
del ups_stats[k]
|
||||
|
||||
# Grab the test results.
|
||||
ups_test_result = None
|
||||
if ups_stats.get('ups.test.result'):
|
||||
ups_test_result = ups_stats['ups.test.result']
|
||||
del ups_stats['ups.test.result']
|
||||
|
||||
# Grab the UPS status.
|
||||
ups_status = ups_stats['ups.status']
|
||||
del ups_stats['ups.status']
|
||||
ups_status = ups_status.split(' ')
|
||||
|
||||
# Grab the UPS model
|
||||
ups_model = None
|
||||
if ups_stats.get('device.model'):
|
||||
ups_model = ups_stats['device.model']
|
||||
del ups_stats['device.model']
|
||||
if ups_stats.get('ups.model'):
|
||||
ups_model = ups_stats['ups.model']
|
||||
del ups_stats['ups.model']
|
||||
|
||||
# Easier to read.
|
||||
if ups_stats.get('ups.load'):
|
||||
ups_stats['load'] = ups_stats['ups.load']
|
||||
del ups_stats['ups.load']
|
||||
|
||||
# Load the perfdata.
|
||||
perf_data = {}
|
||||
for k, v in ups_stats.items():
|
||||
name = k.replace('.', '_')
|
||||
perf_data[name] = {'value': try_float(v), 'warn': None, 'crit': None, 'min': 0}
|
||||
|
||||
# Set the perfdata values based on the levels.
|
||||
if perf_data.get('battery_charge'):
|
||||
perf_data['battery_charge']['warn'] = levels['battery.charge.warning']
|
||||
perf_data['battery_charge']['crit'] = levels['battery.charge.low']
|
||||
if perf_data.get('battery_runtime') and levels.get('battery.runtime.low'):
|
||||
perf_data['battery_runtime']['warn'] = args.runtime_warn
|
||||
perf_data['battery_runtime']['crit'] = levels.get('battery.runtime.low', 0)
|
||||
|
||||
# Set wiggle values
|
||||
wiggle_warn = args.wiggle_crit * 0.01
|
||||
wiggle_crit = args.wiggle_crit * 0.01
|
||||
if perf_data.get('input_voltage') and levels.get('input.voltage.nominal'):
|
||||
nominal = levels.get('input.voltage.nominal')
|
||||
if nominal:
|
||||
perf_data['input_voltage']['warn'] = calc_voltage_wiggle(wiggle_warn, nominal)
|
||||
perf_data['input_voltage']['crit'] = calc_voltage_wiggle(wiggle_crit, nominal)
|
||||
if perf_data.get('battery_voltage') and levels.get('battery.voltage.nominal'):
|
||||
nominal = levels.get('battery.voltage.nominal')
|
||||
if nominal:
|
||||
perf_data['battery_voltage']['warn'] = calc_voltage_wiggle(wiggle_warn, nominal)
|
||||
perf_data['battery_voltage']['crit'] = calc_voltage_wiggle(wiggle_crit, nominal)
|
||||
output_nominal = levels.get('input.voltage.nominal')
|
||||
if output_nominal:
|
||||
perf_data['output_voltage']['warn'] = calc_voltage_wiggle(wiggle_warn, output_nominal)
|
||||
perf_data['output_voltage']['crit'] = calc_voltage_wiggle(wiggle_crit, output_nominal)
|
||||
|
||||
# Set the perfdata values based on the input args.
|
||||
perf_data['load']['warn'] = args.load_warn
|
||||
perf_data['load']['crit'] = args.load_crit
|
||||
|
||||
# Determine our exit code based on the perfdata.
|
||||
exit_code = nagios.STATE_OK
|
||||
exit_msg = []
|
||||
for metric, value in perf_data.items():
|
||||
comparison = VALUE_COMPARISONS.get(metric, 'le')
|
||||
state = get_state(value['value'], value['warn'], value['crit'], comparison)
|
||||
if state != nagios.STATE_OK:
|
||||
if metric == 'battery_runtime' and args.ignore_bad_runtime:
|
||||
continue
|
||||
v_pretty = value["value"]
|
||||
if str(v_pretty).endswith('.0'):
|
||||
v_pretty = int(value["value"])
|
||||
name = ' '.join(metric.split('_'))
|
||||
msg = f'{name} is {v_pretty}'
|
||||
exit_msg.append(msg)
|
||||
exit_code = max(exit_code, state)
|
||||
|
||||
# Determine our exit code based on the self-test results.
|
||||
if not args.ignore_bad_test and ups_test_result.lower() != 'done and passed' and ups_test_result.lower() != 'no test initiated':
|
||||
exit_code = nagios.STATE_CRIT
|
||||
exit_msg.insert(0, f'test failed: "{ups_test_result}"')
|
||||
|
||||
# Determine our exit code based on the UPS status.
|
||||
status_msg = []
|
||||
for status in ups_status:
|
||||
msg, code = parse_ups_status(status)
|
||||
if code != nagios.STATE_OK:
|
||||
status_msg.append(msg)
|
||||
exit_code = max(exit_code, code)
|
||||
status_text = ', '.join(status_msg)
|
||||
|
||||
if not len(status_msg):
|
||||
runtime = round(perf_data["battery_runtime"]["value"] / 60, 1)
|
||||
if str(runtime).endswith('.0'):
|
||||
runtime = str(runtime).strip('.0')
|
||||
status_text = f'{int(perf_data["battery_charge"]["value"])}% charge and has {runtime} minutes of runtime'
|
||||
else:
|
||||
status_text = f'status: {status_text}'
|
||||
|
||||
text_result = status_text + '. ' + ', '.join(exit_msg).capitalize()
|
||||
print_icinga2_check_status(text_result, exit_code, perf_data)
|
||||
sys.exit(exit_code)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
parser = argparse.ArgumentParser(description="Check NUT.")
|
||||
parser.add_argument("--path", required=True, help="Path to the UPS to check. Example: `ups_name@localhost`")
|
||||
parser.add_argument("--load-warn", default=75, type=int, help="Load warning level.")
|
||||
parser.add_argument("--load-crit", default=85, type=int, help="Load critical level.")
|
||||
parser.add_argument("--runtime-warn", default=None, type=int, help="Manually set the battery runtime warning level. Default: disabled")
|
||||
parser.add_argument("--wiggle-warn", default=5, type=int, help="Value to use to determine warning level if a voltage changes this percentage from the nominal input.")
|
||||
parser.add_argument("--wiggle-crit", default=10, type=int, help="Value to use to determine critical level if a voltage changes this percentage from the nominal input.")
|
||||
parser.add_argument("--ignore-bad-runtime", action='store_true', help="Ignore the battery runtime value. Useful when you know the battery is getting old.")
|
||||
parser.add_argument("--ignore-bad-test", action='store_true', help="Ignore bad test results.")
|
||||
args = parser.parse_args()
|
||||
|
||||
try:
|
||||
main(args)
|
||||
except Exception as e:
|
||||
print_icinga2_check_status(f'exception "{e}" \n {traceback.format_exc()}', nagios.STATE_UNKNOWN)
|
||||
sys.exit(nagios.STATE_UNKNOWN)
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
def try_float(value: str) -> int | float | str:
|
||||
try:
|
||||
return float(value)
|
||||
except:
|
||||
pass
|
||||
try:
|
||||
return int(value)
|
||||
except:
|
||||
pass
|
||||
raise ValueError(f"Could not convert {value} to float or int")
|
||||
# return value
|
||||
Loading…
Reference in New Issue