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 ).
Listes des modèles à utiliser dans le pack
| Nom | Lien |
|---|---|
HAproxy-by-SSH | Modèle HAproxy-by-SSH |
HAproxy-by-SSH__frontend | Modèle HAproxy-by-SSH__frontend |
HAproxy-by-SSH__backend | Modèle HAproxy-by-SSH__backend |
Personnaliser son pack
Il est possible de modifier certains éléments ( commandes, checks ou modèles d'hôtes )
Version des scripts livrés
| Nom | Version | Description |
|---|---|---|
check_haproxy_SSH.py | 01.00.00 | Script principal utilisé pour vérifier l'état du HA proxy. Écrit en Python, il utilise un "virtual env" livré par Shinken pour fonctionner ( Aucune dépendance à installer ). |