Utilisation du script
- /etc/init.d/shinken-gatherer start => vérifie qu'il n'est pas lancé, et le démarre si nécessaire
- /etc/init.d/shinken-gatherer stop => vérifie qu'il est arrêté, et l'éteint si nécessaire
- /etc/init.d/shinken-gatherer status => indique si il est démarré ou éteint
Les différents cas de démarrage du script
Le script se lance automatiquement sur les actions suivantes:
- Quand on lance shinken en entier ou un seul daemon ( /etc/init.d/shinken(*) start )
- Si on lance carbon-cache ( /etc/init.d/carbon-cache start )
- Si on le lance/arrête spécifiquement ( /etc/init.d/shinken-gatherer start/stop/status )
Logs du script
Le log du script est disponible sur /var/log/shinken/gatherergathererd.log. Le niveau de log est INFO.
- la rotation normale ( 6 jours ) des logs est active.
- le script accepte les niveaux de log suivant : DEBUG, INFO, WARNING, CRITICAL.
- le niveau de log se change dans /etc/shinken/deamons/gathererd.iniPour le lancer en DEBUG:
| Code Block | ||
|---|---|---|
| LANG=C LC_LANG=C GATHERER_DEBUG=1 /etc/init.d/shinken-gatherer restart||
# accepted log level values= DEBUG, INFO, WARNING, CRITICAL
log_level=INFO |
Descriptions des variables
| Propriété | Défaut | Description |
|---|---|---|
| use_local_log | 1 | Cette variable est utilisée pour définir le nom du Poller. |
| local_log | %(logdir)s/gathererd.log | Cette directive est utilisée pour définir l'adresse permettant de joindre ce Poller. Par défaut "localhost", changez-le par un nom DNS ou une adresse IP. |
| logdir | /var/log/shinken | Cette directive est utilisée pour définir le port TCP utilisé par ce démon. |
| log_level | INFO | Cette variable est utilisée pour définir si le Poller doit être contacté en HTTPS (*1*) ou HTTP (*0*). La valeur par défaut est *0* (HTTP). |
| vmware_statistics_compute_enable | 1 | Cette variable permet de désactiver la collecte de la charge CPU sur la VM. Peut-être, pratique dans le cas où les vmware-tools de la VM ne sont pas activés ou ne fournissent pas toutes les informations attendues. |
Les données collectées
Récupération du nombre d'hôte et métriques dans Graphite
Le script compte
- le nombre d'hôtes en comptant les répertoires dans /opt/graphite/storage/whisper
- le nombre de métriques en comptant les fichiers .wsp dans /opt/graphite/storage/whispe
et mets le résultat dans /opt/graphite/storage/whisper/.nb_metrics
| Warning | ||
|---|---|---|
| ||
|
Récupération des données d'activité disque
Il écrit le fichier /dev/shm/__check_graphite_iostats.tmp avec les données des disques (issu de /proc/diskstats) pour le %util de chaque disk ( physique, PAS partition )
Si le script ne fonctionne pas:
- Le check de graphite writer sera en UNKNOWN en mettant qu'il n'arrive pas à lire le fichier.
Récupération des données de VMWare
Warning - la variable vmware_statistics_compute_enable dans le fichier /etc/shinken/deamons/gathererd.ini permet de choisir activation de la récupération des données de VMWare.
Code Block vmware_statistics_compute_enable=1Il écrit le fichier /dev/shm/vmware_stats_export.dat si le serveur est une VM VMWare. Il écrit dedans quand il a fait la vérification, si c'est une VM VMWare et la valeur du %ready.
Si le script n'a pas tourné (depuis le redémarrage du serveur):
- Le daemon a qui on fait la demande va retourner que le serveur n'est pas une VMWare.
Si le script a déjà tourné (depuis le redémarrage du serveur), mais ne tourne plus:
- Le daemon va retourner les dernières valeurs mesurées:
- donc pas de soucis si VM/pas VM, ça ne change pas
- mais les mesures CPU seront fausses
- la variable vmware_statistics_compute_enable dans le fichier /etc/shinken/deamons/gathererd.ini permet de choisir activation de la récupération des données de VMWare.