Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=same_as_next_version
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue
Panel
titleSommaire

Table of Contents
stylenone

Contexte

Afin
de superviser un switch via les protocoles SNMP v1 et v2, le pack switch vous offre deux modèles d'hôtes.switch-SNMPv1v2, permet une supervision

Les checks que nous fournissons supervisent qu'une partie des éléments d'un switch

pour une utilisation minimale et synthétique.
  • switch-SNMPv1v2-detailed,  permet une supervision d'un switch pour une utilisation détaillée de chaque interface réseau et fournit des informations supplémentaires ( utilisation CPU, consommation mémoire… ).
  • Les deux modèles d'hôtes héritent d'un modèle ( switch-base ) contenant les données de base pour une configuration SNMP. L'hôte supervisé héritera à son tour des données des modèles.

    Consulter le tableau suivant pour comparer les modèles et choisir celui convenant le mieux pour votre supervision.

    Excerpt Section Column
    width50%
    switch-SNMPv1v2
    • Offre une vue synthétique, chaque check représentant l'état général de toutes les interfaces de l'équipement réseau.
    • Nécessite simplement la configuration du protocole SNMP ( aucune configuration par interface de l'équipement réseau ).
    • Conseillé, uniquement, si vous avez besoin de connaitre l'état général de votre switch, sans avoir besoin d'identifier le problème.
    • Il sera difficile de trouver la source du problème via ce modèle, car il n'est pas conçu pour cela.
      • Les erreurs se perdant au milieu des informations des multiples interfaces réseau.
      • Attention, si votre check est déjà en CRITIQUE, un deuxième problème ne génèrera pas une nouvelle notification, car son état ne changera pas.

    ( voir la page Modèle switch-SNMPv1v2 )

    Column
    width50%
    switch-SNMPv1v2-detailed
    • Offre une vue détaillée. Il permet de faire un check par interface d'équipement réseau.
    • Nécessite la configuration du protocole SNMP et de configurer le nom de toutes les interfaces dans l'interface de configuration Shinken.
    • Conseillé si vous avez besoin de connaitre l'état de votre switch et d'identifier directement la cause du problème.
    • Pour identifier les causes du problème, le modèle fourni :
      • Plusieurs checks par interface ( ce qui permet de détecter plus facilement le ou les interfaces problématiques ).
      • Des checks supplémentaires comme l'utilisation CPU, la consommation mémoire…

    ( voir la page Modèle switch-SNMPv1v2-detailed )

    Liste des modèles d'hôte pour SNMP v1 et v2

    .

    La sonde fournie avec le pack met à disposition plus d'une centaine informations/options ( interface-health, interface-uptime, svn-status ... ).

    Pour des besoins plus précis, il vous sera nécessaire de créer de nouveaux checks ( voir la page Les bonnes pratiques d'utilisation d'un pack livré par Shinken ).

    Lister toutes les informations et options de la sonde 

    La commande "/var/lib/shinken/libexec/check_nwc_health --help" donne la liste de tous les paramètres et options de la sonde.

    Code Block
    languagetext
    themeEmacs
    [root@machine ~]# /var/lib/shinken/libexec/check_nwc_health --help
    check_nwc_health $Revision: 10.12.1 $ [http://labs.consol.de/nagios/check_nwc_health]
    
    This monitoring plugin is free software, and comes with ABSOLUTELY NO WARRANTY.
    It may be used, redistributed and/or modified under the terms of the GNU
    General Public Licence (see http://www.fsf.org/licensing/licenses/gpl.txt).
    
    This plugin checks various parameters of network components
    
    Usage: check_nwc_health [ -v|--verbose ] [ -t <timeout> ] --mode <what-to-do> --hostname <network-component> --community <snmp-community>  ...]
     -?, --usage
       Print usage information
     -h, --help
       Print detailed help screen
     -V, --version
       Print version information
     -t, --timeout=INTEGER
       Seconds before plugin times out (default: 15)
     -v, --verbose
       Show details for command-line debugging (can repeat up to 3 times)
     --hostname
       Hostname or IP-address of the switch or router
     --port
       The SNMP port to use (default: 161)
     ...

    ( plus de détails sur le site du créateur de la sonde https://labs.consol.de/nagios/check_nwc_health/index.html )

    Faire un nouveau check 

    Pour pouvoir superviser de nouveaux éléments de votre switch, il vous sera nécessaire de créer des nouveaux checks.

    Voici un exemple concret pour créer une nouvelle commande qui permet de lister vos interfaces supervisables.

    Le procédé est le même pour chaque version de SNMP.

    Exemple : création d'une commande qui liste les interfaces réseaux en SNMPv2

    Rechercher un paramètre dans la commande qui répond à notre besoin

    On trouve un argument qui décrit ce que l'on cherche :


    Code Block
    languagetext
    themeEmacs
    [root@machine ~]# /var/lib/shinken/libexec/check_nwc_health --help
    check_nwc_health $Revision: 10.12.1 $ [http://labs.consol.de/nagios/check_nwc_health]
     
    This monitoring plugin is free software, and comes with ABSOLUTELY NO WARRANTY.
    It may be used, redistributed and/or modified under the terms of the GNU
    General Public Licence (see http://www.fsf.org/licensing/licenses/gpl.txt).
     
    This plugin checks various parameters of network components
     
    Usage: check_nwc_health [ -v|--verbose ] [ -t <timeout> ] --mode <what-to-do> --hostname <network-component> --community <snmp-community>  ...]
     -?, --usage
       Print usage information
     -h, --help
       Print detailed help screen
     -V, --version
       Print version information
     ...
     --mode
       A keyword which tells the plugin what to do
           hardware-health                  (Check the status of environmental equipment (fans, temperatures, power))
           cpu-load                         (Check the CPU load of the device)
           memory-usage                     (Check the memory usage of the device)
           ...
           list-interfaces                  (Show the interfaces of the device and update the name cache)
           ...
     ...

    Dans la recherche ci-dessus, on voit dans le paramètre "--mode", l'option "list-interfaces" correspondant au besoin et sera utilisée dans la nouvelle commande. 

    Le clone d'une commande et sa modification

    Cloner la commande check_switch_hardware_health.

    Panel

    Image Added

    Éditer la nouvelle commande en changeant le nom et la ligne de commande.

    Panel

    Image Added

    Création du nouveau modèle d'hôte

    On vous conseille de créer un nouveau modèle et non de modifier ceux fournis dans le pack par Shinken.

    Panel

    Image Added

    Dans notre exemple, nous n'utilisons que le modèle Switch-base, mais dans d'autres cas, il pourrait être utile d'utiliser les autres modèles fournis par le pack ( Switch-SNMPv1v2, Switch-SNMPv1v2-detailed).

    Panel

    Image Added

    Création du check appliqué à notre nouveau modèle d'hôte

    Cloner le check Hardware Health Switch SNMPv1v2.

    Panel

    Image Added

    Éditer le nouveau check en changeant le nom, attaché sur le modèle d'hôte et la commande de vérification.

    Panel

    Image Added

    Panel

    Image Added

    Confirmer le fonctionnement du nouveau check 

    Nous vous conseillons de faire un essai de check sur l'hôte dans lequel vous avez attaché le modèle avant de pousser vos nouveautés en production.

    Panel

    Image Added

    NomLien
    No Format
    switch-SNMPv1v2
    Modèle switch-SNMPv1v2
    No Format
    switch-SNMPv1v2-detailed
    Modèle switch-SNMPv1v2-detailed Excerpt IncludeMise en place du Pack Switch-SNMPMise en place du Pack Switch-SNMPnopaneltrue