Contexte

Le pack cisco-WIFI-by-SNMP__shinken permet de superviser les contrôleurs Cisco WLAN ainsi que les points d'accès qui leur sont rattachés. Les vérifications sont effectuées grâce au protocole SNMP, via des appels actifs exécutés depuis les pollers de Shinken.

• Le pack vous permet de vérifier :
  • l'utilisation ( Cpu, Memory ) des ressources du contrôleur.
  • l'état matériel du contrôleur ( Hardware Health ).
  • l'état d'un point d'accès ( Access Point Status ).
  • les informations de clients connectés pour un point d'accès donné ( Client Connected ).
• Les commandes de vérifications exécutées depuis les serveurs Shinken utilisent une sonde PYTHON présente dans le répertoire des sondes Shinken /var/lib/shinken-user/libexec/shinken-additional-packs/cisco-WIFI-by-SNMP__shinken/ ( ou $GLOBAL_cisco-WIFI-by-SNMP_SHINKEN_PLUGINSDIR $ depuis l'interface de configuration ), après la mise en place du pack.

Le pack se compose de deux grandes familles de modèles d'hôtes :

• Les modèles "AP", pour superviser un point d'accès Cisco à travers son contrôleur :
  • cisco-WIFI-by-SNMPv1v2__Access-Point qui permet d'obtenir l'état du point d'accès et les informations de clients connectés en SNMP v1 ou v2.
  • cisco-WIFI-by-SNMPv3__Access-Point__( noAuthNoPriv / authNoPriv / authPriv ) qui permet d'obtenir l'état du point d'accès et les informations de clients connectés en SNMP v3.

• Les modèles "Controller", pour superviser le contrôleur Cisco WLAN :
  • cisco-WIFI-by-SNMPv1v2__Controller qui permet la supervision des ressources et de l'état matériel du contrôleur en SNMP v1 ou v2 ( Cpu, Memory, Hardware Health ).
  • cisco-WIFI-by-SNMPv3__Controller__( noAuthNoPriv / authNoPriv / authPriv ) qui permet la supervision des ressources et de l'état matériel du contrôleur en SNMP v3 ( Cpu, Memory, Hardware Health ).

Ce pack est importé et mis à jour par la source " shinken-additional-packs-import ".

Voici un aperçu du contenu du pack :

Comment utiliser son pack ?

Mise en place

Pour utiliser les packs externes Shinken, il faut commencer par les installer sur son infrastructure Shinken. Cette action permet :

• D'installer sur les serveurs les sondes ( le code informatique ) nécessaires aux vérifications.
• De faire apparaître sur l'interface de configuration les nouveaux modèles.
• De préparer l'équipement à superviser ( contrôleur Cisco WLAN et points d'accès associés ) pour accepter les requêtes de supervision.

Une page dédiée explique comment mettre en place le pack cisco-WIFI-by-SNMP ( Page  Mise en place du Pack cisco-WIFI-by-SNMP__shinken ).

Utilisation

Choisir les modèles d'hôtes

Une fois le pack installé, il suffit d'appliquer les modèles nouvellement importés sur les hôtes à superviser :

• En utilisant l'interface de configuration : Créez ou éditez un Hôte, et ajoutez un des modèles ; "cisco-WIFI-by-SNMPv3__Controller__authPriv " par exemple ; grâce au menu déroulant ( voir la page Éditer un Hôte ).
• En éditant les fichiers de définition d'élément ( .cfg ) :
  • Dans un fichier de configuration, créez ou éditez votre définition d'hôte en ajoutant, dans la propriété "use", la valeur " cisco-WIFI-by-SNMPv3__Controller__authPriv ".
  • Le fichier de configuration devra alors être importé avec une source ( voir la page Collecteur de type ( cfg-file-import ) - Import depuis des fichiers au format .cfg ).

Liste des modèles à utiliser dans le pack

Personnaliser son pack

Il est possible de modifier certains éléments ( commandes, checks ou modèles d'hôtes )

• voir la page Les bonnes pratiques d'utilisation d'un pack livré par Shinken .

Version des scripts livrés