skip to navigation
skip to content

alignak_checks_snmp 1.0.0

Alignak checks pack for Linux SNMP monitored hosts

Alignak checks package for Unix/Linux SNMP checked hosts/services

*Checks pack for monitoring Unix/Linux or Windows hosts with SNMP active checks*

.. image::
:alt: Most recent PyPi version

.. image::
:alt: Join the chat #alignak on

.. image::
:alt: License AGPL v3

**Note** that the Windows part for this pack is not yet available.

**If you are interested in such a checks pack and if you are monitoring some Windows hosts with SNMP, please contact us (IRC or open an issue in this project)**


The installation of this checks pack will copy some configuration files in the Alignak default configuration directory (eg. */usr/local/etc/alignak*). The copied files are located in the default sub-directory used for the packs (eg. *arbiter/packs*).

From PyPI
To install the package from PyPI:

sudo pip install alignak-checks-snmp

From source files
To install the package from the source files:

git clone
cd alignak-checks-snmp
sudo pip install .

**Note:** *using `sudo python install` will not correctly manage the package configuration files! The recommended way is really to use `pip`;)*


This checks pack is using the some PERL plugins that are shipped with the checks pack, but some PERL dependencies are necessary.

Install PERL dependencies for PERL plugins

On some Linux distros, you can::

sudo apt-get install libsnmp-perl libnet-snmp-perl

Or you can use the PERL *cpan* utility::

cpan install Net::SNMP

Edit the */usr/local/etc/alignak/arbiter/packs/snmp/resources.cfg* file and configure the SNMP community.

#-- Default SNMP community

Prepare host
Some operations are necessary on the monitored hosts if SNMP remote access is not yet activated.

# Install local SNMP agent
su -
apt-get update
apt-get install snmpd

# Allow SNMP get - this configuration is intended for tests puuposes
# You should set up a more secure configuration and not allow everyone to see everything :)
vi /etc/snmp/snmpd.conf
# Listen for connections from the local system only
#agentAddress udp:
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
agentAddress udp:161,udp6:[::1]:161
# rocommunity public default -V systemonly
rocommunity public
# Restart SNMP agent
/etc/init.d/snmpd restart

Test remote access with the plugins files:

$ /usr/local/var/libexec/alignak/ -H -C public -w 80,80 -c 90,95
Ram : 71%, Swap : 58% : ; OK

Alignak configuration

To define the SNMP community to be used per default, edit the *resources.cfg* file and change the default value.

You simply have to tag the concerned hosts with the template `linux-snmp`.

define host{
use linux-snmp
host_name host_snmp

The main `linux-snmp` template declares macros used to configure the launched checks. The default values of these macros listed hereunder can be overriden in each host configuration.


_LOAD_WARN 2,2,2
_LOAD_CRIT 3,3,3
_NET_IFACES eth\d+|em\d+
_NET_WARN 90,90,0,0,0,0
_NET_CRIT 0,0,0,0,0,0

To set a specific value for an host, declare the same macro in the host definition file.

define host{
use linux-snmp
host_name host_snmp

# Specific values for this host
# Change warning and critical alerts level for memory
# Same for CPU, ALL_CPU, DISK, LOAD, NET, ...
_LOAD_WARN 3,3,3
_LOAD_CRIT 5,5,5

Bugs, issues and contributing

Contributions to this project are welcome and encouraged ... `issues in the project repository <https:"" alignak-monitoring-contrib="" alignak-checks-linux-snmp="" issues="">`_ are the common way to raise an information.  
File Type Py Version Uploaded on Size
alignak_checks_snmp-1.0.0.tar.gz (md5) Source 2017-09-12 93KB