Introduction
Ce pack contient un modèle d'hôte permettant de superviser des services graphite sur les points suivant:
- Connexion au service
- État du service (vérification du processus 'carbon-cache')
- Réception de données
- Capacité du stockage
| Panel |
|---|
|
Configuration de la connexion SSH
Avec la configuration par défaut, le pack Graphite se connecte en direct sur le service graphite.
Lorsque le mode "SSH" est activé (voir la section Dans la configuration de l'hôte), il essaie de se connecter au service graphite par l'intermédiaire de SSH avec l'utilisateur "shinken" et la clé privée se trouvant dans ~shinken/.ssh/id_rsa.
| Panel |
|---|
Notez que si vous avez déjà effectué cette configuration pour un autre pack, vous pouvez réutiliser la même pour le pack Graphite. |
Dans la configuration de l'hôte
Dans l'onglet "Général", ajoutez le modèle d'hôte du pack Graphite à la liste des modèles hérités.
Dans l'onglet "Données", dans la section consacrée au modèle d'hôte Graphite hérité, renseigner les valeurs pour les champs:
- SSH_KEY
- SSH_KEY_PASSPHRASE
- SSH_PORT
- SSH_USER
Voir la section paramètre du check pour plus d'information sur les champs.
Côté client (serveur supervisé)
Créez un utilisateur local "shinken" avec un dossier "home" et un mot de passe
Code Block adduser -m -r shinken passwd shinken
Côté Shinken (serveur Poller)
Connectez-vous sur le serveur en tant qu'utilisateur "shinken" et copiez la clé SSH publique vers le serveur à superviser :
| Code Block |
|---|
[root@shinken-poller ~]# su - shinken [shinken@shinken-poller ~]# ssh-copy-id shinken@remote_host The authenticity of host '192.168.1.19 (192.168.1.19)' can't be established. RSA key fingerprint is 00:ff:ee:dd:cc:bb:aa:d6:d3:79:1d:f6:93:47:80:27. Are you sure you want to continue connecting (yes/no)? yes shinken@remote_host's password: XXXXXXXXXXX Now try logging into the machine, with "ssh '192.168.1.19'", and check in: .ssh/authorized_keys to make sure we haven't added extra keys that you weren't expecting. [root@shinken-poller ~]# ssh shinken@remote_host -i ~shinken/.ssh/id_rsa |
Cette copie de clé permet d'autoriser le Poller à se connecter sur la machine à superviser. Sur une architecture Shinken contenant plusieurs Pollers, il faudra effectuer cette opération sur chaque Poller pour lui permettre de se connecter en SSH sur le serveur à superviser.
Comment utiliser le pack Graphite
La pack Graphite peut être utilisé en appliquant le modèle d'hôte "graphite" sur un hôte. Cette opération peut être effectuée de 2 manières différentes:
Via l'interface de configuration
Dans l'interface de configuration, créer et éditer un Hôte puis ajouter le modèle d'hôte "graphite" dans la liste des modèles d'hôtes utilisés.
Via un fichier de configuration
Dans un fichier de configuration .cfg de votre choix, créer un hôte et définir la propriété "use" à "graphite".
Ce fichier cfg doit ensuite être importé dans Shinken Entreprise via une source (plus d'informations sont disponibles dans la page de documentation: Importer ses propres fichiers CFG).
Paramètre du check
Le check du module Graphite peut être configuré via des données fournies par le modèle.
Les données suivantes sont disponibles :
| Nom | description | Valeur par défaut |
|---|---|---|
| GRAPHITE_DATA_LOCATION | Emplacement des données sur les serveurs graphite | /opt/graphite/storage/whisper |
| GRAPHITE_PORT | Port réseau utilisé par graphite | 2003 |
| GRAPHITE_STORAGE_CRITICAL | Limite en % pour passer le statut du check en critique lorsque l'espace de stockage atteint cette limite | 95 |
| GRAPHITE_STORAGE_WARNING | Limite en % pour passer le statut du check en warning lorsque l'espace de stockage atteint cette limite | 85 |
| SSH_KEY | Clé SSH utilisée pour se connecter au serveurs graphite | $SSH_KEY$ |
| SSH_KEY_PASSPHRASE | Passphrase de la clé SSH | $SSH_KEY_PASSPHRASE$ |
| SSH_PORT | Port SSH des serveurs graphite | $SSH_PORT$ |
| SSH_USER | Utilisateur ssh des serveurs graphite | $SSH_USER$ |
| Info |
|---|
Le ssh est utilisé pour se connecter au serveurs graphite afin de vérifier que le processus indiqué est bien en cours d'exécution et que le serveur dispose d'assez d'espace de stockage |
Personnaliser les seuils de Critique et Avertissement
Le pack Graphite définit des seuils par défaut sur le check qu'il utilise que vous pouvez modifier.
Changer les seuils pour un seul hôte
Les modèles d'hôte livrés dans Shinken contiennent souvent des variables permettant de changer les seuils et options des checks.
Pour changer ces seuils sur un seul hôte en particulier, la manière la plus simple est de changer des variables via les données présentes sur l'hôte directement:
- Dans l'interface de Configuration, éditer l'hôte et aller dans l'onglet Données
Par exemple, changer la donnée GRAPHITE_STORAGE_CRITICAL à 90 aura pour effet de changer le seuil Critique - Via un fichier de configuration
Pour changer le port du service graphite, éditer l'hôte et changer la donnée GRAPHITE_PORT
Changer les seuils pour tout les hôtes qui utilisent le modèle d'hôte "Graphite"
Pour changer les seuils sur tous les hôtes qui utilisent le modèle d'hôte "graphite", on pourrait être tenté de modifier directement le modèle d'hôte "graphite" et changer les données personnalisées de cet hôte.
Mais, dans la prochaine mise à jour de Shinken Entreprise, ces modèles d'hôtes/checks peuvent être modifiés, ce qui occasionne un changement de comportement et probablement causer des problèmes dans votre configuration Shinken.
L'alternative conseillée est de cloner les éléments utilisés dans le pack Linux et de les renommer. On peut ensuite modifier sans aucun risque liés aux mises à jour de Shinken Entreprise.
Ce pack graphite cloné peut ensuite être modifié et personnalisé selon les besoins.
Par exemple, le changement des seuils s'effectue de la même manière en changeant les données comme décrit dans la section précédente mais dans le modèle d'hôte graphite au lieu de faire cette modification directement dans les hôtes.
Version des scripts livrés
check_graphite.py : 0.1