90 lines
2.9 KiB
Markdown
90 lines
2.9 KiB
Markdown
# Manubulon SNMP Plugins
|
|
|
|
#### Table of Contents
|
|
|
|
1. [About](#about)
|
|
2. [License](#license)
|
|
3. [Support](#support)
|
|
4. [Requirements](#requirements)
|
|
5. [Installation](#installation)
|
|
6. [Configuration](#configuration)
|
|
7. [FAQ](#faq)
|
|
8. [Thanks](#thanks)
|
|
9. [Contributing](#contributing)
|
|
|
|
## About
|
|
|
|
Manubulon SNMP plugins is a set of Icinga/Nagios plugins
|
|
to check hosts/devices using the SNMP protocol.
|
|
|
|
### Plugin Overview
|
|
|
|
Plugin | Description
|
|
------------------------------|----------------------------------------
|
|
check\_snmp\_storage | Storage checks (disks, swap, memory, etc.)
|
|
check\_snmp\_int | Interface states, usage on hosts, switches, routers, etc.
|
|
check\_snmp\_process | Running processes, their number, used CPU and memory.
|
|
check\_snmp\_load | Load/CPU checks
|
|
check\_snmp\_mem | Memory and swap usage
|
|
check\_snmp\_env | Environmental status of fan, temp, power supplies.
|
|
check\_snmp\_vrrp | Interface state of a VRRP cluster
|
|
check\_snmp\_cpfw | Checkpoint Firewall-1 status
|
|
check\_snmp\_win | Windows services
|
|
check\_snmp\_css | CSS service states
|
|
check\_snmp\_nsbox | Nsbox VHost and diode status
|
|
check\_snmp\_boostedge | Boostedge services
|
|
check\_snmp\_linkproof\_ndr | Linkproof NHR
|
|
|
|
## License
|
|
|
|
These plugins are licensed under the terms of the GNU General Public License.
|
|
You will find a copy of this license in the LICENSE file included in the source package.
|
|
|
|
## Support
|
|
|
|
Join the [Icinga community channels](https://www.icinga.com/about/get-involved/) for questions.
|
|
|
|
If you want to help maintain this project, just contact
|
|
me on [twitter](https://twitter.com/dnsmichi) and I'll
|
|
happily grant commit access.
|
|
|
|
## Requirements
|
|
|
|
* Perl in `/usr/bin/perl`
|
|
* Perl modules
|
|
[Net::SNMP](http://search.cpan.org/~dtown/Net-SNMP-v6.0.1/lib/Net/SNMP.pm) and
|
|
[Getopt::Long](http://search.cpan.org/~jv/Getopt-Long-2.49.1/lib/Getopt/Long.pm)
|
|
* `icinga` user able to write files in /tmp/ directory
|
|
* SNMP v3 authentication: Perl modules
|
|
[Crypt::DES](http://search.cpan.org/~dparis/Crypt-DES-2.07/DES.pm),
|
|
[Crypt::Rijndael](http://search.cpan.org/~leont/Crypt-Rijndael-1.13/Rijndael.pm) and
|
|
[Digest::HMAC](http://search.cpan.org/~gaas/Digest-HMAC-1.03/lib/Digest/HMAC.pm)
|
|
|
|
## Installation
|
|
|
|
Detailed installation instructions can be found [here](doc/02-Installation.md).
|
|
|
|
## Configuration
|
|
|
|
Proceed [here](doc/03-Configuration.md) to get details on the configuration with Icinga 2, Icinga 1.x, etc.
|
|
|
|
## FAQ
|
|
|
|
|
|
## Thanks
|
|
|
|
Patrick Proy for creating and maintaining the original plugins.
|
|
|
|
## Contributing
|
|
|
|
Fork this repository on GitHub and send in a PR.
|
|
|
|
There's a `.perltidyrc` file in the main repository tree. If you are uncertain about the coding style,
|
|
create your patch and then run:
|
|
|
|
```
|
|
$ perltidy -b plugins/*.pl
|
|
```
|
|
|
|
This requires the `perltidy` module being installed.
|