alignak_checks_snmp 0.1.0

Alignak - Checks pack for monitoring hosts with SNMP

Alignak checks package for SNMP
======================================

Checks pack for monitoring hosts with SNMP


Installation
----------------------------------------

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 https://github.com/Alignak-monitoring-contrib/alignak-checks-snmp
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


Documentation
----------------------------------------

Configuration
~~~~~~~~~~~~~~~~~~~~~~~

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
$SNMPCOMMUNITYREAD$=public

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:127.0.0.1:161
# 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/check_snmp_mem.pl -w 80 -c 95 -- -v 2c -c public 127.0.0.1
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.
::
_SNMPCOMMUNITY $SNMPCOMMUNITYREAD$
_SNMP_MSG_MAX_SIZE 65535

_LOAD_WARN 2,2,2
_LOAD_CRIT 3,3,3
_STORAGE_WARN 90
_STORAGE_CRIT 95
_CPU_WARN 80
_CPU_CRIT 90
_MEMORY_WARN 80
_MEMORY_CRIT 95
_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
address 192.168.0.18

# 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.

License
----------------------------------------

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

.. _GPL version 3 license: http://opensource.org/licenses/GPL-3.0