Avertissement

Attention : Grenode est passé à LibreNMS depuis 2018. Cette documentation n'est plus du tout à jour.

Voir LibreNMS pour la documentation à jour concernant LibreNMS.

Présentation

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.

Installation du plugin weathermap

http://blog.best-practice.se/2014/07/using-php-weathermap-with-observium.html

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

Ajout d'une weathermap

Le plus simple est d'utiliser l'éditeur en ligne : https://observium.grenode.net/weathermap/editor.php

  • créer une nouvelle carte ou en copier une existante. Le nom de la carte doit finir en .conf
  • dans "Map Properties", changer "Output Image Filename" à maps/truc.png, et "Output HTML Filename" à maps/truc.html
  • s'amuser à placer des liens et des noeuds :)
  • en cliquant sur un lien, il est possible de lui associer un graphe (récupéré d'observium)
  • la configuration générée par l'éditeur web est dans /srv/observium/observium/html/weathermap/configs/, il est possible de l'éditer à la main, l'éditeur web respectera les changements

Plus de documentation ici : https://network-weathermap.com/manual/0.98/pages/editor.html

Accéder aux weathermaps

Les weathermaps sont normalement listées dans le menu d'observium (tout en haut, premier onglet)

Sinon, les URL sont de la forme https://observium.grenode.net/weathermap/maps/truc.html.