https://github.com/tuladhar/check_bandwidth
Nagios (NRPE) plugin for checking bandwidth limit
https://github.com/tuladhar/check_bandwidth
bandwidth-monitor check-bandwidth hacktoberfest nagios nrpe nrpe-plugin
Last synced: 11 months ago
JSON representation
Nagios (NRPE) plugin for checking bandwidth limit
- Host: GitHub
- URL: https://github.com/tuladhar/check_bandwidth
- Owner: tuladhar
- License: mit
- Created: 2016-05-07T15:46:17.000Z (about 10 years ago)
- Default Branch: main
- Last Pushed: 2020-10-05T08:40:23.000Z (over 5 years ago)
- Last Synced: 2025-05-12T21:46:12.871Z (about 1 year ago)
- Topics: bandwidth-monitor, check-bandwidth, hacktoberfest, nagios, nrpe, nrpe-plugin
- Language: Python
- Homepage:
- Size: 12.7 KB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nagios NRPE plugin: check_bandwidth
## Installation
Clone the repository :
```
git clone https://github.com/tuladhar/check_bandwidth.git
cd check_bandwidth
```
Use the following command to install check_bandwidth.py
```
make install
make install INSTALL_PATH=/usr/lib/nagios/plugins # or specify a path where you want to install the plugin
```
To remove the plugin use the following command :
```
make uninstall
make uninstall INSTALL_PATH=/usr/lib/nagios/plugins # or specify the path where the plugin is located
```
## Usage
Nagios (NRPE) plugin for checking bandwidth speed limit.
```usage
usage: check_bandwidth.py [-h] [-v] [-i name] [-w threshold] [-c threshold]
Nagios (NRPE) plugin for checking bandwidth speed limit.
optional arguments:
-h, --help show this help message and exit
-v, --version show program's version number and exit
-i name, --interface name
interface to use (default: eth0)
-w threshold, --warning threshold
threshold in bits. Appending 'K' will count the number
as Kilobits, 'M' as Megabits, 'G' as Gigabits.
Examples: 200K, 3M and 1G
-c threshold, --critical threshold
threshold in bits. Appending 'K' will count the number
as Kilobits, 'M' as Megabits and 'G' as Gigabits.
Examples: 200K, 3M and 1G
```
```shell
$ nagios/plugins/check_bandwidth.py -i venet0 -w 25M -c 50M
BANDWIDTH OK - venet0: DOWN: 11.85 Mbps, UP: 456.23 Kbps
$ nagios/plugins/check_bandwidth.py -i venet0 -w 25M -c 50M
BANDWIDTH WARNING - venet0: DOWN: 38.50 Mbps, UP: 519.87 Kbps
$ nagios/plugins/check_bandwidth.py -i venet0 -w 1M -c 10M
BANDWIDTH CRITICAL - venet0: DOWN: 38.57 Mbps, UP: 850.02 Kbps
```
## Authors
- [Puru Tuladhar](https://github.com/tuladhar)
## Contributors
- See [Contributors.md](Contributors.md)