Skip to main content

Alignak - Checks pack for monitoring hosts with SNMP

Project description

Alignak checks package for SNMP

Checks pack for monitoring hosts with SNMP


From PyPI
To install the package from PyPI:
pip install alignak-checks-snmp

From source files
To install the package from the source files:
git clone
cd alignak-checks-snmp
mkdir /usr/local/etc/alignak/arbiter_cfg/objects/packs/snmp
# Copy configuration files
cp -R alignak_checks_snmp/*.cfg /usr/local/etc/alignak/arbiter_cfg/objects/packs/snmp
# Copy plugin files
cp -R alignak_checks_snmp/plugins/* /usr/local/libexec/alignak



Edit the */usr/local/etc/alignak/arbiter_cfg/objects/packs/snmp/resources.cfg* file and configure the SNMP community to access remotely to the monitored hosts MIB.
#-- 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
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:
$ /var/lib/alignak/libexec/ -w 80 -c 95 -- -v 2c -c public
MEMORY OK: 4.24 % used; Free => 1300880 Kb, Total => 2052860 Kb, Cached => 610024 Kb, Buffered => 54904 Kb|ram_free=1300880 ram_total=2052860 ram_cached=610024 ram_buffered=54904

Alignak configuration

You simply have to tag the concerned hosts with the template `linux-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
contact_groups admins
host_name sim-vm-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 are the common way to raise an information.


Alignak Pack EXAMPLE is available under the `GPL version 3 license`_.

.. _GPL version 3 license:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for alignak_checks_snmp, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size alignak_checks_snmp-0.1.0.tar.gz (18.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page