View Source

Contexte

Le pack HAproxy-by-SSH__shinken permet de superviser l'état des backends et frontends mis en place sur un HAproxy. Les vérifications sont effectuées grâce à une connexion SSH.

Le pack vous permet de vérifier :
- l'état général ( Global Status ) de fonctionnement.
- l'utilisation des frontends ( Status, Response, Traffic ).
- l'utilisation des backends ( Status, Balancing ).
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/HAproxy-by-SSH__shinken/ ( ou $GLOBAL_HAPROXY-BY-SSH_SHINKEN_PLUGINSDIR$ depuis l'interface de configuration ), après la mise en place du pack.

Pour s'adapter à tous les besoins, le pack se compose de trois modèles d'hôtes :

Le modèle standard "HAproxy-by-SSH", pour superviser l'état général de HAproxy ( Il permet de mettre rapidement un HA en supervision, sans connaître le nom des frontends et backends )
Le modèle spécifique aux frontends "HAproxy-by-SSH__frontend", pour superviser en détail l'état des frontends spécifiquement sélectionnés ( en vérifiant le nombre d'utilisateurs et les erreurs d'accès ).
Le modèle spécifique aux backends "HAproxy-by-SSH__backend", pour superviser en détail l'état des backends spécifiquement séléctionnés ( en vérifiant la répartition et la disponibilités des serveurs finaux ).

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

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 nécessaires aux vérifications.
De faire apparaître sur l'interface de configuration les nouveaux modèles.
De configurer l'hôte à superviser ( Serveur HA proxy ) pour accepter les requêtes de supervision.

Une page dédiée explique comment mettre en place le pack HAproxy-by-SSH ( Page Mise en place du Pack HAproxy-by-SSH__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 ; "HAproxy-by-SSH" 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 " HAproxy-by-SSH".
- 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 ).