First version

This commit is contained in:
Benjamin Renard 2022-10-08 10:09:21 +02:00 committed by Benjamin Renard
commit 91f949b6a2
3 changed files with 157 additions and 0 deletions

2
.gitignore vendored Normal file
View file

@ -0,0 +1,2 @@
*~
.*.swp

41
README.md Normal file
View file

@ -0,0 +1,41 @@
# Monitoring plugin to check if pip upgrades is available
This Icinga/Nagios check plugin permit to check if pip upgrades is available.
## Installation
```
apt install git
git clone https://gitea.zionetrix.net/bn8/check_pip_upgrade.git /usr/local/src/check_pip_upgrade
mkdir -p /usr/local/lib/nagios/plugins
ln -s /usr/local/src/check_pip_upgrade/check_pip_upgrade /usr/local/lib/nagios/plugins/
echo "command[check_pip_upgrade]=/usr/local/lib/nagios/plugins/check_pip_upgrade" > /etc/nagios/nrpe.d/pip.cfg
service nagios-nrpe-server reload
```
## Usage
```
usage: check_pip_upgrade [-h] [-d] [-b BIN] [packages ...]
positional arguments:
packages Python package(s) to check. By default, all installed packages are checkesd.
optional arguments:
-h, --help show this help message and exit
-d, --debug
-b BIN, --bin BIN Python binary path
```
## Copyright
Copyright (c) 2022 Benjamin Renard <brenard@zionetrix.net>
## License
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

114
check_pip_upgrade Executable file
View file

@ -0,0 +1,114 @@
#!/usr/bin/env python
"""
Icinga/Nagios plugin to check if pip upgrade is available
Copyright (c) 2022 Benjamin Renard <brenard@zionetrix.net>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License version 3
as published by the Free Software Foundation.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
"""
import sys
import subprocess
import argparse
import json
import os
import logging
import traceback
# nagios exit code
STATUS = {
'OK': 0,
'WARNING': 1,
'CRITICAL': 2,
'UNKNOWN': 3
}
parser = argparse.ArgumentParser()
parser.add_argument(
'-d', '--debug',
action="store_true",
dest="debug",
default=False
)
parser.add_argument(
'-b', '--bin',
action="store",
dest="bin",
help="Python binary path",
type=str
)
parser.add_argument(
action="store",
dest="packages",
help=(
"Python package(s) to check. By default, all installed"
"packages are checked."
),
nargs='*',
default=[]
)
options = parser.parse_args()
logging.basicConfig(
level=logging.DEBUG if options.debug else logging.INFO,
format='%(asctime)s - %(levelname)s - %(message)s')
if options.bin and not os.path.exists(options.bin):
print(f'UNKNOWN - python executable "{options.bin}" not found')
sys.exit(STATUS['UNKNOWN'])
cmd = [
options.bin if options.bin else sys.executable, '-m', 'pip', 'list',
'--format', 'json', '--outdated'
]
logging.debug('Execute external command: %s', ' '.join(cmd))
output = subprocess.check_output(cmd)
logging.debug('Output:\n%s', output)
try:
outdated_packages = dict(
(package['name'], package)
for package in json.loads(output)
if not options.packages or package['name'] in options.packages
)
except Exception as exc:
print('UNKNOWN - Exception occured parsing pip output')
traceback.print_exc(exc)
sys.exit(STATUS['UNKNOWN'])
if outdated_packages:
if len(outdated_packages) > 1:
print(f'WARNING - {len(outdated_packages)} upgrades available')
print('\n'.join([
f' - {name} ({p["version"]} => {p["latest_version"]})'
for name, p in outdated_packages.items()
]))
else:
name = next(iter(outdated_packages))
p = outdated_packages[name]
print(
f'WARNING - available upgrade for {name} '
f'({p["version"]} => {p["latest_version"]})'
)
sys.exit(STATUS['WARNING'])
if options.packages and len(options.packages) == 1:
print(f'OK - {options.packages[0]} is uptodate')
else:
print('OK - all packages is uptodate')
sys.exit(STATUS['OK'])