Observium est un logiciel de supervision réseau permettant de faire des mesures fines de débit par port/VLAN/« client »/… selon les informations des descriptions saisies dans les interfaces de Quagga – un script snmp permet de faire remonter ces informations pour observium.

La supervision réseau est située sur gaffe à Toulouse dans l'infra de tetaneutral.

Installation

L'installation est directement basée sur le tutoriel Debian/Ubuntu — anciennement le tutoriel SVN. L'installation se fait dans le répertoire /srv/observium/observium.

Le petit ajout est la création d'un utilisateur système observium et de faire tourner le vhost apache avec cet utilisateur :

addgroup observium
adduser --system --home /srv/observium/observium/ --shell /bin/false --ingroup observium observium
# Cf. problème de permission
adduser observium nagios
chown -R observium:observium /srv/observium/observium/

Avant de faire addhost.php, il faut autoriser l'IP de gaffe dans la configuration snmp des routeurs et dans la configuration shorewall de soupirail.

Lors de la configuration d'apache, ne pas oublier d'ajouter la directive NameVirtualHost *:443 dans le ports.conf.

Attention, depuis check_mk 1.2, les permissions du fichier htpasswd.users sont différentes :

-rw-rw---- 1 nagios nagios 453 juin  14 18:32 /etc/nagios3/htpasswd.users

Il faut donc rajouter l'utilisateur observium au groupe nagios.

Utilisation

Ajout d'un utilisateur

Il faut que cet utilisateur soit présent dans le fichier /etc/nagios3/htpasswd.users.

Ensuite, dans /srv/observium/observium/, exécuter la commande ./adduser.php <username> <password> <level>. Pour le level, mettre 10 pour tous les droits ; le mot de passe saisi ici doit être le même que celui qui est dans le fichier htpasswd.users.

Ajout de la supervision d'un équipement

Le fonctionnement de base d'observium est d'utiliser le protocole snmp pour récupérer les informations.

Sur les équipements à surveiller

Il faut rendre accessible l'équipement en snmp depuis gaffe.grenode.net et renseigner la communauté.

Installation sur une machine debian :

Description des interfaces sous Debian GNU Linux

Il faut indiquer à snmp d'utiliser un script dédié :

  • Soit dans /etc/network/interfaces : il faut utiliser le script snmpd ifAlias. La notion se fait sous la forme :

    # <interface>: <description>
    # exemple : 
    # eth1.606 : transit: Ielo
    
  • Soit dans quagga : il faut utiliser le script snmpd ifAliasQuagga

dans le fichier de configuration snmpd, il faut ajouter :

pass_persist -p 1 .1.3.6.1.2.1.31.1.1.1.18 /usr/local/sbin/snmpd_ifAlias

ou

pass_persist -p 1 .1.3.6.1.2.1.31.1.1.1.18 /usr/local/sbin/snmpd_ifAliasQuagga

Sur observium

Il suffit d'ajouter la machine à surveiller depuis l'interface web. Tout le reste est normalement autoconfiguré.

To be completed